Documentation/devicetree/bindings/display/bridge/sii902x.txt

   1 sii902x HDMI bridge bindings
   2
   3 Required properties:
   4         - compatible: "sil,sii9022"
   5         - reg: i2c address of the bridge
   6
   7 Optional properties:
   8         - interrupts: describe the interrupt line used to inform the host
   9           about hotplug events.
  10         - reset-gpios: OF device-tree gpio specification for RST_N pin.
  11
  12         HDMI audio properties:
  13         - #sound-dai-cells: <0> or <1>. <0> if only i2s or spdif pin
  14            is wired, <1> if the both are wired. HDMI audio is
  15            configured only if this property is found.
  16         - sil,i2s-data-lanes: Array of up to 4 integers with values of 0-3
  17            Each integer indicates which i2s pin is connected to which
  18            audio fifo. The first integer selects i2s audio pin for the
  19            first audio fifo#0 (HDMI channels 1&2), second for fifo#1
  20            (HDMI channels 3&4), and so on. There is 4 fifos and 4 i2s
  21            pins (SD0 - SD3). Any i2s pin can be connected to any fifo,
  22            but there can be no gaps. E.g. an i2s pin must be mapped to
  23            fifo#0 and fifo#1 before mapping a channel to fifo#2. Default
  24            value is <0>, describing SD0 pin beiging routed to hdmi audio
  25            fifo #0.
  26         - clocks: phandle and clock specifier for each clock listed in
  27            the clock-names property
  28         - clock-names: "mclk"
  29            Describes SII902x MCLK input. MCLK can be used to produce
  30            HDMI audio CTS values. This property follows
  31            Documentation/devicetree/bindings/clock/clock-bindings.txt
  32            consumer binding.
  33
  34         If HDMI audio is configured the sii902x device becomes an I2S
  35         and/or spdif audio codec component (e.g a digital audio sink),
  36         that can be used in configuring a full audio devices with
  37         simple-card or audio-graph-card binding. See their binding
  38         documents on how to describe the way the sii902x device is
  39         connected to the rest of the audio system:
  40         Documentation/devicetree/bindings/sound/simple-card.yaml
  41         Documentation/devicetree/bindings/sound/audio-graph-card.txt
  42         Note: In case of the audio-graph-card binding the used port
  43         index should be 3.
  44
  45 Optional subnodes:
  46         - video input: this subnode can contain a video input port node
  47           to connect the bridge to a display controller output (See this
  48           documentation [1]).
  49
  50 [1]: Documentation/devicetree/bindings/media/video-interfaces.txt
  51
  52 Example:
  53         hdmi-bridge@39 {
  54                 compatible = "sil,sii9022";
  55                 reg = <0x39>;
  56                 reset-gpios = <&pioA 1 0>;
  57
  58                 #sound-dai-cells = <0>;
  59                 sil,i2s-data-lanes = < 0 1 2 >;
  60                 clocks = <&mclk>;
  61                 clock-names = "mclk";
  62
  63                 ports {
  64                         #address-cells = <1>;
  65                         #size-cells = <0>;
  66
  67                         port@0 {
  68                                 reg = <0>;
  69                                 bridge_in: endpoint {
  70                                         remote-endpoint = <&dc_out>;
  71                                 };
  72                         };
  73                 };
  74         };