xref: /freebsd/sys/contrib/device-tree/Bindings/display/bridge/sil,sii9022.yaml (revision 19fae0f66023a97a9b464b3beeeabb2081f575b3)
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/sil,sii9022.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Silicon Image sii902x HDMI bridge
8
9maintainers:
10  - Boris Brezillon <bbrezillon@kernel.org>
11
12properties:
13  compatible:
14    oneOf:
15      - items:
16          - enum:
17              - sil,sii9022-cpi # CEC Programming Interface
18              - sil,sii9022-tpi # Transmitter Programming Interface
19          - const: sil,sii9022
20      - const: sil,sii9022
21
22  reg:
23    maxItems: 1
24
25  interrupts:
26    maxItems: 1
27    description: Interrupt line used to inform the host about hotplug events.
28
29  reset-gpios:
30    maxItems: 1
31
32  iovcc-supply:
33    description: I/O Supply Voltage (1.8V or 3.3V)
34
35  cvcc12-supply:
36    description: Digital Core Supply Voltage (1.2V)
37
38  '#sound-dai-cells':
39    enum: [ 0, 1 ]
40    description: |
41      <0> if only I2S or S/PDIF pin is wired,
42      <1> if both are wired.
43      HDMI audio is configured only if this property is found.
44      If HDMI audio is configured, the sii902x device becomes an I2S and/or
45      S/PDIF audio codec component (e.g. a digital audio sink), that can be
46      used in configuring full audio devices with simple-card or
47      audio-graph-card bindings. See their binding documents on how to describe
48      the way the
49      sii902x device is connected to the rest of the audio system:
50      Documentation/devicetree/bindings/sound/simple-card.yaml
51      Documentation/devicetree/bindings/sound/audio-graph-card.yaml
52      Note: In case of the audio-graph-card binding the used port index should
53      be 3.
54
55  sil,i2s-data-lanes:
56    $ref: /schemas/types.yaml#/definitions/uint32-array
57    minItems: 1
58    maxItems: 4
59    uniqueItems: true
60    items:
61      enum: [ 0, 1, 2, 3 ]
62    description:
63      Each integer indicates which I2S pin is connected to which audio FIFO.
64      The first integer selects the I2S audio pin for the first audio FIFO#0
65      (HDMI channels 1&2), the second for FIFO#1 (HDMI channels 3&4), and so
66      on. There are 4 FIFOs and 4 I2S pins (SD0 - SD3). Any I2S pin can be
67      connected to any FIFO, but there can be no gaps. E.g. an I2S pin must be
68      mapped to FIFO#0 and FIFO#1 before mapping a channel to FIFO#2. The
69      default value is <0>, describing SD0 pin being routed to HDMI audio
70      FIFO#0.
71
72  clocks:
73    maxItems: 1
74    description: MCLK input. MCLK can be used to produce HDMI audio CTS values.
75
76  clock-names:
77    const: mclk
78
79  ports:
80    $ref: /schemas/graph.yaml#/properties/ports
81
82    properties:
83      port@0:
84        $ref: /schemas/graph.yaml#/properties/port
85        description: Parallel RGB input port
86
87      port@1:
88        $ref: /schemas/graph.yaml#/properties/port
89        description: HDMI output port
90
91      port@3:
92        $ref: /schemas/graph.yaml#/properties/port
93        description: Sound input port
94
95required:
96  - compatible
97  - reg
98
99additionalProperties: false
100
101examples:
102  - |
103    i2c {
104        #address-cells = <1>;
105        #size-cells = <0>;
106
107        hdmi-bridge@39 {
108            compatible = "sil,sii9022";
109            reg = <0x39>;
110            reset-gpios = <&pioA 1 0>;
111            iovcc-supply = <&v3v3_hdmi>;
112            cvcc12-supply = <&v1v2_hdmi>;
113
114            #sound-dai-cells = <0>;
115            sil,i2s-data-lanes = < 0 1 2 >;
116            clocks = <&mclk>;
117            clock-names = "mclk";
118
119            ports {
120                #address-cells = <1>;
121                #size-cells = <0>;
122
123                port@0 {
124                    reg = <0>;
125                    bridge_in: endpoint {
126                        remote-endpoint = <&dc_out>;
127                    };
128                };
129            };
130        };
131    };
132