Commit 91bd11a4 authored by Niklas Söderlund's avatar Niklas Söderlund Committed by Mauro Carvalho Chehab
Browse files

media: dt-bindings: adv748x: Convert bindings to json-schema 



Convert ADV748X analog video decoder documentation to json-schema.

While converting the bindings extend it to enforce that all port@n nodes
shall be encapsulated inside a ports node. This change does not have an
effect on drivers parsing the ports@n nodes.

Signed-off-by: default avatarNiklas Söderlund <niklas.soderlund+renesas@ragnatech.se>
Reviewed-by: default avatarGeert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: default avatarKieran Bingham <kieran.bingham+renesas@ideasonboard.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarHans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent 019b4898

Documentation/devicetree/bindings/media/i2c/adv748x.txt

deleted100644 → 0
+0 −116
Original line number Diff line number Diff line 
* Analog Devices ADV748X video decoder with HDMI receiver



The ADV7481 and ADV7482 are multi format video decoders with an integrated

HDMI receiver. They can output CSI-2 on two independent outputs TXA and TXB

from three input sources HDMI, analog and TTL.



Required Properties:



  - compatible: Must contain one of the following

    - "adi,adv7481" for the ADV7481

    - "adi,adv7482" for the ADV7482



  - reg: I2C slave addresses

    The ADV748x has up to twelve 256-byte maps that can be accessed via the

    main I2C ports. Each map has it own I2C address and acts as a standard

    slave device on the I2C bus. The main address is mandatory, others are

    optional and remain at default values if not specified.



Optional Properties:



  - interrupt-names: Should specify the interrupts as "intrq1", "intrq2" and/or

		     "intrq3". All interrupts are optional. The "intrq3" interrupt

		     is only available on the adv7481

  - interrupts: Specify the interrupt lines for the ADV748x

  - reg-names : Names of maps with programmable addresses.

		It shall contain all maps needing a non-default address.

		Possible map names are:

		  "main", "dpll", "cp", "hdmi", "edid", "repeater",

		  "infoframe", "cbus", "cec", "sdp", "txa", "txb"



The device node must contain one 'port' child node per device input and output

port, in accordance with the video interface bindings defined in

Documentation/devicetree/bindings/media/video-interfaces.txt. The port nodes

are numbered as follows.



	  Name		Type		Port

	---------------------------------------

	  AIN0		sink		0

	  AIN1		sink		1

	  AIN2		sink		2

	  AIN3		sink		3

	  AIN4		sink		4

	  AIN5		sink		5

	  AIN6		sink		6

	  AIN7		sink		7

	  HDMI		sink		8

	  TTL		sink		9

	  TXA		source		10

	  TXB		source		11



The digital output port nodes, when present, shall contain at least one

endpoint. Each of those endpoints shall contain the data-lanes property as

described in video-interfaces.txt.



Required source endpoint properties:

  - data-lanes: an array of physical data lane indexes

    The accepted value(s) for this property depends on which of the two

    sources are described. For TXA 1, 2 or 4 data lanes can be described

    while for TXB only 1 data lane is valid. See video-interfaces.txt

    for detailed description.



Ports are optional if they are not connected to anything at the hardware level.



Example:



	video-receiver@70 {

		compatible = "adi,adv7482";

		reg = <0x70 0x71 0x72 0x73 0x74 0x75

		       0x60 0x61 0x62 0x63 0x64 0x65>;

		reg-names = "main", "dpll", "cp", "hdmi", "edid", "repeater",

			    "infoframe", "cbus", "cec", "sdp", "txa", "txb";



		#address-cells = <1>;

		#size-cells = <0>;



		interrupt-parent = <&gpio6>;

		interrupt-names = "intrq1", "intrq2";

		interrupts = <30 IRQ_TYPE_LEVEL_LOW>,

			     <31 IRQ_TYPE_LEVEL_LOW>;



		port@7 {

			reg = <7>;



			adv7482_ain7: endpoint {

				remote-endpoint = <&cvbs_in>;

			};

		};



		port@8 {

			reg = <8>;



			adv7482_hdmi: endpoint {

				remote-endpoint = <&hdmi_in>;

			};

		};



		port@a {

			reg = <10>;



			adv7482_txa: endpoint {

				clock-lanes = <0>;

				data-lanes = <1 2 3 4>;

				remote-endpoint = <&csi40_in>;

			};

		};



		port@b {

			reg = <11>;



			adv7482_txb: endpoint {

				clock-lanes = <0>;

				data-lanes = <1>;

				remote-endpoint = <&csi20_in>;

			};

		};

	};

Documentation/devicetree/bindings/media/i2c/adv748x.yaml

0 → 100644
+212 −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/i2c/adv748x.yaml#

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



title: Analog Devices ADV748X video decoder with HDMI receiver



