Merge branch 'vmwgfx-fixes-5.1' of git://people.freedesktop.org/~thomash/linux into...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / media / sun6i-csi.txt
1 Allwinner V3s Camera Sensor Interface
2 -------------------------------------
3
4 Allwinner V3s SoC features a CSI module(CSI1) with parallel interface.
5
6 Required properties:
7   - compatible: value must be one of:
8     * "allwinner,sun6i-a31-csi"
9     * "allwinner,sun8i-h3-csi"
10     * "allwinner,sun8i-v3s-csi"
11     * "allwinner,sun50i-a64-csi"
12   - reg: base address and size of the memory-mapped region.
13   - interrupts: interrupt associated to this IP
14   - clocks: phandles to the clocks feeding the CSI
15     * bus: the CSI interface clock
16     * mod: the CSI module clock
17     * ram: the CSI DRAM clock
18   - clock-names: the clock names mentioned above
19   - resets: phandles to the reset line driving the CSI
20
21 The CSI node should contain one 'port' child node with one child 'endpoint'
22 node, according to the bindings defined in
23 Documentation/devicetree/bindings/media/video-interfaces.txt.
24
25 Endpoint node properties for CSI
26 ---------------------------------
27 See the video-interfaces.txt for a detailed description of these properties.
28 - remote-endpoint       : (required) a phandle to the bus receiver's endpoint
29                            node
30 - bus-width:            : (required) must be 8, 10, 12 or 16
31 - pclk-sample           : (optional) (default: sample on falling edge)
32 - hsync-active          : (required; parallel-only)
33 - vsync-active          : (required; parallel-only)
34
35 Example:
36
37 csi1: csi@1cb4000 {
38         compatible = "allwinner,sun8i-v3s-csi";
39         reg = <0x01cb4000 0x1000>;
40         interrupts = <GIC_SPI 84 IRQ_TYPE_LEVEL_HIGH>;
41         clocks = <&ccu CLK_BUS_CSI>,
42                  <&ccu CLK_CSI1_SCLK>,
43                  <&ccu CLK_DRAM_CSI>;
44         clock-names = "bus", "mod", "ram";
45         resets = <&ccu RST_BUS_CSI>;
46
47         port {
48                 /* Parallel bus endpoint */
49                 csi1_ep: endpoint {
50                         remote-endpoint = <&adv7611_ep>;
51                         bus-width = <16>;
52
53                         /* If hsync-active/vsync-active are missing,
54                            embedded BT.656 sync is used */
55                         hsync-active = <0>; /* Active low */
56                         vsync-active = <0>; /* Active low */
57                         pclk-sample = <1>;  /* Rising */
58                 };
59         };
60 };