| Message ID | 20200817160037.255972-1-jacopo+renesas@jmondi.org (mailing list archive) |
|---|---|
| State | New |
| Delegated to: | Kieran Bingham |
| Headers | show |
| Series | | expand |
Slightly better with a subject =) I made a formatting error, empty line between receivers list and Subject: Sorry about this :) On Mon, Aug 17, 2020 at 06:00:37PM +0200, Jacopo Mondi wrote: > Subject: [PATCH] dt-bindings: media: imx274: Convert to json-schema > > Convert the imx274 bindings document to json-schema and update > the MAINTAINERS file accordingly. > > Signed-off-by: Jacopo Mondi <jacopo+renesas@jmondi.org> > --- > .../bindings/media/i2c/sony,imx214.txt | 53 -------- > .../bindings/media/i2c/sony,imx214.yaml | 124 ++++++++++++++++++ > MAINTAINERS | 2 +- > 3 files changed, 125 insertions(+), 54 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > create mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > > diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt b/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > deleted file mode 100644 > index f11f28a5fda4..000000000000 > --- a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > +++ /dev/null > @@ -1,53 +0,0 @@ > -* Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor > - > -The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with > -an active array size of 4224H x 3200V. It is programmable through an I2C > -interface. > -Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a maximum > -throughput of 1.2Gbps/lane. > - > - > -Required Properties: > -- compatible: Shall be "sony,imx214". > -- reg: I2C bus address of the device. Depending on how the sensor is wired, > - it shall be <0x10> or <0x1a>; > -- enable-gpios: GPIO descriptor for the enable pin. > -- vdddo-supply: Chip digital IO regulator (1.8V). > -- vdda-supply: Chip analog regulator (2.7V). > -- vddd-supply: Chip digital core regulator (1.12V). > -- clocks: Reference to the xclk clock. > -- clock-frequency: Frequency of the xclk clock. > - > -Optional Properties: > -- flash-leds: See ../video-interfaces.txt > -- lens-focus: See ../video-interfaces.txt > - > -The imx214 device node shall contain one 'port' child node with > -an 'endpoint' subnode. For further reading on port node refer to > -Documentation/devicetree/bindings/media/video-interfaces.txt. > - > -Required Properties on endpoint: > -- data-lanes: check ../video-interfaces.txt > -- link-frequencies: check ../video-interfaces.txt > -- remote-endpoint: check ../video-interfaces.txt > - > -Example: > - > - camera-sensor@1a { > - compatible = "sony,imx214"; > - reg = <0x1a>; > - vdddo-supply = <&pm8994_lvs1>; > - vddd-supply = <&camera_vddd_1v12>; > - vdda-supply = <&pm8994_l17>; > - lens-focus = <&ad5820>; > - enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; > - clocks = <&mmcc CAMSS_MCLK0_CLK>; > - clock-frequency = <24000000>; > - port { > - imx214_ep: endpoint { > - data-lanes = <1 2 3 4>; > - link-frequencies = /bits/ 64 <480000000>; > - remote-endpoint = <&csiphy0_ep>; > - }; > - }; > - }; > diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > new file mode 100644 > index 000000000000..ddd4627214b1 > --- /dev/null > +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > @@ -0,0 +1,124 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/media/i2c/sony,imx214.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor > + > +maintainers: > + - Ricardo Ribalda <ribalda@kernel.org> > + > +description: -| > + The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with > + an active array size of 4224H x 3200V. It is programmable through an I2C > + interface. Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a > + maximum throughput of 1.2Gbps/lane. > + > +properties: > + compatible: > + const: sony,imx214 > + > + reg: > + description: -| > + I2C device address. Depends on how the sensor is wired, it shall be > + enum: > + - 0x10 > + - 0x1a > + > + clocks: > + description: Reference to the xclk clock. > + maxItems: 1 > + > + clock-frequency: > + description: Frequency of the xclk clock in Hz. > + > + enable-gpios: > + description: GPIO descriptor for the enable pin. > + maxItems: 1 > + > + vdddo-supply: > + description: Chip digital IO regulator (1.8V). > + maxItems: 1 > + > + vdda-supply: > + description: Chip analog regulator (2.7V). > + maxItems: 1 > + > + vddd-supply: > + description: Chip digital core regulator (1.12V). > + maxItems: 1 > + > + flash-leds: > + description: See ../video-interfaces.txt > + > + lens-focus: > + description: See ../video-interfaces.txt > + > + port: > + type: object > + description: | > + The device node must contain one 'port' child node for its digital output > + video port, in accordance with the video interface bindings defined in > + Documentation/devicetree/bindings/media/video-interfaces.txt. > + > + properties: > + endpoint: > + type: object > + properties: > + remote-endpoint: > + description: See ../video-interfaces.txt > + > + data-lanes: > + description: See ../video-interfaces.txt > + > + link-frequencies: > + description: See ../video-interfaces.txt > + > + required: > + - data-lanes > + - link-frequencies > + > + additionalProperties: false > + > +required: > + - compatible > + - reg > + - clocks > + - clock-frequency > + - enable-gpios > + - vdddo-supply > + - vdda-supply > + - vddd-supply > + - port > + > +examples: > + - | > + #include <dt-bindings/gpio/gpio.h> > + > + i2c0 { > + #address-cells = <1>; > + #size-cells = <0>; > + > + camera-sensor@1a { > + compatible = "sony,imx214"; > + reg = <0x1a>; > + vdddo-supply = <&pm8994_lvs1>; > + vddd-supply = <&camera_vddd_1v12>; > + vdda-supply = <&pm8994_l17>; > + lens-focus = <&ad5820>; > + enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; > + clocks = <&camera_clk>; > + clock-frequency = <24000000>; > + > + port { > + imx214_ep: endpoint { > + data-lanes = <1 2 3 4>; > + link-frequencies = /bits/ 64 <480000000>; > + remote-endpoint = <&csiphy0_ep>; > + }; > + }; > + }; > + }; > + > +... > diff --git a/MAINTAINERS b/MAINTAINERS > index 6c8e98238a7b..d1a6173d3b64 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -15918,7 +15918,7 @@ M: Ricardo Ribalda <ribalda@kernel.org> > L: linux-media@vger.kernel.org > S: Maintained > T: git git://linuxtv.org/media_tree.git > -F: Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > +F: Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > F: drivers/media/i2c/imx214.c > > SONY IMX219 SENSOR DRIVER > -- > 2.27.0 >
On Mon, Aug 17, 2020 at 1:15 PM Jacopo Mondi <jacopo@jmondi.org> wrote: > > Slightly better with a subject =) > > I made a formatting error, empty line between receivers list and Subject: > > Sorry about this :) Just resend so all the tooling works. My scripts barfed on it as it seems to not be in lore. Rob
Hi Jacopo, Misprint in the subject (imx274 vs imx214)? Thanks, Andrey On 17.08.2020 22:18, Jacopo Mondi wrote: > Slightly better with a subject =) > > I made a formatting error, empty line between receivers list and Subject: > > Sorry about this :) > > On Mon, Aug 17, 2020 at 06:00:37PM +0200, Jacopo Mondi wrote: >> Subject: [PATCH] dt-bindings: media: imx274: Convert to json-schema >> >> Convert the imx274 bindings document to json-schema and update >> the MAINTAINERS file accordingly. >> >> Signed-off-by: Jacopo Mondi <jacopo+renesas@jmondi.org> >> --- >> .../bindings/media/i2c/sony,imx214.txt | 53 -------- >> .../bindings/media/i2c/sony,imx214.yaml | 124 ++++++++++++++++++ >> MAINTAINERS | 2 +- >> 3 files changed, 125 insertions(+), 54 deletions(-) >> delete mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.txt >> create mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml >> >> diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt b/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt >> deleted file mode 100644 >> index f11f28a5fda4..000000000000 >> --- a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt >> +++ /dev/null >> @@ -1,53 +0,0 @@ >> -* Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor >> - >> -The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with >> -an active array size of 4224H x 3200V. It is programmable through an I2C >> -interface. >> -Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a maximum >> -throughput of 1.2Gbps/lane. >> - >> - >> -Required Properties: >> -- compatible: Shall be "sony,imx214". >> -- reg: I2C bus address of the device. Depending on how the sensor is wired, >> - it shall be <0x10> or <0x1a>; >> -- enable-gpios: GPIO descriptor for the enable pin. >> -- vdddo-supply: Chip digital IO regulator (1.8V). >> -- vdda-supply: Chip analog regulator (2.7V). >> -- vddd-supply: Chip digital core regulator (1.12V). >> -- clocks: Reference to the xclk clock. >> -- clock-frequency: Frequency of the xclk clock. >> - >> -Optional Properties: >> -- flash-leds: See ../video-interfaces.txt >> -- lens-focus: See ../video-interfaces.txt >> - >> -The imx214 device node shall contain one 'port' child node with >> -an 'endpoint' subnode. For further reading on port node refer to >> -Documentation/devicetree/bindings/media/video-interfaces.txt. >> - >> -Required Properties on endpoint: >> -- data-lanes: check ../video-interfaces.txt >> -- link-frequencies: check ../video-interfaces.txt >> -- remote-endpoint: check ../video-interfaces.txt >> - >> -Example: >> - >> - camera-sensor@1a { >> - compatible = "sony,imx214"; >> - reg = <0x1a>; >> - vdddo-supply = <&pm8994_lvs1>; >> - vddd-supply = <&camera_vddd_1v12>; >> - vdda-supply = <&pm8994_l17>; >> - lens-focus = <&ad5820>; >> - enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; >> - clocks = <&mmcc CAMSS_MCLK0_CLK>; >> - clock-frequency = <24000000>; >> - port { >> - imx214_ep: endpoint { >> - data-lanes = <1 2 3 4>; >> - link-frequencies = /bits/ 64 <480000000>; >> - remote-endpoint = <&csiphy0_ep>; >> - }; >> - }; >> - }; >> diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml >> new file mode 100644 >> index 000000000000..ddd4627214b1 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml >> @@ -0,0 +1,124 @@ >> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) >> +%YAML 1.2 >> +--- >> +$id: http://devicetree.org/schemas/media/i2c/sony,imx214.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor >> + >> +maintainers: >> + - Ricardo Ribalda <ribalda@kernel.org> >> + >> +description: -| >> + The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with >> + an active array size of 4224H x 3200V. It is programmable through an I2C >> + interface. Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a >> + maximum throughput of 1.2Gbps/lane. >> + >> +properties: >> + compatible: >> + const: sony,imx214 >> + >> + reg: >> + description: -| >> + I2C device address. Depends on how the sensor is wired, it shall be >> + enum: >> + - 0x10 >> + - 0x1a >> + >> + clocks: >> + description: Reference to the xclk clock. >> + maxItems: 1 >> + >> + clock-frequency: >> + description: Frequency of the xclk clock in Hz. >> + >> + enable-gpios: >> + description: GPIO descriptor for the enable pin. >> + maxItems: 1 >> + >> + vdddo-supply: >> + description: Chip digital IO regulator (1.8V). >> + maxItems: 1 >> + >> + vdda-supply: >> + description: Chip analog regulator (2.7V). >> + maxItems: 1 >> + >> + vddd-supply: >> + description: Chip digital core regulator (1.12V). >> + maxItems: 1 >> + >> + flash-leds: >> + description: See ../video-interfaces.txt >> + >> + lens-focus: >> + description: See ../video-interfaces.txt >> + >> + port: >> + type: object >> + description: | >> + The device node must contain one 'port' child node for its digital output >> + video port, in accordance with the video interface bindings defined in >> + Documentation/devicetree/bindings/media/video-interfaces.txt. >> + >> + properties: >> + endpoint: >> + type: object >> + properties: >> + remote-endpoint: >> + description: See ../video-interfaces.txt >> + >> + data-lanes: >> + description: See ../video-interfaces.txt >> + >> + link-frequencies: >> + description: See ../video-interfaces.txt >> + >> + required: >> + - data-lanes >> + - link-frequencies >> + >> + additionalProperties: false >> + >> +required: >> + - compatible >> + - reg >> + - clocks >> + - clock-frequency >> + - enable-gpios >> + - vdddo-supply >> + - vdda-supply >> + - vddd-supply >> + - port >> + >> +examples: >> + - | >> + #include <dt-bindings/gpio/gpio.h> >> + >> + i2c0 { >> + #address-cells = <1>; >> + #size-cells = <0>; >> + >> + camera-sensor@1a { >> + compatible = "sony,imx214"; >> + reg = <0x1a>; >> + vdddo-supply = <&pm8994_lvs1>; >> + vddd-supply = <&camera_vddd_1v12>; >> + vdda-supply = <&pm8994_l17>; >> + lens-focus = <&ad5820>; >> + enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; >> + clocks = <&camera_clk>; >> + clock-frequency = <24000000>; >> + >> + port { >> + imx214_ep: endpoint { >> + data-lanes = <1 2 3 4>; >> + link-frequencies = /bits/ 64 <480000000>; >> + remote-endpoint = <&csiphy0_ep>; >> + }; >> + }; >> + }; >> + }; >> + >> +... >> diff --git a/MAINTAINERS b/MAINTAINERS >> index 6c8e98238a7b..d1a6173d3b64 100644 >> --- a/MAINTAINERS >> +++ b/MAINTAINERS >> @@ -15918,7 +15918,7 @@ M: Ricardo Ribalda <ribalda@kernel.org> >> L: linux-media@vger.kernel.org >> S: Maintained >> T: git git://linuxtv.org/media_tree.git >> -F: Documentation/devicetree/bindings/media/i2c/sony,imx214.txt >> +F: Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml >> F: drivers/media/i2c/imx214.c >> >> SONY IMX219 SENSOR DRIVER >> -- >> 2.27.0 >>
Hi Andrey On Tue, Aug 18, 2020 at 09:43:46AM +0300, Andrey Konovalov wrote: > Hi Jacopo, > > Misprint in the subject (imx274 vs imx214)? > > Thanks, > Andrey Seems like I screwed up big times with this patch. I'll fix and resend with the right subject! Thanks j > > On 17.08.2020 22:18, Jacopo Mondi wrote: > > Slightly better with a subject =) > > > > I made a formatting error, empty line between receivers list and Subject: > > > > Sorry about this :) > > > > On Mon, Aug 17, 2020 at 06:00:37PM +0200, Jacopo Mondi wrote: > > > Subject: [PATCH] dt-bindings: media: imx274: Convert to json-schema > > > > > > Convert the imx274 bindings document to json-schema and update > > > the MAINTAINERS file accordingly. > > > > > > Signed-off-by: Jacopo Mondi <jacopo+renesas@jmondi.org> > > > --- > > > .../bindings/media/i2c/sony,imx214.txt | 53 -------- > > > .../bindings/media/i2c/sony,imx214.yaml | 124 ++++++++++++++++++ > > > MAINTAINERS | 2 +- > > > 3 files changed, 125 insertions(+), 54 deletions(-) > > > delete mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > > > create mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > > > > > > diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt b/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > > > deleted file mode 100644 > > > index f11f28a5fda4..000000000000 > > > --- a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > > > +++ /dev/null > > > @@ -1,53 +0,0 @@ > > > -* Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor > > > - > > > -The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with > > > -an active array size of 4224H x 3200V. It is programmable through an I2C > > > -interface. > > > -Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a maximum > > > -throughput of 1.2Gbps/lane. > > > - > > > - > > > -Required Properties: > > > -- compatible: Shall be "sony,imx214". > > > -- reg: I2C bus address of the device. Depending on how the sensor is wired, > > > - it shall be <0x10> or <0x1a>; > > > -- enable-gpios: GPIO descriptor for the enable pin. > > > -- vdddo-supply: Chip digital IO regulator (1.8V). > > > -- vdda-supply: Chip analog regulator (2.7V). > > > -- vddd-supply: Chip digital core regulator (1.12V). > > > -- clocks: Reference to the xclk clock. > > > -- clock-frequency: Frequency of the xclk clock. > > > - > > > -Optional Properties: > > > -- flash-leds: See ../video-interfaces.txt > > > -- lens-focus: See ../video-interfaces.txt > > > - > > > -The imx214 device node shall contain one 'port' child node with > > > -an 'endpoint' subnode. For further reading on port node refer to > > > -Documentation/devicetree/bindings/media/video-interfaces.txt. > > > - > > > -Required Properties on endpoint: > > > -- data-lanes: check ../video-interfaces.txt > > > -- link-frequencies: check ../video-interfaces.txt > > > -- remote-endpoint: check ../video-interfaces.txt > > > - > > > -Example: > > > - > > > - camera-sensor@1a { > > > - compatible = "sony,imx214"; > > > - reg = <0x1a>; > > > - vdddo-supply = <&pm8994_lvs1>; > > > - vddd-supply = <&camera_vddd_1v12>; > > > - vdda-supply = <&pm8994_l17>; > > > - lens-focus = <&ad5820>; > > > - enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; > > > - clocks = <&mmcc CAMSS_MCLK0_CLK>; > > > - clock-frequency = <24000000>; > > > - port { > > > - imx214_ep: endpoint { > > > - data-lanes = <1 2 3 4>; > > > - link-frequencies = /bits/ 64 <480000000>; > > > - remote-endpoint = <&csiphy0_ep>; > > > - }; > > > - }; > > > - }; > > > diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > > > new file mode 100644 > > > index 000000000000..ddd4627214b1 > > > --- /dev/null > > > +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > > > @@ -0,0 +1,124 @@ > > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > > +%YAML 1.2 > > > +--- > > > +$id: http://devicetree.org/schemas/media/i2c/sony,imx214.yaml# > > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > > + > > > +title: Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor > > > + > > > +maintainers: > > > + - Ricardo Ribalda <ribalda@kernel.org> > > > + > > > +description: -| > > > + The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with > > > + an active array size of 4224H x 3200V. It is programmable through an I2C > > > + interface. Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a > > > + maximum throughput of 1.2Gbps/lane. > > > + > > > +properties: > > > + compatible: > > > + const: sony,imx214 > > > + > > > + reg: > > > + description: -| > > > + I2C device address. Depends on how the sensor is wired, it shall be > > > + enum: > > > + - 0x10 > > > + - 0x1a > > > + > > > + clocks: > > > + description: Reference to the xclk clock. > > > + maxItems: 1 > > > + > > > + clock-frequency: > > > + description: Frequency of the xclk clock in Hz. > > > + > > > + enable-gpios: > > > + description: GPIO descriptor for the enable pin. > > > + maxItems: 1 > > > + > > > + vdddo-supply: > > > + description: Chip digital IO regulator (1.8V). > > > + maxItems: 1 > > > + > > > + vdda-supply: > > > + description: Chip analog regulator (2.7V). > > > + maxItems: 1 > > > + > > > + vddd-supply: > > > + description: Chip digital core regulator (1.12V). > > > + maxItems: 1 > > > + > > > + flash-leds: > > > + description: See ../video-interfaces.txt > > > + > > > + lens-focus: > > > + description: See ../video-interfaces.txt > > > + > > > + port: > > > + type: object > > > + description: | > > > + The device node must contain one 'port' child node for its digital output > > > + video port, in accordance with the video interface bindings defined in > > > + Documentation/devicetree/bindings/media/video-interfaces.txt. > > > + > > > + properties: > > > + endpoint: > > > + type: object > > > + properties: > > > + remote-endpoint: > > > + description: See ../video-interfaces.txt > > > + > > > + data-lanes: > > > + description: See ../video-interfaces.txt > > > + > > > + link-frequencies: > > > + description: See ../video-interfaces.txt > > > + > > > + required: > > > + - data-lanes > > > + - link-frequencies > > > + > > > + additionalProperties: false > > > + > > > +required: > > > + - compatible > > > + - reg > > > + - clocks > > > + - clock-frequency > > > + - enable-gpios > > > + - vdddo-supply > > > + - vdda-supply > > > + - vddd-supply > > > + - port > > > + > > > +examples: > > > + - | > > > + #include <dt-bindings/gpio/gpio.h> > > > + > > > + i2c0 { > > > + #address-cells = <1>; > > > + #size-cells = <0>; > > > + > > > + camera-sensor@1a { > > > + compatible = "sony,imx214"; > > > + reg = <0x1a>; > > > + vdddo-supply = <&pm8994_lvs1>; > > > + vddd-supply = <&camera_vddd_1v12>; > > > + vdda-supply = <&pm8994_l17>; > > > + lens-focus = <&ad5820>; > > > + enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; > > > + clocks = <&camera_clk>; > > > + clock-frequency = <24000000>; > > > + > > > + port { > > > + imx214_ep: endpoint { > > > + data-lanes = <1 2 3 4>; > > > + link-frequencies = /bits/ 64 <480000000>; > > > + remote-endpoint = <&csiphy0_ep>; > > > + }; > > > + }; > > > + }; > > > + }; > > > + > > > +... > > > diff --git a/MAINTAINERS b/MAINTAINERS > > > index 6c8e98238a7b..d1a6173d3b64 100644 > > > --- a/MAINTAINERS > > > +++ b/MAINTAINERS > > > @@ -15918,7 +15918,7 @@ M: Ricardo Ribalda <ribalda@kernel.org> > > > L: linux-media@vger.kernel.org > > > S: Maintained > > > T: git git://linuxtv.org/media_tree.git > > > -F: Documentation/devicetree/bindings/media/i2c/sony,imx214.txt > > > +F: Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml > > > F: drivers/media/i2c/imx214.c > > > > > > SONY IMX219 SENSOR DRIVER > > > -- > > > 2.27.0 > > >
diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt b/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt deleted file mode 100644 index f11f28a5fda4..000000000000 --- a/Documentation/devicetree/bindings/media/i2c/sony,imx214.txt +++ /dev/null @@ -1,53 +0,0 @@ -* Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor - -The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with -an active array size of 4224H x 3200V. It is programmable through an I2C -interface. -Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a maximum -throughput of 1.2Gbps/lane. - - -Required Properties: -- compatible: Shall be "sony,imx214". -- reg: I2C bus address of the device. Depending on how the sensor is wired, - it shall be <0x10> or <0x1a>; -- enable-gpios: GPIO descriptor for the enable pin. -- vdddo-supply: Chip digital IO regulator (1.8V). -- vdda-supply: Chip analog regulator (2.7V). -- vddd-supply: Chip digital core regulator (1.12V). -- clocks: Reference to the xclk clock. -- clock-frequency: Frequency of the xclk clock. - -Optional Properties: -- flash-leds: See ../video-interfaces.txt -- lens-focus: See ../video-interfaces.txt - -The imx214 device node shall contain one 'port' child node with -an 'endpoint' subnode. For further reading on port node refer to -Documentation/devicetree/bindings/media/video-interfaces.txt. - -Required Properties on endpoint: -- data-lanes: check ../video-interfaces.txt -- link-frequencies: check ../video-interfaces.txt -- remote-endpoint: check ../video-interfaces.txt - -Example: - - camera-sensor@1a { - compatible = "sony,imx214"; - reg = <0x1a>; - vdddo-supply = <&pm8994_lvs1>; - vddd-supply = <&camera_vddd_1v12>; - vdda-supply = <&pm8994_l17>; - lens-focus = <&ad5820>; - enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; - clocks = <&mmcc CAMSS_MCLK0_CLK>; - clock-frequency = <24000000>; - port { - imx214_ep: endpoint { - data-lanes = <1 2 3 4>; - link-frequencies = /bits/ 64 <480000000>; - remote-endpoint = <&csiphy0_ep>; - }; - }; - }; diff --git a/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml new file mode 100644 index 000000000000..ddd4627214b1 --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml @@ -0,0 +1,124 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/i2c/sony,imx214.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Sony 1/3.06-Inch 13.13Mp CMOS Digital Image Sensor + +maintainers: + - Ricardo Ribalda <ribalda@kernel.org> + +description: -| + The Sony imx214 is a 1/3.06-inch CMOS active pixel digital image sensor with + an active array size of 4224H x 3200V. It is programmable through an I2C + interface. Image data is sent through MIPI CSI-2, through 2 or 4 lanes at a + maximum throughput of 1.2Gbps/lane. + +properties: + compatible: + const: sony,imx214 + + reg: + description: -| + I2C device address. Depends on how the sensor is wired, it shall be + enum: + - 0x10 + - 0x1a + + clocks: + description: Reference to the xclk clock. + maxItems: 1 + + clock-frequency: + description: Frequency of the xclk clock in Hz. + + enable-gpios: + description: GPIO descriptor for the enable pin. + maxItems: 1 + + vdddo-supply: + description: Chip digital IO regulator (1.8V). + maxItems: 1 + + vdda-supply: + description: Chip analog regulator (2.7V). + maxItems: 1 + + vddd-supply: + description: Chip digital core regulator (1.12V). + maxItems: 1 + + flash-leds: + description: See ../video-interfaces.txt + + lens-focus: + description: See ../video-interfaces.txt + + port: + type: object + description: | + The device node must contain one 'port' child node for its digital output + video port, in accordance with the video interface bindings defined in + Documentation/devicetree/bindings/media/video-interfaces.txt. + + properties: + endpoint: + type: object + properties: + remote-endpoint: + description: See ../video-interfaces.txt + + data-lanes: + description: See ../video-interfaces.txt + + link-frequencies: + description: See ../video-interfaces.txt + + required: + - data-lanes + - link-frequencies + + additionalProperties: false + +required: + - compatible + - reg + - clocks + - clock-frequency + - enable-gpios + - vdddo-supply + - vdda-supply + - vddd-supply + - port + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + + i2c0 { + #address-cells = <1>; + #size-cells = <0>; + + camera-sensor@1a { + compatible = "sony,imx214"; + reg = <0x1a>; + vdddo-supply = <&pm8994_lvs1>; + vddd-supply = <&camera_vddd_1v12>; + vdda-supply = <&pm8994_l17>; + lens-focus = <&ad5820>; + enable-gpios = <&msmgpio 25 GPIO_ACTIVE_HIGH>; + clocks = <&camera_clk>; + clock-frequency = <24000000>; + + port { + imx214_ep: endpoint { + data-lanes = <1 2 3 4>; + link-frequencies = /bits/ 64 <480000000>; + remote-endpoint = <&csiphy0_ep>; + }; + }; + }; + }; + +... diff --git a/MAINTAINERS b/MAINTAINERS index 6c8e98238a7b..d1a6173d3b64 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -15918,7 +15918,7 @@ M: Ricardo Ribalda <ribalda@kernel.org> L: linux-media@vger.kernel.org S: Maintained T: git git://linuxtv.org/media_tree.git -F: Documentation/devicetree/bindings/media/i2c/sony,imx214.txt +F: Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml F: drivers/media/i2c/imx214.c SONY IMX219 SENSOR DRIVER
Subject: [PATCH] dt-bindings: media: imx274: Convert to json-schema Convert the imx274 bindings document to json-schema and update the MAINTAINERS file accordingly. Signed-off-by: Jacopo Mondi <jacopo+renesas@jmondi.org> --- .../bindings/media/i2c/sony,imx214.txt | 53 -------- .../bindings/media/i2c/sony,imx214.yaml | 124 ++++++++++++++++++ MAINTAINERS | 2 +- 3 files changed, 125 insertions(+), 54 deletions(-) delete mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.txt create mode 100644 Documentation/devicetree/bindings/media/i2c/sony,imx214.yaml -- 2.27.0