techwell,tw9900.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/media/i2c/techwell,tw9900.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Techwell TW9900 NTSC/PAL video decoder
  8
  9maintainers:
 10  - Mehdi Djait <mehdi.djait@bootlin.com>
 11
 12description:
 13  The tw9900 is a multi-standard video decoder, supporting NTSC, PAL standards
 14  with auto-detection features.
 15
 16properties:
 17  compatible:
 18    const: techwell,tw9900
 19
 20  reg:
 21    maxItems: 1
 22
 23  vdd-supply:
 24    description: VDD power supply
 25
 26  reset-gpios:
 27    description: GPIO descriptor for the RESET input pin
 28    maxItems: 1
 29
 30  powerdown-gpios:
 31    description: GPIO descriptor for the POWERDOWN input pin
 32    maxItems: 1
 33
 34  ports:
 35    $ref: /schemas/graph.yaml#/properties/ports
 36
 37    properties:
 38      port@0:
 39        $ref: /schemas/graph.yaml#/properties/port
 40        description: Analog input port
 41
 42        properties:
 43          endpoint@0:
 44            $ref: /schemas/graph.yaml#/properties/endpoint
 45            description: CVBS over MUX0
 46
 47          endpoint@1:
 48            $ref: /schemas/graph.yaml#/properties/endpoint
 49            description: CVBS over MUX1
 50
 51          endpoint@2:
 52            $ref: /schemas/graph.yaml#/properties/endpoint
 53            description: Chroma over CIN0 and Y over MUX0
 54
 55          endpoint@3:
 56            $ref: /schemas/graph.yaml#/properties/endpoint
 57            description: Chroma over CIN0 and Y over MUX1
 58
 59        oneOf:
 60          - required:
 61              - endpoint@0
 62          - required:
 63              - endpoint@1
 64          - required:
 65              - endpoint@2
 66          - required:
 67              - endpoint@3
 68
 69      port@1:
 70        $ref: /schemas/graph.yaml#/properties/port
 71        description: Video port for the decoder output.
 72
 73    required:
 74      - port@0
 75      - port@1
 76
 77required:
 78  - compatible
 79  - ports
 80  - reg
 81  - vdd-supply
 82
 83additionalProperties: false
 84
 85examples:
 86  - |
 87    #include <dt-bindings/display/sdtv-standards.h>
 88    #include <dt-bindings/gpio/gpio.h>
 89
 90    composite_connector {
 91        compatible = "composite-video-connector";
 92        label = "tv";
 93        sdtv-standards = <(SDTV_STD_PAL | SDTV_STD_NTSC)>;
 94
 95        port {
 96            composite_to_tw9900: endpoint {
 97                remote-endpoint = <&tw9900_to_composite>;
 98            };
 99        };
100    };
101
102    i2c {
103        #address-cells = <1>;
104        #size-cells = <0>;
105
106        video-decoder@44 {
107            compatible = "techwell,tw9900";
108            reg = <0x44>;
109
110            vdd-supply = <&tw9900_supply>;
111            reset-gpios = <&gpio2 5 GPIO_ACTIVE_LOW>;
112
113            ports {
114                #address-cells = <1>;
115                #size-cells = <0>;
116
117                port@0 {
118                    #address-cells = <1>;
119                    #size-cells = <0>;
120
121                    reg = <0>;
122                    tw9900_to_composite: endpoint@0 {
123                        reg = <0>;
124                        remote-endpoint = <&composite_to_tw9900>;
125                    };
126                };
127
128                port@1 {
129                    reg = <1>;
130                    endpoint {
131                        remote-endpoint = <&cif_in>;
132                    };
133                };
134            };
135        };
136    };