Documentation/devicetree/bindings/display/bridge/ti,sn65dsi86.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/ti,sn65dsi86.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: SN65DSI86 DSI to eDP bridge chip
   8
   9 maintainers:
  10   - Sandeep Panda <spanda@codeaurora.org>
  11
  12 description: |
  13   The Texas Instruments SN65DSI86 bridge takes MIPI DSI in and outputs eDP.
  14   https://www.ti.com/general/docs/lit/getliterature.tsp?genericPartNumber=sn65dsi86&fileType=pdf
  15
  16 properties:
  17   compatible:
  18     const: ti,sn65dsi86
  19
  20   reg:
  21     const: 0x2d
  22
  23   enable-gpios:
  24     maxItems: 1
  25     description: GPIO specifier for bridge_en pin (active high).
  26
  27   suspend-gpios:
  28     maxItems: 1
  29     description: GPIO specifier for GPIO1 pin on bridge (active low).
  30
  31   no-hpd:
  32     type: boolean
  33     description:
  34       Set if the HPD line on the bridge isn't hooked up to anything or is
  35       otherwise unusable.
  36
  37   vccio-supply:
  38     description: A 1.8V supply that powers the digital IOs.
  39
  40   vpll-supply:
  41     description: A 1.8V supply that powers the DisplayPort PLL.
  42
  43   vcca-supply:
  44     description: A 1.2V supply that powers the analog circuits.
  45
  46   vcc-supply:
  47     description: A 1.2V supply that powers the digital core.
  48
  49   interrupts:
  50     maxItems: 1
  51
  52   clocks:
  53     maxItems: 1
  54     description:
  55       Clock specifier for input reference clock. The reference clock rate must
  56       be 12 MHz, 19.2 MHz, 26 MHz, 27 MHz or 38.4 MHz.
  57
  58   clock-names:
  59     const: refclk
  60
  61   gpio-controller: true
  62   '#gpio-cells':
  63     const: 2
  64     description:
  65       First cell is pin number, second cell is flags.  GPIO pin numbers are
  66       1-based to match the datasheet.  See ../../gpio/gpio.txt for more
  67       information.
  68
  69   '#pwm-cells':
  70     const: 1
  71     description: See ../../pwm/pwm.yaml for description of the cell formats.
  72
  73   aux-bus:
  74     $ref: /schemas/display/dp-aux-bus.yaml#
  75
  76   ports:
  77     $ref: /schemas/graph.yaml#/properties/ports
  78
  79     properties:
  80       port@0:
  81         $ref: /schemas/graph.yaml#/properties/port
  82         description:
  83           Video port for MIPI DSI input
  84
  85       port@1:
  86         $ref: /schemas/graph.yaml#/$defs/port-base
  87         unevaluatedProperties: false
  88         description:
  89           Video port for eDP output (panel or connector).
  90
  91         properties:
  92           endpoint:
  93             $ref: /schemas/graph.yaml#/$defs/endpoint-base
  94             unevaluatedProperties: false
  95
  96             properties:
  97               data-lanes:
  98                 oneOf:
  99                   - minItems: 1
 100                     maxItems: 1
 101                     uniqueItems: true
 102                     items:
 103                       enum:
 104                         - 0
 105                         - 1
 106                     description:
 107                       If you have 1 logical lane the bridge supports routing
 108                       to either port 0 or port 1.  Port 0 is suggested.
 109                       See ../../media/video-interface.txt for details.
 110
 111                   - minItems: 2
 112                     maxItems: 2
 113                     uniqueItems: true
 114                     items:
 115                       enum:
 116                         - 0
 117                         - 1
 118                     description:
 119                       If you have 2 logical lanes the bridge supports
 120                       reordering but only on physical ports 0 and 1.
 121                       See ../../media/video-interface.txt for details.
 122
 123                   - minItems: 4
 124                     maxItems: 4
 125                     uniqueItems: true
 126                     items:
 127                       enum:
 128                         - 0
 129                         - 1
 130                         - 2
 131                         - 3
 132                     description:
 133                       If you have 4 logical lanes the bridge supports
 134                       reordering in any way.
 135                       See ../../media/video-interface.txt for details.
 136
 137               lane-polarities:
 138                 minItems: 1
 139                 maxItems: 4
 140                 items:
 141                   enum:
 142                     - 0
 143                     - 1
 144                 description: See ../../media/video-interface.txt
 145
 146             dependencies:
 147               lane-polarities: [data-lanes]
 148
 149     required:
 150       - port@0
 151       - port@1
 152
 153 required:
 154   - compatible
 155   - reg
 156   - vccio-supply
 157   - vpll-supply
 158   - vcca-supply
 159   - vcc-supply
 160   - ports
 161
 162 additionalProperties: false
 163
 164 examples:
 165   - |
 166     #include <dt-bindings/clock/qcom,rpmh.h>
 167     #include <dt-bindings/gpio/gpio.h>
 168     #include <dt-bindings/interrupt-controller/irq.h>
 169
 170     i2c {
 171       #address-cells = <1>;
 172       #size-cells = <0>;
 173
 174       bridge@2d {
 175         compatible = "ti,sn65dsi86";
 176         reg = <0x2d>;
 177
 178         interrupt-parent = <&tlmm>;
 179         interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;
 180
 181         enable-gpios = <&tlmm 102 GPIO_ACTIVE_HIGH>;
 182
 183         vpll-supply = <&src_pp1800_s4a>;
 184         vccio-supply = <&src_pp1800_s4a>;
 185         vcca-supply = <&src_pp1200_l2a>;
 186         vcc-supply = <&src_pp1200_l2a>;
 187
 188         clocks = <&rpmhcc RPMH_LN_BB_CLK2>;
 189         clock-names = "refclk";
 190
 191         no-hpd;
 192
 193         ports {
 194           #address-cells = <1>;
 195           #size-cells = <0>;
 196
 197           port@0 {
 198             reg = <0>;
 199             endpoint {
 200               remote-endpoint = <&dsi0_out>;
 201             };
 202           };
 203
 204           port@1 {
 205             reg = <1>;
 206             sn65dsi86_out: endpoint {
 207               remote-endpoint = <&panel_in_edp>;
 208             };
 209           };
 210         };
 211
 212         aux-bus {
 213           panel {
 214             compatible = "boe,nv133fhm-n62";
 215             power-supply = <&pp3300_dx_edp>;
 216             backlight = <&backlight>;
 217             hpd-gpios = <&sn65dsi86_bridge 2 GPIO_ACTIVE_HIGH>;
 218
 219             port {
 220               panel_in_edp: endpoint {
 221                 remote-endpoint = <&sn65dsi86_out>;
 222               };
 223             };
 224           };
 225         };
 226       };
 227     };
 228   - |
 229     #include <dt-bindings/clock/qcom,rpmh.h>
 230     #include <dt-bindings/gpio/gpio.h>
 231     #include <dt-bindings/interrupt-controller/irq.h>
 232
 233     i2c {
 234       #address-cells = <1>;
 235       #size-cells = <0>;
 236
 237       bridge@2d {
 238         compatible = "ti,sn65dsi86";
 239         reg = <0x2d>;
 240
 241         enable-gpios = <&msmgpio 33 GPIO_ACTIVE_HIGH>;
 242         suspend-gpios = <&msmgpio 34 GPIO_ACTIVE_LOW>;
 243
 244         interrupts-extended = <&gpio3 4 IRQ_TYPE_EDGE_FALLING>;
 245
 246         vccio-supply = <&pm8916_l17>;
 247         vcca-supply = <&pm8916_l6>;
 248         vpll-supply = <&pm8916_l17>;
 249         vcc-supply = <&pm8916_l6>;
 250
 251         clock-names = "refclk";
 252         clocks = <&input_refclk>;
 253
 254         ports {
 255           #address-cells = <1>;
 256           #size-cells = <0>;
 257
 258           port@0 {
 259             reg = <0>;
 260
 261             edp_bridge_in: endpoint {
 262               remote-endpoint = <&dsi_out>;
 263             };
 264           };
 265
 266           port@1 {
 267             reg = <1>;
 268
 269             edp_bridge_out: endpoint {
 270               data-lanes = <2 1 3 0>;
 271               lane-polarities = <0 1 0 1>;
 272               remote-endpoint = <&edp_panel_in>;
 273             };
 274           };
 275         };
 276       };
 277     };