Merge tag 'amd-drm-fixes-5.11-2020-12-23' of git://people.freedesktop.org/~agd5f...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / media / i2c / adv7604.txt
1 * Analog Devices ADV7604/11/12 video decoder with HDMI receiver
2
3 The ADV7604 and ADV7611/12 are multiformat video decoders with an integrated
4 HDMI receiver. The ADV7604 has four multiplexed HDMI inputs and one analog
5 input, and the ADV7611 has one HDMI input and no analog input. The 7612 is
6 similar to the 7611 but has 2 HDMI inputs.
7
8 These device tree bindings support the ADV7611/12 only at the moment.
9
10 Required Properties:
11
12   - compatible: Must contain one of the following
13     - "adi,adv7611" for the ADV7611
14     - "adi,adv7612" for the ADV7612
15
16   - reg: I2C slave addresses
17     The ADV76xx has up to thirteen 256-byte maps that can be accessed via the
18     main I2C ports. Each map has it own I2C address and acts as a standard
19     slave device on the I2C bus. The main address is mandatory, others are
20     optional and revert to defaults if not specified.
21
22   - hpd-gpios: References to the GPIOs that control the HDMI hot-plug
23     detection pins, one per HDMI input. The active flag indicates the GPIO
24     level that enables hot-plug detection.
25
26 The device node must contain one 'port' child node per device input and output
27 port, in accordance with the video interface bindings defined in
28 Documentation/devicetree/bindings/media/video-interfaces.txt. The port nodes
29 are numbered as follows.
30
31   Port                  ADV7611    ADV7612
32 ------------------------------------------------------------
33   HDMI                  0             0, 1
34   Digital output        1                2
35
36 The digital output port node must contain at least one endpoint.
37
38 Optional Properties:
39
40   - reset-gpios: Reference to the GPIO connected to the device's reset pin.
41   - default-input: Select which input is selected after reset.
42   - reg-names : Names of maps with programmable addresses.
43                 It can contain any map needing a non-default address.
44                 Possible maps names are :
45                   "main", "avlink", "cec", "infoframe", "esdp", "dpp", "afe",
46                   "rep", "edid", "hdmi", "test", "cp", "vdp"
47
48 Optional Endpoint Properties:
49
50   The following three properties are defined in video-interfaces.txt and are
51   valid for source endpoints only.
52
53   - hsync-active: Horizontal synchronization polarity. Defaults to active low.
54   - vsync-active: Vertical synchronization polarity. Defaults to active low.
55   - pclk-sample: Pixel clock polarity. Defaults to output on the falling edge.
56
57   If none of hsync-active, vsync-active and pclk-sample is specified the
58   endpoint will use embedded BT.656 synchronization.
59
60 Example:
61
62         hdmi_receiver@4c {
63                 compatible = "adi,adv7611";
64                 /*
65                  * The edid page will be accessible @ 0x66 on the I2C bus. All
66                  * other maps will retain their default addresses.
67                  */
68                 reg = <0x4c>, <0x66>;
69                 reg-names = "main", "edid";
70
71                 reset-gpios = <&ioexp 0 GPIO_ACTIVE_LOW>;
72                 hpd-gpios = <&ioexp 2 GPIO_ACTIVE_HIGH>;
73
74                 #address-cells = <1>;
75                 #size-cells = <0>;
76
77                 default-input = <0>;
78
79                 port@0 {
80                         reg = <0>;
81                 };
82                 port@1 {
83                         reg = <1>;
84                         hdmi_in: endpoint {
85                                 remote-endpoint = <&ccdc_in>;
86                         };
87                 };
88         };