Renesas RCar Video Input driver (rcar_vin)
------------------------------------------

The rcar_vin device provides video input capabilities for the Renesas R-Car
family of devices.

On Gen2 the current blocks are always slaves and support one input channel
which can be either RGB, YUYV or BT656. On Gen3 the current blocks are
always slaves and support multiple input channels which can be either RGB,
YUVU, BT656 or CSI-2.

 - compatible: Must be one or more of the following
   - "renesas,vin-r8a7796" for the R8A7796 device
   - "renesas,vin-r8a7795" for the R8A7795 device
   - "renesas,vin-r8a7794" for the R8A7794 device
   - "renesas,vin-r8a7793" for the R8A7793 device
   - "renesas,vin-r8a7792" for the R8A7792 device
   - "renesas,vin-r8a7791" for the R8A7791 device
   - "renesas,vin-r8a7790" for the R8A7790 device
   - "renesas,vin-r8a7779" for the R8A7779 device
   - "renesas,vin-r8a7778" for the R8A7778 device
   - "renesas,rcar-gen2-vin" for a generic R-Car Gen2 compatible device.
   - "renesas,rcar-gen3-vin" for a generic R-Car Gen3 compatible device.

   When compatible with the generic version nodes must list the
   SoC-specific version corresponding to the platform first
   followed by the generic version.

 - reg: the register base and size for the device registers
 - interrupts: the interrupt for the device
 - clocks: Reference to the parent clock

Additionally, an alias named vinX will need to be created to specify
which video input device this is.

The per-board settings Gen2:
 - port sub-node describing a single endpoint connected to the vin
   as described in video-interfaces.txt[1]. Only the first one will
   be considered as each vin interface has one input port.

   These settings are used to work out video input format and widths
   into the system.

The per-board settings Gen3:

- ports
        - port@0 - Digital video source (same as port node on Gen2)
        - port@1 - CSI-2 video sources
                -reg 0 - sub-node describing the endpoint which is CSI20
                -reg 1 - sub-node describing the endpoint which is CSI21
                -reg 2 - sub-node describing the endpoint which is CSI40
                -reg 3 - sub-node describing the endpoint which is CSI41

Device node example Gen2
------------------------

        aliases {
                vin0 = &vin0;
        };

        vin0: vin@0xe6ef0000 {
                compatible = "renesas,vin-r8a7790", "renesas,rcar-gen2-vin";
                clocks = <&mstp8_clks R8A7790_CLK_VIN0>;
                reg = <0 0xe6ef0000 0 0x1000>;
                interrupts = <0 188 IRQ_TYPE_LEVEL_HIGH>;
                status = "disabled";
        };

Board setup example Gen2 (vin1 composite video input)
-----------------------------------------------------

&i2c2   {
        status = "ok";
        pinctrl-0 = <&i2c2_pins>;
        pinctrl-names = "default";

        adv7180@20 {
                compatible = "adi,adv7180";
                reg = <0x20>;
                remote = <&vin1>;

                port {
                        adv7180: endpoint {
                                bus-width = <8>;
                                remote-endpoint = <&vin1ep0>;
                        };
                };
        };
};

/* composite video input */
&vin1 {
        pinctrl-0 = <&vin1_pins>;
        pinctrl-names = "default";

        status = "ok";

        port {
                #address-cells = <1>;
                #size-cells = <0>;

                vin1ep0: endpoint {
                        remote-endpoint = <&adv7180>;
                        bus-width = <8>;
                };
        };
};

Device node example Gen3
------------------------

        aliases {
                vin0 = &vin0;
        };

        vin1: video@e6ef1000 {
                compatible = "renesas,vin-r8a7796";
                reg =  <0 0xe6ef1000 0 0x1000>;
                interrupts = <0 189 IRQ_TYPE_LEVEL_HIGH>;
                clocks = <&cpg CPG_MOD 810>;
		power-domains = <&sysc R8A7796_PD_ALWAYS_ON>;
                status = "disabled";

                ports {
                        #address-cells = <1>;
                        #size-cells = <0>;

                        port@1 {
                                #address-cells = <1>;
                                #size-cells = <0>;

                                reg = <1>;

                                vin1csi20: endpoint@0 {
                                        reg = <0>;
                                        remote-endpoint= <&csi20vin1>;
                                };
                        };
                };
        };

        csi20: csi2@fea80000 {
                compatible = "renesas,r8a7796-csi2";
                reg = <0 0xfea80000 0 0x10000>;
                interrupts = <0 184 IRQ_TYPE_LEVEL_HIGH>;
                clocks = <&cpg CPG_MOD 714>;
		power-domains = <&sysc R8A7796_PD_ALWAYS_ON>;
                status = "disabled";

                ports {
                        #address-cells = <1>;
                        #size-cells = <0>;

                        port@1 {
                                #address-cells = <1>;
                                #size-cells = <0>;

                                reg = <1>;

                                csi20vin1: endpoint@1 {
                                        reg = <1>;
                                        remote-endpoint = <&vin1csi20>;
                                };
                        };
                };
        };


Board setup example Gen3 (CSI-2)
--------------------------------

        &vin0 {
                status = "okay";
        };

        csi20 {
                status = "okay";

                ports {
                        #address-cells = <1>;
                        #size-cells = <0>;

                        port@0 {
                                reg = <0>;
                                csi20_in: endpoint@0 {
                                        clock-lanes = <0>;
                                        data-lanes = <1>;
                                        remote-endpoint = <&adv7482_txb>;
                                };
                        };
                };
        };

[1] video-interfaces.txt common video media interface
