Merge tag 'platform-drivers-x86-v4.20-1' of git://git.infradead.org/linux-platform...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / media / renesas,ceu.txt
1 Renesas Capture Engine Unit (CEU)
2 ----------------------------------------------
3
4 The Capture Engine Unit is the image capture interface found in the Renesas
5 SH Mobile, R-Mobile and RZ SoCs.
6
7 The interface supports a single parallel input with data bus width of 8 or 16
8 bits.
9
10 Required properties:
11 - compatible: Shall be one of the following values:
12         "renesas,r7s72100-ceu" for CEU units found in RZ/A1H and RZ/A1M SoCs
13         "renesas,r8a7740-ceu" for CEU units found in R-Mobile A1 R8A7740 SoCs
14 - reg: Registers address base and size.
15 - interrupts: The interrupt specifier.
16
17 The CEU supports a single parallel input and should contain a single 'port'
18 subnode with a single 'endpoint'. Connection to input devices are modeled
19 according to the video interfaces OF bindings specified in:
20 [1] Documentation/devicetree/bindings/media/video-interfaces.txt
21
22 Optional endpoint properties applicable to parallel input bus described in
23 the above mentioned "video-interfaces.txt" file are supported.
24
25 - hsync-active: See [1] for description. If property is not present,
26   default is active high.
27 - vsync-active: See [1] for description. If property is not present,
28   default is active high.
29 - bus-width: See [1] for description. Accepted values are '8' and '16'.
30   If property is not present, default is '8'.
31 - field-even-active: See [1] for description. If property is not present,
32   an even field is identified by a logic 0 (active-low signal).
33
34 Example:
35
36 The example describes the connection between the Capture Engine Unit and an
37 OV7670 image sensor connected to i2c1 interface.
38
39 ceu: ceu@e8210000 {
40         reg = <0xe8210000 0x209c>;
41         compatible = "renesas,r7s72100-ceu";
42         interrupts = <GIC_SPI 332 IRQ_TYPE_LEVEL_HIGH>;
43
44         pinctrl-names = "default";
45         pinctrl-0 = <&vio_pins>;
46
47         status = "okay";
48
49         port {
50                 ceu_in: endpoint {
51                         remote-endpoint = <&ov7670_out>;
52
53                         hsync-active = <1>;
54                         vsync-active = <0>;
55                 };
56         };
57 };
58
59 i2c1: i2c@fcfee400 {
60         pinctrl-names = "default";
61         pinctrl-0 = <&i2c1_pins>;
62
63         status = "okay";
64
65         clock-frequency = <100000>;
66
67         ov7670: camera@21 {
68                 compatible = "ovti,ov7670";
69                 reg = <0x21>;
70
71                 pinctrl-names = "default";
72                 pinctrl-0 = <&vio_pins>;
73
74                 reset-gpios = <&port3 11 GPIO_ACTIVE_LOW>;
75                 powerdown-gpios = <&port3 12 GPIO_ACTIVE_HIGH>;
76
77                 port {
78                         ov7670_out: endpoint {
79                                 remote-endpoint = <&ceu_in>;
80
81                                 hsync-active = <1>;
82                                 vsync-active = <0>;
83                         };
84                 };
85         };
86 };