Documentation/devicetree/bindings/media/samsung,s5c73m3.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/media/samsung,s5c73m3.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung S5C73M3 8Mp camera ISP
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
  11   - Sylwester Nawrocki <s.nawrocki@samsung.com>
  12
  13 description:
  14   The S5C73M3 camera ISP supports MIPI CSI-2 and parallel (ITU-R BT.656)
  15   video data busses. The I2C bus is the main control bus and additionally the
  16   SPI bus is used, mostly for transferring the firmware to and from the
  17   device. Two slave device nodes corresponding to these control bus
  18   interfaces are required and should be placed under respective bus
  19   controller nodes.
  20
  21 properties:
  22   compatible:
  23     const: samsung,s5c73m3
  24
  25   reg:
  26     maxItems: 1
  27
  28   clocks:
  29     maxItems: 1
  30
  31   clock-names:
  32     items:
  33       - const: cis_extclk
  34
  35   clock-frequency:
  36     default: 24000000
  37     description: cis_extclk clock frequency.
  38
  39   standby-gpios:
  40     maxItems: 1
  41     description: STANDBY pin.
  42
  43   vdda-supply:
  44     description: Analog power supply (1.2V).
  45
  46   vdd-af-supply:
  47     description: lens power supply (2.8V).
  48
  49   vddio-cis-supply:
  50     description: CIS I/O power supply (1.2V to 1.8V).
  51
  52   vddio-host-supply:
  53     description: Host I/O power supply (1.8V to 2.8V).
  54
  55   vdd-int-supply:
  56     description: Digital power supply (1.2V).
  57
  58   vdd-reg-supply:
  59     description: Regulator input power supply (2.8V).
  60
  61   xshutdown-gpios:
  62     maxItems: 1
  63     description: XSHUTDOWN pin.
  64
  65   port:
  66     $ref: /schemas/graph.yaml#/$defs/port-base
  67     additionalProperties: false
  68
  69     properties:
  70       endpoint:
  71         $ref: /schemas/media/video-interfaces.yaml#
  72         unevaluatedProperties: false
  73
  74         properties:
  75           data-lanes:
  76             items:
  77               - const: 1
  78               - const: 2
  79               - const: 3
  80               - const: 4
  81
  82 required:
  83   - compatible
  84   - reg
  85
  86 allOf:
  87   - $ref: /schemas/spi/spi-peripheral-props.yaml#
  88   - if:
  89       required:
  90         - spi-max-frequency
  91     then:
  92       properties:
  93         # The SPI node is simplified firmware-transfer interface only
  94         clocks: false
  95         clock-names: false
  96         standby-gpios: false
  97         vdda-supply: false
  98         vdd-af-supply: false
  99         vddio-cis-supply: false
 100         vddio-host-supply: false
 101         vdd-int-supply: false
 102         vdd-reg-supply: false
 103         xshutdown-gpios: false
 104         port: false
 105     else:
 106       required:
 107         - clocks
 108         - clock-names
 109         - standby-gpios
 110         - vdda-supply
 111         - vdd-af-supply
 112         - vddio-cis-supply
 113         - vddio-host-supply
 114         - vdd-int-supply
 115         - vdd-reg-supply
 116         - xshutdown-gpios
 117         - port
 118
 119 unevaluatedProperties: false
 120
 121 examples:
 122   - |
 123     #include <dt-bindings/gpio/gpio.h>
 124
 125     i2c {
 126         #address-cells = <1>;
 127         #size-cells = <0>;
 128
 129         image-sensor@3c {
 130             compatible = "samsung,s5c73m3";
 131             reg = <0x3c>;
 132             clock-frequency = <24000000>;
 133             clocks = <&camera 0>;
 134             clock-names = "cis_extclk";
 135             standby-gpios = <&gpm0 6 GPIO_ACTIVE_LOW>;
 136             vdda-supply = <&cam_vdda_reg>;
 137             vdd-af-supply = <&cam_af_reg>;
 138             vddio-cis-supply = <&ldo9_reg>;
 139             vddio-host-supply = <&ldo18_reg>;
 140             vdd-int-supply = <&buck9_reg>;
 141             vdd-reg-supply = <&cam_io_reg>;
 142             xshutdown-gpios = <&gpf1 3 GPIO_ACTIVE_LOW>; /* ISP_RESET */
 143
 144             port {
 145                 s5c73m3_ep: endpoint {
 146                     remote-endpoint = <&csis0_ep>;
 147                     data-lanes = <1 2 3 4>;
 148                 };
 149             };
 150         };
 151     };
 152
 153     spi {
 154         #address-cells = <1>;
 155         #size-cells = <0>;
 156
 157         image-sensor@0 {
 158             compatible = "samsung,s5c73m3";
 159             reg = <0>;
 160             spi-max-frequency = <50000000>;
 161             controller-data {
 162                 samsung,spi-feedback-delay = <2>;
 163             };
 164         };
 165     };