target/linux/bcm27xx/patches-4.19/950-0677-media-dt-bindings-Add-binding-for-the-Sony-IMX219-se.patch

   1 From 2d8a780a994098f7c532b712abd7298e0bca5a12 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 +       };