Documentation/devicetree/bindings/display/bridge/ps8640.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/ps8640.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: MIPI DSI to eDP Video Format Converter Device Tree Bindings
   8
   9 maintainers:
  10   - Nicolas Boichat <drinkcat@chromium.org>
  11   - Enric Balletbo i Serra <enric.balletbo@collabora.com>
  12
  13 description: |
  14   The PS8640 is a low power MIPI-to-eDP video format converter supporting
  15   mobile devices with embedded panel resolutions up to 2048 x 1536. The
  16   device accepts a single channel of MIPI DSI v1.1, with up to four lanes
  17   plus clock, at a transmission rate up to 1.5Gbit/sec per lane. The
  18   device outputs eDP v1.4, one or two lanes, at a link rate of up to
  19   3.24Gbit/sec per lane.
  20
  21 properties:
  22   compatible:
  23     const: parade,ps8640
  24
  25   reg:
  26     maxItems: 1
  27     description: Base I2C address of the device.
  28
  29   powerdown-gpios:
  30     maxItems: 1
  31     description: GPIO connected to active low powerdown.
  32
  33   reset-gpios:
  34     maxItems: 1
  35     description: GPIO connected to active low reset.
  36
  37   vdd12-supply:
  38     maxItems: 1
  39     description: Regulator for 1.2V digital core power.
  40
  41   vdd33-supply:
  42     maxItems: 1
  43     description: Regulator for 3.3V digital core power.
  44
  45   ports:
  46     type: object
  47     description:
  48       A node containing DSI input & output port nodes with endpoint
  49       definitions as documented in
  50       Documentation/devicetree/bindings/media/video-interfaces.txt
  51       Documentation/devicetree/bindings/graph.txt
  52     properties:
  53       '#address-cells':
  54         const: 1
  55
  56       '#size-cells':
  57         const: 0
  58
  59       port@0:
  60         type: object
  61         description: |
  62           Video port for DSI input
  63
  64       port@1:
  65         type: object
  66         description: |
  67           Video port for eDP output (panel or connector).
  68
  69     required:
  70       - port@0
  71
  72     additionalProperties: false
  73
  74 required:
  75   - compatible
  76   - reg
  77   - powerdown-gpios
  78   - reset-gpios
  79   - vdd12-supply
  80   - vdd33-supply
  81   - ports
  82
  83 additionalProperties: false
  84
  85 examples:
  86   - |
  87     #include <dt-bindings/gpio/gpio.h>
  88     i2c0 {
  89         #address-cells = <1>;
  90         #size-cells = <0>;
  91
  92         ps8640: edp-bridge@18 {
  93             compatible = "parade,ps8640";
  94             reg = <0x18>;
  95             powerdown-gpios = <&pio 116 GPIO_ACTIVE_LOW>;
  96             reset-gpios = <&pio 115 GPIO_ACTIVE_LOW>;
  97             vdd12-supply = <&ps8640_fixed_1v2>;
  98             vdd33-supply = <&mt6397_vgp2_reg>;
  99
 100             ports {
 101                 #address-cells = <1>;
 102                 #size-cells = <0>;
 103
 104                 port@0 {
 105                     reg = <0>;
 106                     ps8640_in: endpoint {
 107                         remote-endpoint = <&dsi0_out>;
 108                     };
 109                 };
 110
 111                 port@1 {
 112                     reg = <1>;
 113                     ps8640_out: endpoint {
 114                         remote-endpoint = <&panel_in>;
 115                    };
 116                 };
 117             };
 118         };
 119     };
 120