xref: /freebsd/sys/contrib/device-tree/Bindings/media/ti,da850-vpif.txt (revision 0fca6ea1d4eea4c934cfff25ac9ee8ad6fe95583)
1Texas Instruments VPIF
2----------------------
3
4The TI Video Port InterFace (VPIF) is the primary component for video
5capture and display on the DA850/AM18x family of TI DaVinci/Sitara
6SoCs.
7
8TI Document reference: SPRUH82C, Chapter 35
9http://www.ti.com/lit/pdf/spruh82
10
11Required properties:
12- compatible: must be "ti,da850-vpif"
13- reg: physical base address and length of the registers set for the device;
14- interrupts: should contain IRQ line for the VPIF
15
16Video Capture:
17
18VPIF has a 16-bit parallel bus input, supporting 2 8-bit channels or a
19single 16-bit channel. It should contain one or two port child nodes
20with child 'endpoint' node. If there are two ports then port@0 must
21describe the input and port@1 output channels. Please refer to the
22bindings defined in
23Documentation/devicetree/bindings/media/video-interfaces.txt.
24
25Example using 2 8-bit input channels, one of which is connected to an
26I2C-connected TVP5147 decoder:
27
28	vpif: vpif@217000 {
29		compatible = "ti,da850-vpif";
30		reg = <0x217000 0x1000>;
31		interrupts = <92>;
32
33		port@0 {
34			vpif_input_ch0: endpoint@0 {
35				reg = <0>;
36				bus-width = <8>;
37				remote-endpoint = <&composite_in>;
38			};
39
40			vpif_input_ch1: endpoint@1 {
41				reg = <1>;
42				bus-width = <8>;
43				data-shift = <8>;
44			};
45		};
46
47		port@1 {
48			vpif_output_ch0: endpoint {
49				bus-width = <8>;
50				remote-endpoint = <&composite_out>;
51			};
52		};
53	};
54
55[ ... ]
56
57&i2c0 {
58
59	tvp5147@5d {
60		compatible = "ti,tvp5147";
61		reg = <0x5d>;
62
63		port {
64			composite_in: endpoint {
65				hsync-active = <1>;
66				vsync-active = <1>;
67				pclk-sample = <0>;
68
69				/* VPIF channel 0 (lower 8-bits) */
70				remote-endpoint = <&vpif_input_ch0>;
71				bus-width = <8>;
72			};
73		};
74	};
75
76	adv7343@2a {
77		compatible = "adi,adv7343";
78		reg = <0x2a>;
79
80		port {
81			composite_out: endpoint {
82				adi,dac-enable = <1 1 1>;
83				adi,sd-dac-enable = <1>;
84
85				remote-endpoint = <&vpif_output_ch0>;
86				bus-width = <8>;
87			};
88		};
89	};
90};
91
92
93Alternatively, an example when the bus is configured as a single
9416-bit input (e.g. for raw-capture mode):
95
96	vpif: vpif@217000 {
97		compatible = "ti,da850-vpif";
98		reg = <0x217000 0x1000>;
99		interrupts = <92>;
100
101		port {
102			vpif_ch0: endpoint {
103				  bus-width = <16>;
104			};
105		};
106	};
107