1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/media/i2c/galaxycore,gc0308.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Galaxycore GC0308 and GC0309 Image Sensors
8
9maintainers:
10  - Sebastian Reichel <sre@kernel.org>
11
12description: |
13  The GalaxyCore GC0308 (1/6.5") and GC0309 (1/9") are 640x480 VGA sensors
14  programmable through an I2C interface and connected via parallel bus.
15  They include an ISP capable of auto exposure and auto white balance.
16
17allOf:
18  - $ref: /schemas/media/video-interface-devices.yaml#
19
20properties:
21  compatible:
22    oneOf:
23      - const: galaxycore,gc0308
24      - items:
25          - const: galaxycore,gc0309
26          - const: galaxycore,gc0308
27
28  reg:
29    const: 0x21
30
31  clocks:
32    description: Reference to the xclk clock.
33    maxItems: 1
34
35  reset-gpios:
36    description: GPIO descriptor for the reset pin.
37    maxItems: 1
38
39  powerdown-gpios:
40    description: GPIO descriptor for the powerdown pin.
41    maxItems: 1
42
43  vdd28-supply:
44    description: 2.8V supply
45
46  port:
47    $ref: /schemas/graph.yaml#/$defs/port-base
48    description: |
49      Video output port.
50
51    properties:
52      endpoint:
53        $ref: /schemas/media/video-interfaces.yaml#
54        unevaluatedProperties: false
55
56        properties:
57          bus-width: true
58          data-shift: true
59          hsync-active: true
60          vsync-active: true
61          data-active: true
62          pclk-sample: true
63
64        required:
65          - bus-width
66
67    additionalProperties: false
68
69required:
70  - compatible
71  - reg
72  - clocks
73  - powerdown-gpios
74  - port
75
76additionalProperties: false
77
78examples:
79  - |
80    #include <dt-bindings/gpio/gpio.h>
81
82    i2c {
83        #address-cells = <1>;
84        #size-cells = <0>;
85
86        camera-sensor@21 {
87            compatible = "galaxycore,gc0308";
88            reg = <0x21>;
89            clocks = <&camera_clk>;
90            powerdown-gpios = <&gpio1 5 GPIO_ACTIVE_HIGH>;
91            reset-gpios = <&gpio1 6 GPIO_ACTIVE_LOW>;
92            vdd28-supply = <&vdd28>;
93
94            port {
95                gc0308_ep: endpoint {
96                    remote-endpoint = <&parallel_from_gc0308>;
97                    bus-width = <8>;
98                    data-shift = <2>; /* lines 9:2 are used */
99                    hsync-active = <1>; /* active high */
100                    vsync-active = <1>; /* active high */
101                    data-active = <1>; /* active high */
102                    pclk-sample = <1>; /* sample on rising edge */
103                };
104            };
105        };
106    };
107
108...
109