maintainers:

  - Kieran Bingham <kieran.bingham@ideasonboard.com>

  - Niklas Söderlund <niklas.soderlund@ragnatech.se>



description:

  The ADV7481 and ADV7482 are multi format video decoders with an integrated

  HDMI receiver. They can output CSI-2 on two independent outputs TXA and TXB

  from three input sources HDMI, analog and TTL.



properties:

  compatible:

    items:

      - enum:

          - adi,adv7481

          - adi,adv7482



  reg:

    minItems: 1

    maxItems: 12

    description:

      The ADV748x has up to twelve 256-byte maps that can be accessed via the

      main I2C ports. Each map has it own I2C address and acts as a standard

      slave device on the I2C bus. The main address is mandatory, others are

      optional and remain at default values if not specified.



  reg-names:

    minItems: 1

    items:

      - const: main

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]

      - enum: [ dpll, cp, hdmi, edid, repeater, infoframe, cbus, cec, sdp, txa, txb ]



  interrupts: true



  interrupt-names: true



  ports:

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



    patternProperties:

      "^port@[0-7]$":

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

        description: Input port nodes for analog inputs AIN[0-7].



    properties:

      port@8:

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

        description: Input port node for HDMI.



      port@9:

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

        description: Input port node for TTL.



      port@a:

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description:

          Output port node, single endpoint describing the CSI-2 transmitter TXA.



        properties:

          endpoint:

            $ref: /schemas/media/video-interfaces.yaml#

            unevaluatedProperties: false



            properties:

              clock-lanes:

                maxItems: 1



              data-lanes:

                minItems: 1

                maxItems: 4



            required:

              - clock-lanes

              - data-lanes



      port@b:

        $ref: /schemas/graph.yaml#/$defs/port-base

        unevaluatedProperties: false

        description:

          Output port node, single endpoint describing the CSI-2 transmitter TXB.



        properties:

          endpoint:

            $ref: /schemas/media/video-interfaces.yaml#

            unevaluatedProperties: false



            properties:

              clock-lanes:

                maxItems: 1



              data-lanes:

                maxItems: 1



            required:

              - clock-lanes

              - data-lanes



allOf:

  - if:

      properties:

        compatible:

          contains:

            const: adi,adv7481

    then:

      properties:

        interrupts:

          minItems: 1

          maxItems: 3



        interrupt-names:

          minItems: 1

          maxItems: 3

          items:

            enum: [ intrq1, intrq2, intrq3 ]

    else:

      properties:

        interrupts:

          minItems: 1

          maxItems: 2



        interrupt-names:

          minItems: 1

          maxItems: 2

          items:

            enum: [ intrq1, intrq2 ]



additionalProperties: false



required:

  - compatible

  - reg

  - ports



examples:

  - |

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



    i2c {

        #address-cells = <1>;

        #size-cells = <0>;



        video-receiver@70 {

            compatible = "adi,adv7482";

            reg = <0x70 0x71 0x72 0x73 0x74 0x75

                   0x60 0x61 0x62 0x63 0x64 0x65>;

            reg-names = "main", "dpll", "cp", "hdmi", "edid", "repeater",

                        "infoframe", "cbus", "cec", "sdp", "txa", "txb";



            interrupt-parent = <&gpio6>;

            interrupts = <30 IRQ_TYPE_LEVEL_LOW>, <31 IRQ_TYPE_LEVEL_LOW>;

            interrupt-names = "intrq1", "intrq2";



            ports {

                #address-cells = <1>;

                #size-cells = <0>;



                port@7 {

                    reg = <7>;



                    adv7482_ain7: endpoint {

                        remote-endpoint = <&cvbs_in>;

                    };

                };



                port@8 {

                    reg = <8>;



                    adv7482_hdmi: endpoint {

                        remote-endpoint = <&hdmi_in>;

                    };

                };



                port@a {

                    reg = <10>;



                    adv7482_txa: endpoint {

                        clock-lanes = <0>;

                        data-lanes = <1 2 3 4>;

                        remote-endpoint = <&csi40_in>;

                    };

                };



                port@b {

                    reg = <11>;



                    adv7482_txb: endpoint {

                        clock-lanes = <0>;

                        data-lanes = <1>;

                        remote-endpoint = <&csi20_in>;

                    };

                };

            };

        };

    };

MAINTAINERS

+1 −0
Original line number Diff line number Diff line
@@ -1139,6 +1139,7 @@ ANALOG DEVICES INC ADV748X DRIVER 
M:	Kieran Bingham <kieran.bingham@ideasonboard.com>

L:	linux-media@vger.kernel.org

S:	Maintained

F:	Documentation/devicetree/bindings/media/i2c/adv748x.yaml

F:	drivers/media/i2c/adv748x/*









ANALOG DEVICES INC ADV7511 DRIVER