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

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



Convert the Samsung S5K5BAF 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 9cbe7765
Loading
Loading
Loading
Loading
+101 −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,s5k5baf.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung S5K5BAF UXGA 1/5" 2M CMOS Image Sensor with embedded SoC ISP

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

properties:
  compatible:
    const: samsung,s5k5baf

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    items:
      - const: mclk

  clock-frequency:
    default: 24000000
    description: mclk clock frequency

  rstn-gpios:
    maxItems: 1
    description: RSTN pin

  stbyn-gpios:
    maxItems: 1
    description: STDBYN pin

  vdda-supply:
    description: Analog power supply 2.8V (2.6V to 3.0V)

  vddio-supply:
    description: I/O power supply 1.8V (1.65V to 1.95V) or 2.8V (2.5V to 3.1V)

  vddreg-supply:
    description:
      Regulator input power supply 1.8V (1.7V to 1.9V) or 2.8V (2.6V to 3.0)

  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
  - rstn-gpios
  - stbyn-gpios
  - vdda-supply
  - vddio-supply
  - vddreg-supply

additionalProperties: false

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

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

        sensor@2d {
            compatible = "samsung,s5k5baf";
            reg = <0x2d>;
            clocks = <&camera 0>;
            clock-names = "mclk";
            clock-frequency = <24000000>;
            rstn-gpios = <&gpl2 1 GPIO_ACTIVE_LOW>;
            stbyn-gpios = <&gpl2 0 GPIO_ACTIVE_LOW>;
            vdda-supply = <&cam_io_en_reg>;
            vddio-supply = <&vtcam_reg>;
            vddreg-supply = <&vt_core_15v_reg>;

            port {
                endpoint {
                    remote-endpoint = <&csis1_ep>;
                    data-lanes = <1>;
                };
            };
        };
    };
+0 −58
Original line number Diff line number Diff line
Samsung S5K5BAF UXGA 1/5" 2M CMOS Image Sensor with embedded SoC ISP
--------------------------------------------------------------------

Required properties:

- compatible	  : "samsung,s5k5baf";
- reg		  : I2C slave address of the sensor;
- vdda-supply	  : analog power supply 2.8V (2.6V to 3.0V);
- vddreg-supply	  : regulator input power supply 1.8V (1.7V to 1.9V)
		    or 2.8V (2.6V to 3.0);
- vddio-supply	  : I/O power supply 1.8V (1.65V to 1.95V)
		    or 2.8V (2.5V to 3.1V);
- stbyn-gpios	  : GPIO connected to STDBYN pin;
- rstn-gpios	  : GPIO connected to RSTN pin;
- clocks	  : list of phandle and clock specifier pairs
		    according to common clock bindings for the
		    clocks described in clock-names;
- clock-names	  : should include "mclk" for the sensor's master clock;

Optional properties:

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

The device node should contain one 'port' child node with one child 'endpoint'
node, according to the bindings defined in Documentation/devicetree/bindings/
media/video-interfaces.txt. The following are properties specific to those
nodes.

endpoint node
-------------

- data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in
	       video-interfaces.txt. If present it should be <1> - the device
	       supports only one data lane without re-mapping.

Example:

s5k5bafx@2d {
	compatible = "samsung,s5k5baf";
	reg = <0x2d>;
	vdda-supply = <&cam_io_en_reg>;
	vddreg-supply = <&vt_core_15v_reg>;
	vddio-supply = <&vtcam_reg>;
	stbyn-gpios = <&gpl2 0 1>;
	rstn-gpios = <&gpl2 1 1>;
	clock-names = "mclk";
	clocks = <&clock_cam 0>;
	clock-frequency = <24000000>;

	port {
		s5k5bafx_ep: endpoint {
			remote-endpoint = <&csis1_ep>;
			data-lanes = <1>;
		};
	};
};