xref: /freebsd/sys/contrib/device-tree/Bindings/media/samsung-s5c73m3.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1Samsung S5C73M3 8Mp camera ISP
2------------------------------
3
4The S5C73M3 camera ISP supports MIPI CSI-2 and parallel (ITU-R BT.656) video
5data busses. The I2C bus is the main control bus and additionally the SPI bus
6is used, mostly for transferring the firmware to and from the device. Two
7slave device nodes corresponding to these control bus interfaces are required
8and should be placed under respective bus controller nodes.
9
10I2C slave device node
11---------------------
12
13Required properties:
14
15- compatible	    : "samsung,s5c73m3";
16- reg		    : I2C slave address of the sensor;
17- vdd-int-supply    : digital power supply (1.2V);
18- vdda-supply	    : analog power supply (1.2V);
19- vdd-reg-supply    : regulator input power supply (2.8V);
20- vddio-host-supply : host I/O power supply (1.8V to 2.8V);
21- vddio-cis-supply  : CIS I/O power supply (1.2V to 1.8V);
22- vdd-af-supply     : lens power supply (2.8V);
23- xshutdown-gpios   : specifier of GPIO connected to the XSHUTDOWN pin;
24- standby-gpios     : specifier of GPIO connected to the STANDBY pin;
25- clocks	    : should contain list of phandle and clock specifier pairs
26		      according to common clock bindings for the clocks described
27		      in the clock-names property;
28- clock-names	    : should contain "cis_extclk" entry for the CIS_EXTCLK clock;
29
30Optional properties:
31
32- clock-frequency   : the frequency at which the "cis_extclk" clock should be
33		      configured to operate, in Hz; if this property is not
34		      specified default 24 MHz value will be used.
35
36The common video interfaces bindings (see video-interfaces.txt) should be used
37to specify link from the S5C73M3 to an external image data receiver. The S5C73M3
38device node should contain one 'port' child node with an 'endpoint' subnode for
39this purpose. The data link from a raw image sensor to the S5C73M3 can be
40similarly specified, but it is optional since the S5C73M3 ISP and a raw image
41sensor are usually inseparable and form a hybrid module.
42
43Following properties are valid for the endpoint node(s):
44
45endpoint subnode
46----------------
47
48- data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in
49  video-interfaces.txt. This sensor doesn't support data lane remapping
50  and physical lane indexes in subsequent elements of the array should
51  be only consecutive ascending values.
52
53SPI device node
54---------------
55
56Required properties:
57
58- compatible	    : "samsung,s5c73m3";
59
60For more details see description of the SPI busses bindings
61(../spi/spi-bus.txt) and bindings of a specific bus controller.
62
63Example:
64
65i2c@138a000000 {
66	...
67	s5c73m3@3c {
68		compatible = "samsung,s5c73m3";
69		reg = <0x3c>;
70		vdd-int-supply = <&buck9_reg>;
71		vdda-supply = <&ldo17_reg>;
72		vdd-reg-supply = <&cam_io_reg>;
73		vddio-host-supply = <&ldo18_reg>;
74		vddio-cis-supply = <&ldo9_reg>;
75		vdd-af-supply = <&cam_af_reg>;
76		clock-frequency = <24000000>;
77		clocks = <&clk 0>;
78		clock-names = "cis_extclk";
79		reset-gpios = <&gpf1 3 1>;
80		standby-gpios = <&gpm0 1 1>;
81		port {
82			s5c73m3_ep: endpoint {
83				remote-endpoint = <&csis0_ep>;
84				data-lanes = <1 2 3 4>;
85			};
86		};
87	};
88};
89
90spi@1392000 {
91	...
92	s5c73m3_spi: s5c73m3@0 {
93		compatible = "samsung,s5c73m3";
94		reg = <0>;
95		...
96	};
97};
98