xref: /linux/Documentation/devicetree/bindings/media/allwinner,sun4i-a10-csi.yaml (revision 1de243b0766679e75f558943250614ccd3f60121) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/media/allwinner,sun4i-a10-csi.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Allwinner A10 CMOS Sensor Interface (CSI) Device Tree Bindings
8
9maintainers:
10  - Chen-Yu Tsai <wens@csie.org>
11  - Maxime Ripard <maxime.ripard@bootlin.com>
12
13description: |-
14  The Allwinner A10 and later has a CMOS Sensor Interface to retrieve
15  frames from a parallel or BT656 sensor.
16
17properties:
18  compatible:
19    oneOf:
20      - const: allwinner,sun4i-a10-csi1
21      - const: allwinner,sun7i-a20-csi0
22      - items:
23        - const: allwinner,sun7i-a20-csi1
24        - const: allwinner,sun4i-a10-csi1
25
26  reg:
27    maxItems: 1
28
29  interrupts:
30    maxItems: 1
31
32  clocks:
33    minItems: 2
34    maxItems: 3
35    items:
36      - description: The CSI interface clock
37      - description: The CSI ISP clock
38      - description: The CSI DRAM clock
39
40  clock-names:
41    minItems: 2
42    maxItems: 3
43    items:
44      - const: bus
45      - const: isp
46      - const: ram
47
48  resets:
49    maxItems: 1
50
51  # See ./video-interfaces.txt for details
52  port:
53    type: object
54    additionalProperties: false
55
56    properties:
57      endpoint:
58        type: object
59
60        properties:
61          bus-width:
62            enum: [8, 16]
63
64          data-active: true
65          hsync-active: true
66          pclk-sample: true
67          remote-endpoint: true
68          vsync-active: true
69
70        required:
71          - bus-width
72          - data-active
73          - hsync-active
74          - pclk-sample
75          - remote-endpoint
76          - vsync-active
77
78    required:
79      - endpoint
80
81required:
82  - compatible
83  - reg
84  - interrupts
85  - clocks
86
87additionalProperties: false
88
89examples:
90  - |
91    #include <dt-bindings/interrupt-controller/arm-gic.h>
92    #include <dt-bindings/clock/sun7i-a20-ccu.h>
93    #include <dt-bindings/reset/sun4i-a10-ccu.h>
94
95    csi0: csi@1c09000 {
96        compatible = "allwinner,sun7i-a20-csi0";
97        reg = <0x01c09000 0x1000>;
98        interrupts = <GIC_SPI 42 IRQ_TYPE_LEVEL_HIGH>;
99        clocks = <&ccu CLK_AHB_CSI0>, <&ccu CLK_CSI_SCLK>, <&ccu CLK_DRAM_CSI0>;
100        clock-names = "bus", "isp", "ram";
101        resets = <&ccu RST_CSI0>;
102
103        port {
104            csi_from_ov5640: endpoint {
105                remote-endpoint = <&ov5640_to_csi>;
106                bus-width = <8>;
107                hsync-active = <1>; /* Active high */
108                vsync-active = <0>; /* Active low */
109                data-active = <1>;  /* Active high */
110                pclk-sample = <1>;  /* Rising */
111            };
112        };
113    };
114
115...
116