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     description: Regulator for 1.2V digital core power.
  39
  40   vdd33-supply:
  41     description: Regulator for 3.3V digital core power.
  42
  43   ports:
  44     type: object
  45     description:
  46       A node containing DSI input & output port nodes with endpoint
  47       definitions as documented in
  48       Documentation/devicetree/bindings/media/video-interfaces.txt
  49       Documentation/devicetree/bindings/graph.txt
  50     properties:
  51       '#address-cells':
  52         const: 1
  53
  54       '#size-cells':
  55         const: 0
  56
  57       port@0:
  58         type: object
  59         description: |
  60           Video port for DSI input
  61
  62       port@1:
  63         type: object
  64         description: |
  65           Video port for eDP output (panel or connector).
  66
  67     required:
  68       - port@0
  69
  70     additionalProperties: false
  71
  72 required:
  73   - compatible
  74   - reg
  75   - powerdown-gpios
  76   - reset-gpios
  77   - vdd12-supply
  78   - vdd33-supply
  79   - ports
  80
  81 additionalProperties: false
  82
  83 examples:
  84   - |
  85     #include <dt-bindings/gpio/gpio.h>
  86     i2c0 {
  87         #address-cells = <1>;
  88         #size-cells = <0>;
  89
  90         ps8640: edp-bridge@18 {
  91             compatible = "parade,ps8640";
  92             reg = <0x18>;
  93             powerdown-gpios = <&pio 116 GPIO_ACTIVE_LOW>;
  94             reset-gpios = <&pio 115 GPIO_ACTIVE_LOW>;
  95             vdd12-supply = <&ps8640_fixed_1v2>;
  96             vdd33-supply = <&mt6397_vgp2_reg>;
  97
  98             ports {
  99                 #address-cells = <1>;
 100                 #size-cells = <0>;
 101
 102                 port@0 {
 103                     reg = <0>;
 104                     ps8640_in: endpoint {
 105                         remote-endpoint = <&dsi0_out>;
 106                     };
 107                 };
 108
 109                 port@1 {
 110                     reg = <1>;
 111                     ps8640_out: endpoint {
 112                         remote-endpoint = <&panel_in>;
 113                    };
 114                 };
 115             };
 116         };
 117     };
 118