Commit 30cbaa02 authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Mauro Carvalho Chehab

media: dt-bindings: samsung,s5c73m3: convert to dtschema

Convert the Samsung S5C73M3 8Mp camera ISP 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 464c2572
# 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>;
};
};
};
Samsung S5C73M3 8Mp camera ISP
------------------------------
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.
I2C slave device node
---------------------
Required properties:
- compatible : "samsung,s5c73m3";
- reg : I2C slave address of the sensor;
- vdd-int-supply : digital power supply (1.2V);
- vdda-supply : analog power supply (1.2V);
- vdd-reg-supply : regulator input power supply (2.8V);
- vddio-host-supply : host I/O power supply (1.8V to 2.8V);
- vddio-cis-supply : CIS I/O power supply (1.2V to 1.8V);
- vdd-af-supply : lens power supply (2.8V);
- xshutdown-gpios : specifier of GPIO connected to the XSHUTDOWN pin;
- standby-gpios : specifier of GPIO connected to the STANDBY 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 "cis_extclk" entry for the CIS_EXTCLK clock;
Optional properties:
- clock-frequency : the frequency at which the "cis_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 from the S5C73M3 to an external image data receiver. The S5C73M3
device node should contain one 'port' child node with an 'endpoint' subnode for
this purpose. The data link from a raw image sensor to the S5C73M3 can be
similarly specified, but it is optional since the S5C73M3 ISP and a raw image
sensor are usually inseparable and form a hybrid module.
Following properties are valid for the endpoint node(s):
endpoint subnode
----------------
- data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in
video-interfaces.txt. This sensor doesn't support data lane remapping
and physical lane indexes in subsequent elements of the array should
be only consecutive ascending values.
SPI device node
---------------
Required properties:
- compatible : "samsung,s5c73m3";
For more details see description of the SPI busses bindings
(../spi/spi-bus.txt) and bindings of a specific bus controller.
Example:
i2c@138a000000 {
...
s5c73m3@3c {
compatible = "samsung,s5c73m3";
reg = <0x3c>;
vdd-int-supply = <&buck9_reg>;
vdda-supply = <&ldo17_reg>;
vdd-reg-supply = <&cam_io_reg>;
vddio-host-supply = <&ldo18_reg>;
vddio-cis-supply = <&ldo9_reg>;
vdd-af-supply = <&cam_af_reg>;
clock-frequency = <24000000>;
clocks = <&clk 0>;
clock-names = "cis_extclk";
xshutdown-gpios = <&gpf1 3 1>;
standby-gpios = <&gpm0 1 1>;
port {
s5c73m3_ep: endpoint {
remote-endpoint = <&csis0_ep>;
data-lanes = <1 2 3 4>;
};
};
};
};
spi@1392000 {
...
s5c73m3_spi: s5c73m3@0 {
compatible = "samsung,s5c73m3";
reg = <0>;
...
};
};
...@@ -18498,6 +18498,7 @@ M: Sylwester Nawrocki <s.nawrocki@samsung.com> ...@@ -18498,6 +18498,7 @@ M: Sylwester Nawrocki <s.nawrocki@samsung.com>
M: Andrzej Hajda <andrzej.hajda@intel.com> M: Andrzej Hajda <andrzej.hajda@intel.com>
L: linux-media@vger.kernel.org L: linux-media@vger.kernel.org
S: Supported S: Supported
F: Documentation/devicetree/bindings/media/samsung,s5c73m3.yaml
F: drivers/media/i2c/s5c73m3/* F: drivers/media/i2c/s5c73m3/*
SAMSUNG S5K5BAF CAMERA DRIVER SAMSUNG S5K5BAF CAMERA DRIVER
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment