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       port@0:
  54         type: object
  55         description: |
  56           Video port for DSI input
  57
  58       port@1:
  59         type: object
  60         description: |
  61           Video port for eDP output (panel or connector).
  62
  63     required:
  64       - port@0
  65
  66 required:
  67   - compatible
  68   - reg
  69   - powerdown-gpios
  70   - reset-gpios
  71   - vdd12-supply
  72   - vdd33-supply
  73   - ports
  74
  75 additionalProperties: false
  76
  77 examples:
  78   - |
  79     #include <dt-bindings/gpio/gpio.h>
  80     i2c0 {
  81         #address-cells = <1>;
  82         #size-cells = <0>;
  83
  84         ps8640: edp-bridge@18 {
  85             compatible = "parade,ps8640";
  86             reg = <0x18>;
  87             powerdown-gpios = <&pio 116 GPIO_ACTIVE_LOW>;
  88             reset-gpios = <&pio 115 GPIO_ACTIVE_LOW>;
  89             vdd12-supply = <&ps8640_fixed_1v2>;
  90             vdd33-supply = <&mt6397_vgp2_reg>;
  91
  92             ports {
  93                 #address-cells = <1>;
  94                 #size-cells = <0>;
  95
  96                 port@0 {
  97                     reg = <0>;
  98                     ps8640_in: endpoint {
  99                         remote-endpoint = <&dsi0_out>;
 100                     };
 101                 };
 102
 103                 port@1 {
 104                     reg = <1>;
 105                     ps8640_out: endpoint {
 106                         remote-endpoint = <&panel_in>;
 107                    };
 108                 };
 109             };
 110         };
 111     };
 112