dt-bindings: Add USB typeC and DP redriver bindings

Add ON Semiconductor USB Type-C and display port 10Gbps Linear Re-Driver bindings used on MSM platforms. Change-Id: Ia333a63a958a5a890f2743a3ec6dc51d7053b720 Signed-off-by: Ronak Vijay Raheja <quic_rraheja@quicinc.com>
2023-10-12 14:43:06 -07:00
parent 234066ce47
commit b6bedcf437
1 changed files with 116 additions and 0 deletions
--- a/bindings/usb/onsemi-redriver.yaml
+++ b/bindings/usb/onsemi-redriver.yaml
@@ -0,0 +1,116 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/usb/onsemi-redriver.yaml##
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: ON Semiconductor USB Type-C and display port 10Gbps Linear Re-Driver
+
+maintainers:
+  - Ronak Vijay Raheja <quic_rraheja@quicinc.com>
+
+properties:
+  compatible:
+    const: onnn,redriver
+
+  reg:
+    description: I2C address on the selected bus
+    minItems: 1
+
+  extcon:
+    description: |
+      phandles to external connector devices. The first phandle should point to
+      the external connector which provides both "USB" cable events and
+      "USB-HOST" cable events. An optional second phandle may be specified for
+      DP lane events.
+    minItems: 2
+
+  vdd-supply:
+    description: phandle to the Vdd supply for Linear Re-Driver
+
+  eq:
+    description: |
+      Equalization value of re-driver channel A/B/C/D, 8 bit::
+       - eq[0] to eq[3]:: Channel A-D parameter for USB.
+       - eq[4] to eq[7]:: Channel A-D parameter for DP.
+    $ref: /schemas/types.yaml#/definitions/uint32-array
+
+  flat-gain:
+    description: |
+      Flat gain control value of re-driver channel A/B/C/D, 8 bit::
+       - flat_gain[0] to flat_gain[3]:: Channel A-D parameter for USB.
+       - flat_gain[4] to flat_gain[7]:: Channel A-D parameter for DP.
+    $ref: /schemas/types.yaml#/definitions/uint32-array
+
+  output-comp:
+    description: |
+      Output compression value of re-driver channel A/B/C/D, 8 bit::
+       - output_comp[0] to output_comp[3]:: Channel A-D parameter for USB.
+       - output_comp[4] to output_comp[7]:: Channel A-D parameter for DP.
+    $ref: /schemas/types.yaml#/definitions/uint32-array
+
+  loss-match:
+    description: |
+      Loss profile matching control value of re-driver channel A/B/C/D, 8 bit::
+       - loss_match[0] to loss_match[3]:: Channel A-D parameter for USB.
+       - loss_match[4] to loss_match[7]:: Channel A-D parameter for DP.
+    $ref: /schemas/types.yaml#/definitions/uint32-array
+
+  lane-channel-swap:
+    description: |
+      Most of the designs use this configuration::
+       - channel A:: RX1
+       - channel B:: TX1
+       - channel C:: TX0
+       - channel D:: RX0
+      Enable this property if the design uses this configuration::
+       - channel A:: RX0
+       - channel B:: TX0
+       - channel C:: TX1
+       - channel D:: RX1
+    type: boolean
+
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c@988000 {
+      #address-cells = <1>;
+      #size-cells = <0>;
+      reg=<0x10 0>;
+
+      redriver@19 {
+        compatible = "onnn,redriver";
+        reg = <0x19>;
+
+        vdd-supply = <&L15B>;
+        lane-channel-swap;
+
+        eq = /bits/ 8 <
+              /* Parameters for USB */
+              0x4 0x4 0x4 0x4
+              /* Parameters for DP */
+              0x6 0x4 0x4 0x6>;
+        flat-gain = /bits/ 8 <
+              /* Parameters for USB */
+              0x3 0x1 0x1 0x3
+              /* Parameters for DP */
+              0x2 0x1 0x1 0x2>;
+        output-comp = /bits/ 8 <
+              /* Parameters for USB */
+              0x3 0x3 0x3 0x3
+              /* Parameters for DP */
+              0x3 0x3 0x3 0x3>;
+        loss-match = /bits/ 8 <
+              /* Parameters for USB */
+              0x1 0x3 0x3 0x1
+              /* Parameters for DP */
+              0x3 0x3 0x3 0x3>;
+      };
+    };
+...