Merge tag 'v5.15.57' into rpi-5.15.y
[platform/kernel/linux-rpi.git] / Documentation / devicetree / bindings / media / i2c / imx219.txt
1 * Sony 1/4.0-Inch 8Mpixel CMOS Digital Image Sensor
2
3 The Sony imx219 is a 1/4.0-inch CMOS active pixel digital image sensor with
4 an active array size of 3280H x 2464V. It is programmable through I2C
5 interface. The I2C address is fixed to 0x10 as per sensor data sheet.
6 Image data is sent through MIPI CSI-2, which is configured as either 2 or 4
7 data lanes.
8
9 Required Properties:
10 - compatible: value should be "sony,imx219" for imx219 sensor
11 - reg: I2C bus address of the device
12 - clocks: reference to the xclk input clock.
13 - clock-names: should be "xclk".
14 - DOVDD-supply: Digital I/O voltage supply, 1.8 volts
15 - AVDD-supply: Analog voltage supply, 2.8 volts
16 - DVDD-supply: Digital core voltage supply, 1.2 volts
17
18 Optional Properties:
19 - xclr-gpios: reference to the GPIO connected to the xclr pin, if any. Must be
20               released after all supplies are applied.
21               This is an active high signal to the imx219.
22
23 The imx219 device node should contain one 'port' child node with
24 an 'endpoint' subnode. For further reading on port node refer to
25 Documentation/devicetree/bindings/media/video-interfaces.txt.
26
27 Endpoint node required properties for CSI-2 connection are:
28 - remote-endpoint: a phandle to the bus receiver's endpoint node.
29 - clock-lanes: should be set to <0> (clock lane on hardware lane 0)
30 - data-lanes: should be set to <1 2>, or  <1 2 3 4> (two or four lane CSI-2
31   supported)
32
33 Example:
34         sensor@10 {
35                 compatible = "sony,imx219";
36                 reg = <0x10>;
37                 #address-cells = <1>;
38                 #size-cells = <0>;
39                 clocks = <&imx219_clk>;
40                 clock-names = "xclk";
41                 xclr-gpios = <&gpio_sensor 0 0>;
42                 DOVDD-supply = <&vgen4_reg>; /* 1.8v */
43                 AVDD-supply = <&vgen3_reg>;  /* 2.8v */
44                 DVDD-supply = <&vgen2_reg>;  /* 1.2v */
45
46                 imx219_clk: camera-clk {
47                         compatible = "fixed-clock";
48                         #clock-cells = <0>;
49                         clock-frequency = <24000000>;
50                 };
51
52                 port {
53                         sensor_out: endpoint {
54                                 remote-endpoint = <&csiss_in>;
55                                 clock-lanes = <0>;
56                                 data-lanes = <1 2>;
57                         };
58                 };
59         };