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