toshiba,tc358767.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/display/bridge/toshiba,tc358767.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Toshiba TC358767/TC358867/TC9595 DSI/DPI/eDP bridge
  8
  9maintainers:
 10  - Andrey Gusakov <andrey.gusakov@cogentembedded.com>
 11
 12description: |
 13  The TC358767/TC358867/TC9595 is bridge device which
 14  converts DSI/DPI to eDP/DP .
 15
 16properties:
 17  compatible:
 18    oneOf:
 19      - items:
 20          - enum:
 21              - toshiba,tc358867
 22              - toshiba,tc9595
 23          - const: toshiba,tc358767
 24      - const: toshiba,tc358767
 25
 26  reg:
 27    enum:
 28      - 0x0f
 29      - 0x68
 30    description: |
 31        i2c address of the bridge, 0x68 or 0x0f, depending on bootstrap pins
 32
 33  clock-names:
 34    const: ref
 35
 36  clocks:
 37    maxItems: 1
 38    description: |
 39        OF device-tree clock specification for refclk input. The reference.
 40        clock rate must be 13 MHz, 19.2 MHz, 26 MHz, or 38.4 MHz.
 41
 42  shutdown-gpios:
 43    maxItems: 1
 44    description: |
 45        OF device-tree gpio specification for SD pin(active high shutdown input)
 46
 47  reset-gpios:
 48    maxItems: 1
 49    description: |
 50        OF device-tree gpio specification for RSTX pin(active low system reset)
 51
 52  interrupts:
 53    maxItems: 1
 54
 55  toshiba,hpd-pin:
 56    $ref: /schemas/types.yaml#/definitions/uint32
 57    enum:
 58      - 0
 59      - 1
 60    description: TC358767 GPIO pin number to which HPD is connected to (0 or 1)
 61
 62  ports:
 63    $ref: /schemas/graph.yaml#/properties/ports
 64
 65    properties:
 66      port@0:
 67        $ref: /schemas/graph.yaml#/$defs/port-base
 68        unevaluatedProperties: false
 69        description: |
 70            DSI input port. The remote endpoint phandle should be a
 71            reference to a valid DSI output endpoint node
 72
 73        properties:
 74          endpoint:
 75            $ref: /schemas/media/video-interfaces.yaml#
 76            unevaluatedProperties: false
 77
 78            properties:
 79              data-lanes:
 80                description: array of physical DSI data lane indexes.
 81                minItems: 1
 82                items:
 83                  - const: 1
 84                  - const: 2
 85                  - const: 3
 86                  - const: 4
 87
 88      port@1:
 89        $ref: /schemas/graph.yaml#/properties/port
 90        description: |
 91            DPI input/output port. The remote endpoint phandle should be a
 92            reference to a valid DPI output or input endpoint node.
 93
 94      port@2:
 95        $ref: /schemas/graph.yaml#/$defs/port-base
 96        unevaluatedProperties: false
 97        description: |
 98            eDP/DP output port. The remote endpoint phandle should be a
 99            reference to a valid eDP panel input endpoint node. This port is
100            optional, treated as DP panel if not defined
101
102        properties:
103          endpoint:
104            $ref: /schemas/media/video-interfaces.yaml#
105            unevaluatedProperties: false
106
107            properties:
108              toshiba,pre-emphasis:
109                description:
110                  Display port output Pre-Emphasis settings for both DP lanes.
111                $ref: /schemas/types.yaml#/definitions/uint8-array
112                minItems: 2
113                maxItems: 2
114                items:
115                  enum:
116                    - 0 # No pre-emphasis
117                    - 1 # 3.5dB pre-emphasis
118                    - 2 # 6dB pre-emphasis
119
120    oneOf:
121      - required:
122          - port@0
123      - required:
124          - port@1
125
126required:
127  - compatible
128  - reg
129  - clock-names
130  - clocks
131  - ports
132
133additionalProperties: false
134
135examples:
136  - |
137    #include <dt-bindings/gpio/gpio.h>
138
139    /* DPI input and eDP output */
140
141    i2c {
142        #address-cells = <1>;
143        #size-cells = <0>;
144
145        edp-bridge@68 {
146            compatible = "toshiba,tc358767";
147            reg = <0x68>;
148            shutdown-gpios = <&gpio3 23 GPIO_ACTIVE_HIGH>;
149            reset-gpios = <&gpio3 24 GPIO_ACTIVE_LOW>;
150            clock-names = "ref";
151            clocks = <&edp_refclk>;
152
153            ports {
154                #address-cells = <1>;
155                #size-cells = <0>;
156
157                port@1 {
158                    reg = <1>;
159
160                    bridge_in_0: endpoint {
161                        remote-endpoint = <&dpi_out>;
162                    };
163                };
164
165                port@2 {
166                    reg = <2>;
167
168                    bridge_out: endpoint {
169                        remote-endpoint = <&panel_in>;
170                    };
171                };
172            };
173        };
174    };
175  - |
176    /* DPI input and DP output */
177
178    i2c {
179        #address-cells = <1>;
180        #size-cells = <0>;
181
182        edp-bridge@68 {
183            compatible = "toshiba,tc358767";
184            reg = <0x68>;
185            shutdown-gpios = <&gpio3 23 GPIO_ACTIVE_HIGH>;
186            reset-gpios = <&gpio3 24 GPIO_ACTIVE_LOW>;
187            clock-names = "ref";
188            clocks = <&edp_refclk>;
189
190            ports {
191                #address-cells = <1>;
192                #size-cells = <0>;
193
194                port@1 {
195                    reg = <1>;
196
197                    bridge_in_1: endpoint {
198                        remote-endpoint = <&dpi_out>;
199                    };
200                };
201            };
202        };
203    };