Commit 9cbe7765 authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Mauro Carvalho Chehab
Browse files

media: dt-bindings: i2c: samsung,s5k6a3: convert to dtschema



Convert the Samsung S5K6A3(YX) raw image sensor bindings to DT schema.

Signed-off-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@kernel.org>
parent 7d3b26da
Loading
Loading
Loading
Loading
+98 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/media/i2c/samsung,s5k6a3.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung S5K6A3(YX) raw image sensor

maintainers:
  - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

description:
  S5K6A3(YX) is a raw image sensor with MIPI CSI-2 and CCP2 image data
  interfaces and CCI (I2C compatible) control bus.

properties:
  compatible:
    const: samsung,s5k6a3

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: extclk

  clock-frequency:
    default: 24000000
    description: extclk clock frequency

  gpios:
    maxItems: 1
    description: GPIO connected to the RESET pin

  afvdd-supply:
    description: AF (actuator) voltage supply

  svdda-supply:
    description: Core voltage supply

  svddio-supply:
    description: I/O voltage supply

  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

required:
  - compatible
  - clocks
  - clock-names
  - gpios
  - afvdd-supply
  - svdda-supply
  - svddio-supply

additionalProperties: false

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

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

        sensor@10 {
            compatible = "samsung,s5k6a3";
            reg = <0x10>;
            clock-frequency = <24000000>;
            clocks = <&camera 1>;
            clock-names = "extclk";
            gpios = <&gpm1 6 GPIO_ACTIVE_LOW>;
            afvdd-supply = <&ldo19_reg>;
            svdda-supply = <&cam_io_reg>;
            svddio-supply = <&ldo19_reg>;

            port {
                endpoint {
                    remote-endpoint = <&csis1_ep>;
                    data-lanes = <1>;
                };
            };
        };
    };
+0 −33
Original line number Diff line number Diff line
Samsung S5K6A3(YX) raw image sensor
---------------------------------

S5K6A3(YX) is a raw image sensor with MIPI CSI-2 and CCP2 image data interfaces
and CCI (I2C compatible) control bus.

Required properties:

- compatible	: "samsung,s5k6a3";
- reg		: I2C slave address of the sensor;
- svdda-supply	: core voltage supply;
- svddio-supply	: I/O voltage supply;
- afvdd-supply	: AF (actuator) voltage supply;
- gpios		: specifier of a GPIO connected to the RESET pin;
- clocks	: should contain list of phandle and clock specifier pairs
		  according to common clock bindings for the clocks described
		  in the clock-names property;
- clock-names	: should contain "extclk" entry for the sensor's EXTCLK clock;

Optional properties:

- clock-frequency : the frequency at which the "extclk" clock should be
		    configured to operate, in Hz; if this property is not
		    specified default 24 MHz value will be used.

The common video interfaces bindings (see video-interfaces.txt) should be
used to specify link to the image data receiver. The S5K6A3(YX) device
node should contain one 'port' child node with an 'endpoint' subnode.

Following properties are valid for the endpoint node:

- data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in
  video-interfaces.txt.  The sensor supports only one data lane.