49efff3874e0e2981b2f83848874e7c6a828662c
[openwrt/staging/blocktrron.git] /
1 From 3c54a4cdc8c65248c347a02b36ac378fe81379ba Mon Sep 17 00:00:00 2001
2 From: Dave Stevenson <dave.stevenson@raspberrypi.org>
3 Date: Wed, 28 Aug 2019 13:34:30 +0100
4 Subject: [PATCH] media: dt-bindings: Add binding for the Sony IMX219
5 sensor
6
7 The IMX219 is an 8MPix CSI2 sensor, supporting 2 or 4 data lanes.
8 Document the binding for this device.
9
10 Signed-off-by: Dave Stevenson <dave.stevenson@raspberrypi.org>
11 ---
12 .../devicetree/bindings/media/i2c/imx219.txt | 59 +++++++++++++++++++
13 1 file changed, 59 insertions(+)
14 create mode 100644 Documentation/devicetree/bindings/media/i2c/imx219.txt
15
16 --- /dev/null
17 +++ b/Documentation/devicetree/bindings/media/i2c/imx219.txt
18 @@ -0,0 +1,59 @@
19 +* Sony 1/4.0-Inch 8Mpixel CMOS Digital Image Sensor
20 +
21 +The Sony imx219 is a 1/4.0-inch CMOS active pixel digital image sensor with
22 +an active array size of 3280H x 2464V. It is programmable through I2C
23 +interface. The I2C address is fixed to 0x10 as per sensor data sheet.
24 +Image data is sent through MIPI CSI-2, which is configured as either 2 or 4
25 +data lanes.
26 +
27 +Required Properties:
28 +- compatible: value should be "sony,imx219" for imx219 sensor
29 +- reg: I2C bus address of the device
30 +- clocks: reference to the xclk input clock.
31 +- clock-names: should be "xclk".
32 +- DOVDD-supply: Digital I/O voltage supply, 1.8 volts
33 +- AVDD-supply: Analog voltage supply, 2.8 volts
34 +- DVDD-supply: Digital core voltage supply, 1.2 volts
35 +
36 +Optional Properties:
37 +- xclr-gpios: reference to the GPIO connected to the xclr pin, if any. Must be
38 + released after all supplies are applied.
39 + This is an active high signal to the imx219.
40 +
41 +The imx219 device node should contain one 'port' child node with
42 +an 'endpoint' subnode. For further reading on port node refer to
43 +Documentation/devicetree/bindings/media/video-interfaces.txt.
44 +
45 +Endpoint node required properties for CSI-2 connection are:
46 +- remote-endpoint: a phandle to the bus receiver's endpoint node.
47 +- clock-lanes: should be set to <0> (clock lane on hardware lane 0)
48 +- data-lanes: should be set to <1 2>, or <1 2 3 4> (two or four lane CSI-2
49 + supported)
50 +
51 +Example:
52 + sensor@10 {
53 + compatible = "sony,imx219";
54 + reg = <0x10>;
55 + #address-cells = <1>;
56 + #size-cells = <0>;
57 + clocks = <&imx219_clk>;
58 + clock-names = "xclk";
59 + xclr-gpios = <&gpio_sensor 0 0>;
60 + DOVDD-supply = <&vgen4_reg>; /* 1.8v */
61 + AVDD-supply = <&vgen3_reg>; /* 2.8v */
62 + DVDD-supply = <&vgen2_reg>; /* 1.2v */
63 +
64 + imx219_clk: camera-clk {
65 + compatible = "fixed-clock";
66 + #clock-cells = <0>;
67 + clock-frequency = <24000000>;
68 + };
69 +
70 + port {
71 + sensor_out: endpoint {
72 + remote-endpoint = <&csiss_in>;
73 + clock-lanes = <0>;
74 + data-lanes = <1 2>;
75 + };
76 + };
77 + };