media: dt-bindings: samsung,s5c73m3: convert to dtschema (30cbaa02) · Commits · jan.koester / Linux

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

0 → 100644

+165 −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/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>;
		};
		};
		};

Documentation/devicetree/bindings/media/samsung-s5c73m3.txt

deleted100644 → 0

+0 −97

Original line number	Diff line number	Diff line
		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>;
		...
		};
		};

MAINTAINERS

+1 −0

Original line number	Diff line number	Diff line
		@@ -18498,6 +18498,7 @@ M: Sylwester Nawrocki <s.nawrocki@samsung.com>
		M: Andrzej Hajda <andrzej.hajda@intel.com>
		L: linux-media@vger.kernel.org
		S: Supported
		F: Documentation/devicetree/bindings/media/samsung,s5c73m3.yaml
		F: drivers/media/i2c/s5c73m3/*

		SAMSUNG S5K5BAF CAMERA DRIVER