4fb64f57e7a914932f97bd698405eb1c009633a0
[oweals/openwrt.git] /
1 From 7bd5937663a13ad17a04d8ca8ba1503d492cf42b 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 +       };