summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/media/samsung,s5c73m3.yaml
blob: 1b75390fdaac704dedb419f79ce5783a3a3ac94f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/media/samsung,s5c73m3.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung S5C73M3 8Mp camera ISP

maintainers:
  - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
  - Sylwester Nawrocki <s.nawrocki@samsung.com>

description:
  The S5C73M3 camera ISP supports MIPI CSI-2 and parallel (ITU-R BT.656)
  video data busses. The I2C bus is the main control bus and additionally the
  SPI bus is used, mostly for transferring the firmware to and from the
  device. Two slave device nodes corresponding to these control bus
  interfaces are required and should be placed under respective bus
  controller nodes.

properties:
  compatible:
    const: samsung,s5c73m3

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: cis_extclk

  clock-frequency:
    default: 24000000
    description: cis_extclk clock frequency.

  standby-gpios:
    maxItems: 1
    description: STANDBY pin.

  vdda-supply:
    description: Analog power supply (1.2V).

  vdd-af-supply:
    description: lens power supply (2.8V).

  vddio-cis-supply:
    description: CIS I/O power supply (1.2V to 1.8V).

  vddio-host-supply:
    description: Host I/O power supply (1.8V to 2.8V).

  vdd-int-supply:
    description: Digital power supply (1.2V).

  vdd-reg-supply:
    description: Regulator input power supply (2.8V).

  xshutdown-gpios:
    maxItems: 1
    description: XSHUTDOWN pin.

  port:
    $ref: /schemas/graph.yaml#/$defs/port-base
    additionalProperties: false

    properties:
      endpoint:
        $ref: /schemas/media/video-interfaces.yaml#
        unevaluatedProperties: false

        properties:
          data-lanes:
            items:
              - const: 1
              - const: 2
              - const: 3
              - const: 4

required:
  - compatible
  - reg

allOf:
  - $ref: /schemas/spi/spi-peripheral-props.yaml#
  - if:
      required:
        - spi-max-frequency
    then:
      properties:
        # The SPI node is simplified firmware-transfer interface only
        clocks: false
        clock-names: false
        standby-gpios: false
        vdda-supply: false
        vdd-af-supply: false
        vddio-cis-supply: false
        vddio-host-supply: false
        vdd-int-supply: false
        vdd-reg-supply: false
        xshutdown-gpios: false
        port: false
    else:
      required:
        - clocks
        - clock-names
        - standby-gpios
        - vdda-supply
        - vdd-af-supply
        - vddio-cis-supply
        - vddio-host-supply
        - vdd-int-supply
        - vdd-reg-supply
        - xshutdown-gpios
        - port

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>

    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        image-sensor@3c {
            compatible = "samsung,s5c73m3";
            reg = <0x3c>;
            clock-frequency = <24000000>;
            clocks = <&camera 0>;
            clock-names = "cis_extclk";
            standby-gpios = <&gpm0 6 GPIO_ACTIVE_LOW>;
            vdda-supply = <&cam_vdda_reg>;
            vdd-af-supply = <&cam_af_reg>;
            vddio-cis-supply = <&ldo9_reg>;
            vddio-host-supply = <&ldo18_reg>;
            vdd-int-supply = <&buck9_reg>;
            vdd-reg-supply = <&cam_io_reg>;
            xshutdown-gpios = <&gpf1 3 GPIO_ACTIVE_LOW>; /* ISP_RESET */

            port {
                s5c73m3_ep: endpoint {
                    remote-endpoint = <&csis0_ep>;
                    data-lanes = <1 2 3 4>;
                };
            };
        };
    };

    spi {
        #address-cells = <1>;
        #size-cells = <0>;

        image-sensor@0 {
            compatible = "samsung,s5c73m3";
            reg = <0>;
            spi-max-frequency = <50000000>;
            controller-data {
                samsung,spi-feedback-delay = <2>;
            };
        };
    };