On Thu, 3 Nov 2022 09:05:05 -0400 Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxx> wrote: Hi, Thanks a lot for detailed comments and suggestions for revisions,there is one place where I have some doubts. > On 02/11/2022 23:04, lee wrote: > > Add YAML device tree binding for IMX519 CMOS image sensor, and > > the relevant MAINTAINERS entries. > > > > Signed-off-by: Lee Jackson <lee@xxxxxxxxxxx> > > Your From does not match fully SoB. > > > --- > > .../bindings/media/i2c/sony,imx519.yaml | 107 > > ++++++++++++++++++ MAINTAINERS | > > 9 ++ 2 files changed, 116 insertions(+) > > create mode 100644 > > Documentation/devicetree/bindings/media/i2c/sony,imx519.yaml > > > > diff --git > > a/Documentation/devicetree/bindings/media/i2c/sony,imx519.yaml > > b/Documentation/devicetree/bindings/media/i2c/sony,imx519.yaml new > > file mode 100644 index 000000000000..9b6cda96f613 --- /dev/null > > +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx519.yaml > > @@ -0,0 +1,107 @@ > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/media/i2c/sony,imx519.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: Sony 1/2.5-Inch 16Mpixel CMOS Digital Image Sensor > > + > > +maintainers: > > + - Lee Jackson <lee@xxxxxxxxxxx> > > + > > +description: |- > > + The Sony IMX519 is a 1/2.5-inch CMOS active pixel digital image > > sensor > > + with an active array size of 4656H x 3496V. It is programmable > > through > > + I2C interface. The I2C address is fixed to 0x1A as per sensor > > data sheet. > > + Image data is sent through MIPI CSI-2, which is configured as > > either 2 or > > + 4 data lanes. > > + > > +properties: > > + compatible: > > + const: sony,imx519 > > + > > + reg: > > + description: I2C device address > > Skip description. > > > + maxItems: 1 > > + > > + clocks: > > + maxItems: 1 > > + > > + VDIG-supply: > > Use lower case names. Here we refer to other drivers (imx219), they are all uppercase, is lowercase mandatory? > > > + description: > > + Digital I/O voltage supply, 1.05 volts > > + > > + VANA-supply: > > + description: > > + Analog voltage supply, 2.8 volts > > + > > + VDDL-supply: > > + description: > > + Digital core voltage supply, 1.8 volts > > + > > + reset-gpios: > > + description: |- > > + Reference to the GPIO connected to the xclr pin, if any. > > + Must be released (set high) after all supplies and INCK are > > applied. + > > +port: > > + $ref: /schemas/graph.yaml#/$defs/port-base > > + additionalProperties: false > > + > > + properties: > > + endpoint: > > + $ref: /schemas/media/video-interfaces.yaml# > > + unevaluatedProperties: false > > + > > + properties: > > + data-lanes: > > + description: |- > > + The driver only supports two-lane operation. > > Please describe the hardware, not driver. > > > + items: > > + - const: 1 > > + - const: 2 > > + > > + clock-noncontinuous: true > > + link-frequencies: true > > I think these are coming from video-interfaces, so no need for them. > > > + > > + required: > > + - data-lanes > > + - link-frequencies > > + > > +required: > > + - compatible > > + - reg > > + - clocks > > + - VANA-supply > > + - VDIG-supply > > + - VDDL-supply > > + - port > > + > > +additionalProperties: false > > + > > +examples: > > + - | > > + i2c0 { > > i2c > > > + #address-cells = <1>; > > + #size-cells = <0>; > > + > > > + imx519: sensor@1a { > > + compatible = "sony,imx519"; > > + reg = <0x1a>; > > + clocks = <&imx519_clk>; > > + VANA-supply = <&imx519_vana>; /* 2.8v */ > > + VDIG-supply = <&imx519_vdig>; /* 1.05v */ > > + VDDL-supply = <&imx519_vddl>; /* 1.8v */ > > + > > + port { > > + imx519_0: endpoint { > > + remote-endpoint = <&csi1_ep>; > > + data-lanes = <1 2>; > > + clock-noncontinuous; > > + link-frequencies = /bits/ 64 <493500000>; > > + }; > > + }; > > + }; > > + }; > > + > > +... > > diff --git a/MAINTAINERS b/MAINTAINERS > > index e04d944005ba..5a617ab8c9b2 100644 > > --- a/MAINTAINERS > > +++ b/MAINTAINERS > > @@ -19236,6 +19236,15 @@ T: git > > git://linuxtv.org/media_tree.git F: > > Documentation/devicetree/bindings/media/i2c/sony,imx412.yaml > > F: drivers/media/i2c/imx412.c > > +SONY IMX519 SENSOR DRIVER > > +M: Arducam Kernel Maintenance <info@xxxxxxxxxxx> > > +M: Lee Jackson <lee@xxxxxxxxxxx> > > +L: linux-media@xxxxxxxxxxxxxxx > > +S: Maintained > > +T: git git://linuxtv.org/media_tree.git > > +F: > > Documentation/devicetree/bindings/media/i2c/sony,imx519.yaml > > +F: drivers/media/i2c/imx519.c > > The file does not exist, so path is not correct (yet). Add it in 2/2. > > > Best regards, > Krzysztof > Best regards, lee