git.openwrt.org Git - openwrt/staging/neocturne.git/blob

   1 From 543fdf41f158306f263ead06f6036cdfc1e73b05 Mon Sep 17 00:00:00 2001
   2 From: Lee Jackson <info@arducam.com>
   3 Date: Thu, 21 Apr 2022 14:18:44 +0800
   4 Subject: [PATCH] media: dt-bindings: media: i2c: Add Arducam Pivariety
   5  Series CMOS sensor binding
   6
   7 Add YAML device tree binding for Arducam Pivariety CMOS image sensor, and
   8 the relevant MAINTAINERS entries.
   9
  10 Signed-off-by: Lee Jackson <info@arducam.com>
  11 ---
  12  .../bindings/media/i2c/arducam-pivariety.yaml | 112 ++++++++++++++++++
  13  MAINTAINERS                                   |   8 ++
  14  2 files changed, 120 insertions(+)
  15  create mode 100644 Documentation/devicetree/bindings/media/i2c/arducam-pivariety.yaml
  16
  17 --- /dev/null
  18 +++ b/Documentation/devicetree/bindings/media/i2c/arducam-pivariety.yaml
  19 @@ -0,0 +1,112 @@
  20 +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  21 +%YAML 1.2
  22 +---
  23 +$id: http://devicetree.org/schemas/media/i2c/arducam-pivariety.yaml#
  24 +$schema: http://devicetree.org/meta-schemas/core.yaml#
  25 +
  26 +title: Arducam Pivariety Series CMOS Digital Image Sensor
  27 +
  28 +maintainers:
  29 +  - Lee Jackson <info@arducam.com>
  30 +
  31 +description: |-
  32 +  Arducam Pivariety series cameras make compatibility layers for various CMOS
  33 +  sensors and provide a unified command interface. It is programmable through
  34 +  I2C interface. The I2C address is fixed to 0x0C. Image data is sent through
  35 +  MIPI CSI-2, which is configured as either 1, 2 or 4 data lanes.
  36 +
  37 +properties:
  38 +  compatible:
  39 +    const: arducam,arducam-pivariety
  40 +
  41 +  reg:
  42 +    description: I2C device address
  43 +    maxItems: 1
  44 +
  45 +  clocks:
  46 +    maxItems: 1
  47 +
  48 +  VDIG-supply:
  49 +    description:
  50 +      Digital I/O voltage supply, 1.05 volts
  51 +
  52 +  VANA-supply:
  53 +    description:
  54 +      Analog voltage supply, 2.8 volts
  55 +
  56 +  VDDL-supply:
  57 +    description:
  58 +      Digital core voltage supply, 1.8 volts
  59 +
  60 +  reset-gpios:
  61 +    description: |-
  62 +      Reference to the GPIO connected to the xclr pin, if any.
  63 +      Must be released (set high) after all supplies and INCK are applied.
  64 +
  65 +  # See ../video-interfaces.txt for more details
  66 +  port:
  67 +    type: object
  68 +    properties:
  69 +      endpoint:
  70 +        type: object
  71 +        properties:
  72 +          data-lanes:
  73 +            description: |-
  74 +              The sensor supports either two-lane, or four-lane operation.
  75 +              For two-lane operation the property must be set to <1 2>.
  76 +            items:
  77 +              - const: 1
  78 +              - const: 2
  79 +
  80 +          clock-noncontinuous:
  81 +            type: boolean
  82 +            description: |-
  83 +              MIPI CSI-2 clock is non-continuous if this property is present,
  84 +              otherwise it's continuous.
  85 +
  86 +          link-frequencies:
  87 +            allOf:
  88 +              - $ref: /schemas/types.yaml#/definitions/uint64-array
  89 +            description:
  90 +              Allowed data bus frequencies.
  91 +
  92 +        required:
  93 +          - link-frequencies
  94 +
  95 +required:
  96 +  - compatible
  97 +  - reg
  98 +  - clocks
  99 +  - VANA-supply
 100 +  - VDIG-supply
 101 +  - VDDL-supply
 102 +  - port
 103 +
 104 +additionalProperties: false
 105 +
 106 +examples:
 107 +  - |
 108 +    i2c0 {
 109 +        #address-cells = <1>;
 110 +        #size-cells = <0>;
 111 +
 112 +        arducam_pivariety: sensor@0c {
 113 +            compatible = "arducam,arducam-pivariety";
 114 +            reg = <0x0c>;
 115 +            clocks = <&arducam_pivariety_clk>;
 116 +            VANA-supply = <&arducam_pivariety_vana>;   /* 2.8v */
 117 +            VDIG-supply = <&arducam_pivariety_vdig>;   /* 1.05v */
 118 +            VDDL-supply = <&arducam_pivariety_vddl>;   /* 1.8v */
 119 +
 120 +            port {
 121 +                arducam_pivariety_0: endpoint {
 122 +                    remote-endpoint = <&csi1_ep>;
 123 +                    data-lanes = <1 2>;
 124 +                    clock-noncontinuous;
 125 +                    link-frequencies = /bits/ 64 <493500000>;
 126 +                };
 127 +            };
 128 +        };
 129 +    };
 130 +
 131 +...
 132 --- a/MAINTAINERS
 133 +++ b/MAINTAINERS
 134 @@ -1559,6 +1559,14 @@ S:       Maintained
 135  F:     drivers/net/arcnet/
 136  F:     include/uapi/linux/if_arcnet.h
 137
 138 +ARDUCAM PIVARIETY SENSOR DRIVER
 139 +M:     Arducam Kernel Maintenance <info@arducam.com>
 140 +L:     linux-media@vger.kernel.org
 141 +S:     Maintained
 142 +T:     git git://linuxtv.org/media_tree.git
 143 +F:     Documentation/devicetree/bindings/media/i2c/arducam-pivariety.yaml
 144 +F:     drivers/media/i2c/arducam-pivariety.c
 145 +
 146  ARM ARCHITECTED TIMER DRIVER
 147  M:     Mark Rutland <mark.rutland@arm.com>
 148  M:     Marc Zyngier <maz@kernel.org>