Merge tag 'ext4_for_linus_stable' of git://git.kernel.org/pub/scm/linux/kernel/git...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / media / i2c / adv748x.txt
1 * Analog Devices ADV748X video decoder with HDMI receiver
2
3 The ADV7481 and ADV7482 are multi format video decoders with an integrated
4 HDMI receiver. They can output CSI-2 on two independent outputs TXA and TXB
5 from three input sources HDMI, analog and TTL.
6
7 Required Properties:
8
9   - compatible: Must contain one of the following
10     - "adi,adv7481" for the ADV7481
11     - "adi,adv7482" for the ADV7482
12
13   - reg: I2C slave addresses
14     The ADV748x has up to twelve 256-byte maps that can be accessed via the
15     main I2C ports. Each map has it own I2C address and acts as a standard
16     slave device on the I2C bus. The main address is mandatory, others are
17     optional and remain at default values if not specified.
18
19 Optional Properties:
20
21   - interrupt-names: Should specify the interrupts as "intrq1", "intrq2" and/or
22                      "intrq3". All interrupts are optional. The "intrq3" interrupt
23                      is only available on the adv7481
24   - interrupts: Specify the interrupt lines for the ADV748x
25   - reg-names : Names of maps with programmable addresses.
26                 It shall contain all maps needing a non-default address.
27                 Possible map names are:
28                   "main", "dpll", "cp", "hdmi", "edid", "repeater",
29                   "infoframe", "cbus", "cec", "sdp", "txa", "txb"
30
31 The device node must contain one 'port' child node per device input and output
32 port, in accordance with the video interface bindings defined in
33 Documentation/devicetree/bindings/media/video-interfaces.txt. The port nodes
34 are numbered as follows.
35
36           Name          Type            Port
37         ---------------------------------------
38           AIN0          sink            0
39           AIN1          sink            1
40           AIN2          sink            2
41           AIN3          sink            3
42           AIN4          sink            4
43           AIN5          sink            5
44           AIN6          sink            6
45           AIN7          sink            7
46           HDMI          sink            8
47           TTL           sink            9
48           TXA           source          10
49           TXB           source          11
50
51 The digital output port nodes must contain at least one endpoint.
52
53 Ports are optional if they are not connected to anything at the hardware level.
54
55 Example:
56
57         video-receiver@70 {
58                 compatible = "adi,adv7482";
59                 reg = <0x70 0x71 0x72 0x73 0x74 0x75
60                        0x60 0x61 0x62 0x63 0x64 0x65>;
61                 reg-names = "main", "dpll", "cp", "hdmi", "edid", "repeater",
62                             "infoframe", "cbus", "cec", "sdp", "txa", "txb";
63
64                 #address-cells = <1>;
65                 #size-cells = <0>;
66
67                 interrupt-parent = <&gpio6>;
68                 interrupt-names = "intrq1", "intrq2";
69                 interrupts = <30 IRQ_TYPE_LEVEL_LOW>,
70                              <31 IRQ_TYPE_LEVEL_LOW>;
71
72                 port@7 {
73                         reg = <7>;
74
75                         adv7482_ain7: endpoint {
76                                 remote-endpoint = <&cvbs_in>;
77                         };
78                 };
79
80                 port@8 {
81                         reg = <8>;
82
83                         adv7482_hdmi: endpoint {
84                                 remote-endpoint = <&hdmi_in>;
85                         };
86                 };
87
88                 port@a {
89                         reg = <10>;
90
91                         adv7482_txa: endpoint {
92                                 clock-lanes = <0>;
93                                 data-lanes = <1 2 3 4>;
94                                 remote-endpoint = <&csi40_in>;
95                         };
96                 };
97
98                 port@b {
99                         reg = <11>;
100
101                         adv7482_txb: endpoint {
102                                 clock-lanes = <0>;
103                                 data-lanes = <1>;
104                                 remote-endpoint = <&csi20_in>;
105                         };
106                 };
107         };