dt-bindings: media: Convert video-mux to DT schema

Video Multiplexer

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

Video multiplexers allow to select between multiple input ports. Video received

on the active input port is passed through to the output port. Muxes described

by this binding are controlled by a multiplexer controller that is described by

the bindings in Documentation/devicetree/bindings/mux/mux-controller.txt

Required properties:

- compatible : should be "video-mux"

- mux-controls : mux controller node to use for operating the mux

- #address-cells: should be <1>

- #size-cells: should be <0>

- port@*: at least three port nodes containing endpoints connecting to the

  source and sink devices according to of_graph bindings. The last port is

  the output port, all others are inputs.

Optionally, #address-cells, #size-cells, and port nodes can be grouped under a

ports node as described in Documentation/devicetree/bindings/graph.txt.

Example:

	mux: mux-controller {

		compatible = "gpio-mux";

		#mux-control-cells = <0>;

		mux-gpios = <&gpio1 15 GPIO_ACTIVE_HIGH>;

	};

	video-mux {

		compatible = "video-mux";

		mux-controls = <&mux>;

		#address-cells = <1>;

		#size-cells = <0>;

		port@0 {

			reg = <0>;

			mux_in0: endpoint {

				remote-endpoint = <&video_source0_out>;

			};

		};

		port@1 {

			reg = <1>;

			mux_in1: endpoint {

				remote-endpoint = <&video_source1_out>;

			};

		};

		port@2 {

			reg = <2>;

			mux_out: endpoint {

				remote-endpoint = <&capture_interface_in>;

			};

		};

	};

};

# SPDX-License-Identifier: GPL-2.0

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/video-mux.yaml#

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

title: Video Multiplexer

maintainers:

  - Sakari Ailus <sakari.ailus@linux.intel.com>

  - Laurent Pinchart <laurent.pinchart@ideasonboard.com>

description:

  Video multiplexers allow to select between multiple input ports. Video

  received on the active input port is passed through to the output port. Muxes

  described by this binding are controlled by a multiplexer controller.

properties:

  compatible:

    const: video-mux

  mux-controls:

    maxItems: 1

  '#address-cells':

    const: 1

  '#size-cells':

    const: 0

  ports:

    $ref: /schemas/graph.yaml#/properties/ports

    patternProperties:

      '^port@':

        $ref: /schemas/graph.yaml#/properties/port

    required:

      - port@0

      - port@1

      - port@2

patternProperties:

  '^port@':

    $ref: /schemas/graph.yaml#/properties/port

    description:

      At least three port nodes containing endpoints connecting to the source

      and sink devices according to of_graph bindings. The last port is the

      output port, all others are inputs.

required:

  - compatible

  - mux-controls

oneOf:

  - required:

      - ports

  - required:

      - port@0

      - port@1

      - port@2

additionalProperties: false

examples:

  - |

    #include <dt-bindings/gpio/gpio.h>

    mux: mux-controller {

        compatible = "gpio-mux";

        #mux-control-cells = <0>;

        mux-gpios = <&gpio1 15 GPIO_ACTIVE_HIGH>;

    };

    video-mux {

        compatible = "video-mux";

        mux-controls = <&mux>;

        #address-cells = <1>;

        #size-cells = <0>;

        port@0 {

            reg = <0>;

            mux_in0: endpoint {

                remote-endpoint = <&video_source0_out>;

            };

        };

        port@1 {

            reg = <1>;

            mux_in1: endpoint {

                remote-endpoint = <&video_source1_out>;

            };

        };

        port@2 {

            reg = <2>;

            mux_out: endpoint {

                remote-endpoint = <&capture_interface_in>;

            };

        };

    };

...