Commit 338de94d authored by Rui Miguel Silva's avatar Rui Miguel Silva Committed by Mauro Carvalho Chehab
Browse files

media: dt-bindings: imx7-csi: convert bindings to yaml 



Convert imx7-csi bindings documentation to yaml schema, remove the
textual bindings document and update MAINTAINERS entry.

Signed-off-by: default avatarRui Miguel Silva <rmfrfs@gmail.com>
Reviewed-by: default avatarJacopo Mondi <jacopo+renesas@jmondi.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent 57226cd8

Documentation/devicetree/bindings/media/imx7-csi.txt

deleted100644 → 0
+0 −42
Original line number Diff line number Diff line 
Freescale i.MX7 CMOS Sensor Interface

=====================================



csi node

--------



This is device node for the CMOS Sensor Interface (CSI) which enables the chip

to connect directly to external CMOS image sensors.



Required properties:



- compatible    : "fsl,imx7-csi" or "fsl,imx6ul-csi";

- reg           : base address and length of the register set for the device;

- interrupts    : should contain CSI interrupt;

- clocks        : list of clock specifiers, see

        Documentation/devicetree/bindings/clock/clock-bindings.txt for details;

- clock-names   : must contain "mclk";



The device node shall contain one 'port' child node with one child 'endpoint'

node, according to the bindings defined in:

Documentation/devicetree/bindings/media/video-interfaces.txt.



In the following example a remote endpoint is a video multiplexer.



example:



                csi: csi@30710000 {

                        #address-cells = <1>;

                        #size-cells = <0>;



                        compatible = "fsl,imx7-csi";

                        reg = <0x30710000 0x10000>;

                        interrupts = <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>;

                        clocks = <&clks IMX7D_CSI_MCLK_ROOT_CLK>;

                        clock-names = "mclk";



                        port {

                                csi_from_csi_mux: endpoint {

                                        remote-endpoint = <&csi_mux_to_csi>;

                                };

                        };

                };

Documentation/devicetree/bindings/media/nxp,imx7-csi.yaml

0 → 100644
+71 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/nxp,imx7-csi.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: i.MX7 CMOS Sensor Interface



maintainers:

  - Rui Miguel Silva <rmfrfs@gmail.com>



description: |

  This is device node for the CMOS Sensor Interface (CSI) which enables the

  chip to connect directly to external CMOS image sensors.



properties:

  compatible:

    enum:

      - fsl,imx7-csi

      - fsl,imx6ul-csi



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    maxItems: 1



  clock-names:

    items:

      - const: mclk



  port:

    type: object

    description:

      A node containing input port nodes with endpoint definitions as documented

      in Documentation/devicetree/bindings/media/video-interfaces.txt



required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

  - port



additionalProperties: false



examples:

  - |

    #include <dt-bindings/clock/imx7d-clock.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    #include <dt-bindings/interrupt-controller/irq.h>



    csi: csi@30710000 {

            compatible = "fsl,imx7-csi";

            reg = <0x30710000 0x10000>;

            interrupts = <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>;

            clocks = <&clks IMX7D_CSI_MCLK_ROOT_CLK>;

            clock-names = "mclk";



            port {

                    csi_from_csi_mux: endpoint {

                            remote-endpoint = <&csi_mux_to_csi>;

                    };

            };

    };



...

MAINTAINERS

+1 −1
Original line number Diff line number Diff line
@@ -10849,8 +10849,8 @@ L: linux-media@vger.kernel.org 
S:	Maintained

T:	git git://linuxtv.org/media_tree.git

F:	Documentation/admin-guide/media/imx7.rst

F:	Documentation/devicetree/bindings/media/imx7-csi.txt

F:	Documentation/devicetree/bindings/media/imx7-mipi-csi2.txt

F:	Documentation/devicetree/bindings/media/nxp,imx7-csi.yaml

F:	drivers/staging/media/imx/imx7-media-csi.c

F:	drivers/staging/media/imx/imx7-mipi-csis.c