Re: [PATCH V3 1/4] ufs: dt-bindings: Document gear and rate limit properties

On 8/26/25 8:08 AM, Ram Kumar Dwivedi wrote:

+  limit-hs-gear:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    minimum: 1
+    maximum: 5
+    default: 5
+    description:
+      Restricts the maximum HS gear used in both TX and RX directions,
+      typically for hardware or power constraints in automotive use cases.

The UFSHCI 5.0 spec will add gear 6 soon. So why to restrict the maximum
gear to 5?

+  limit-rate:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    enum: [1, 2]
+    default: 2
+    description:
+      Restricts the UFS controller to Rate A (1) or Rate B (2) for both
+      TX and RX directions, often required in automotive environments due
+      to hardware limitations.

As far as I know no numeric values are associated with these rates in
the UFSHCI 4.1 standard nor in any of the previous versions of this
standard. Does the .yaml syntax support something like "enum: [A, B]"?

Thanks,

Bart.