Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt

   1 Analog Device ADV7511(W)/13/33 HDMI Encoders
   2 -----------------------------------------
   3
   4 The ADV7511, ADV7511W, ADV7513 and ADV7533 are HDMI audio and video transmitters
   5 compatible with HDMI 1.4 and DVI 1.0. They support color space conversion,
   6 S/PDIF, CEC and HDCP. ADV7533 supports the DSI interface for input pixels, while
   7 the others support RGB interface.
   8
   9 Required properties:
  10
  11 - compatible: Should be one of:
  12                 "adi,adv7511"
  13                 "adi,adv7511w"
  14                 "adi,adv7513"
  15                 "adi,adv7533"
  16
  17 - reg: I2C slave address
  18
  19 The ADV7511 supports a large number of input data formats that differ by their
  20 color depth, color format, clock mode, bit justification and random
  21 arrangement of components on the data bus. The combination of the following
  22 properties describe the input and map directly to the video input tables of the
  23 ADV7511 datasheet that document all the supported combinations.
  24
  25 - adi,input-depth: Number of bits per color component at the input (8, 10 or
  26   12).
  27 - adi,input-colorspace: The input color space, one of "rgb", "yuv422" or
  28   "yuv444".
  29 - adi,input-clock: The input clock type, one of "1x" (one clock cycle per
  30   pixel), "2x" (two clock cycles per pixel), "ddr" (one clock cycle per pixel,
  31   data driven on both edges).
  32
  33 The following input format properties are required except in "rgb 1x" and
  34 "yuv444 1x" modes, in which case they must not be specified.
  35
  36 - adi,input-style: The input components arrangement variant (1, 2 or 3), as
  37   listed in the input format tables in the datasheet.
  38 - adi,input-justification: The input bit justification ("left", "evenly",
  39   "right").
  40
  41 - avdd-supply: A 1.8V supply that powers up the AVDD pin on the chip.
  42 - dvdd-supply: A 1.8V supply that powers up the DVDD pin on the chip.
  43 - pvdd-supply: A 1.8V supply that powers up the PVDD pin on the chip.
  44 - dvdd-3v-supply: A 3.3V supply that powers up the pin called DVDD_3V
  45   on the chip.
  46 - bgvdd-supply: A 1.8V supply that powers up the BGVDD pin. This is
  47   needed only for ADV7511.
  48
  49 The following properties are required for ADV7533:
  50
  51 - adi,dsi-lanes: Number of DSI data lanes connected to the DSI host. It should
  52   be one of 1, 2, 3 or 4.
  53 - a2vdd-supply: 1.8V supply that powers up the A2VDD pin on the chip.
  54 - v3p3-supply: A 3.3V supply that powers up the V3P3 pin on the chip.
  55 - v1p2-supply: A supply that powers up the V1P2 pin on the chip. It can be
  56   either 1.2V or 1.8V.
  57
  58 Optional properties:
  59
  60 - interrupts: Specifier for the ADV7511 interrupt
  61 - pd-gpios: Specifier for the GPIO connected to the power down signal
  62
  63 - adi,clock-delay: Video data clock delay relative to the pixel clock, in ps
  64   (-1200 ps .. 1600 ps). Defaults to no delay.
  65 - adi,embedded-sync: The input uses synchronization signals embedded in the
  66   data stream (similar to BT.656). Defaults to separate H/V synchronization
  67   signals.
  68 - adi,disable-timing-generator: Only for ADV7533. Disables the internal timing
  69   generator. The chip will rely on the sync signals in the DSI data lanes,
  70   rather than generate its own timings for HDMI output.
  71 - clocks: from common clock binding: reference to the CEC clock.
  72 - clock-names: from common clock binding: must be "cec".
  73
  74 Required nodes:
  75
  76 The ADV7511 has two video ports. Their connections are modelled using the OF
  77 graph bindings specified in Documentation/devicetree/bindings/graph.txt.
  78
  79 - Video port 0 for the RGB, YUV or DSI input. In the case of ADV7533, the
  80   remote endpoint phandle should be a reference to a valid mipi_dsi_host device
  81   node.
  82 - Video port 1 for the HDMI output
  83 - Audio port 2 for the HDMI audio input
  84
  85
  86 Example
  87 -------
  88
  89         adv7511w: hdmi@39 {
  90                 compatible = "adi,adv7511w";
  91                 reg = <39>;
  92                 interrupt-parent = <&gpio3>;
  93                 interrupts = <29 IRQ_TYPE_EDGE_FALLING>;
  94                 clocks = <&cec_clock>;
  95                 clock-names = "cec";
  96
  97                 adi,input-depth = <8>;
  98                 adi,input-colorspace = "rgb";
  99                 adi,input-clock = "1x";
 100                 adi,input-style = <1>;
 101                 adi,input-justification = "evenly";
 102
 103                 ports {
 104                         #address-cells = <1>;
 105                         #size-cells = <0>;
 106
 107                         port@0 {
 108                                 reg = <0>;
 109                                 adv7511w_in: endpoint {
 110                                         remote-endpoint = <&dpi_out>;
 111                                 };
 112                         };
 113
 114                         port@1 {
 115                                 reg = <1>;
 116                                 adv7511_out: endpoint {
 117                                         remote-endpoint = <&hdmi_connector_in>;
 118                                 };
 119                         };
 120
 121                         port@2 {
 122                                 reg = <2>;
 123                                 codec_endpoint: endpoint {
 124                                         remote-endpoint = <&i2s0_cpu_endpoint>;
 125                                 };
 126                         };
 127                 };
 128         };