Commit f2230d13 authored by Rob Herring's avatar Rob Herring
Browse files

dt-bindings: display: Convert connectors to DT schema



Convert the analog TV, DVI, HDMI, and VGA connector bindings to DT schema
format.

Reviewed-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: default avatarMaxime Ripard <mripard@kernel.org>
Reviewed-by: default avatarSam Ravnborg <sam@ravnborg.org>
Acked-by: default avatarSam Ravnborg <sam@ravnborg.org>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20200630200216.1172566-1-robh@kernel.org
parent a1643473
Loading
Loading
Loading
Loading
+0 −31
Original line number Diff line number Diff line
Analog TV Connector
===================

Required properties:
- compatible: "composite-video-connector" or "svideo-connector"

Optional properties:
- label: a symbolic name for the connector
- sdtv-standards: limit the supported TV standards on a connector to the given
                  ones. If not specified all TV standards are allowed.
                  Possible TV standards are defined in
                  include/dt-bindings/display/sdtv-standards.h.

Required nodes:
- Video port for TV input

Example
-------
#include <dt-bindings/display/sdtv-standards.h>

tv: connector {
	compatible = "composite-video-connector";
	label = "tv";
	sdtv-standards = <(SDTV_STD_PAL | SDTV_STD_NTSC)>;

	port {
		tv_connector_in: endpoint {
			remote-endpoint = <&venc_out>;
		};
	};
};
+52 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: GPL-2.0-only
%YAML 1.2
---
$id: http://devicetree.org/schemas/display/connector/analog-tv-connector.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Analog TV Connector

maintainers:
  - Laurent Pinchart <Laurent.pinchart@ideasonboard.com>

properties:
  compatible:
    enum:
      - composite-video-connector
      - svideo-connector

  label: true

  sdtv-standards:
    description:
      Limit the supported TV standards on a connector to the given ones. If
      not specified all TV standards are allowed. Possible TV standards are
      defined in include/dt-bindings/display/sdtv-standards.h.
    $ref: /schemas/types.yaml#/definitions/uint32

  port:
    description: Connection to controller providing analog TV signals

required:
  - compatible
  - port

additionalProperties: false

examples:
  - |
    #include <dt-bindings/display/sdtv-standards.h>

    connector {
        compatible = "composite-video-connector";
        label = "tv";
        sdtv-standards = <(SDTV_STD_PAL | SDTV_STD_NTSC)>;

        port {
            tv_connector_in: endpoint {
                remote-endpoint = <&venc_out>;
            };
        };
    };

...
+0 −36
Original line number Diff line number Diff line
DVI Connector
==============

Required properties:
- compatible: "dvi-connector"

Optional properties:
- label: a symbolic name for the connector
- ddc-i2c-bus: phandle to the i2c bus that is connected to DVI DDC
- analog: the connector has DVI analog pins
- digital: the connector has DVI digital pins
- dual-link: the connector has pins for DVI dual-link
- hpd-gpios: HPD GPIO number

Required nodes:
- Video port for DVI input

Note: One (or both) of 'analog' or 'digital' must be set.

Example
-------

dvi0: connector@0 {
	compatible = "dvi-connector";
	label = "dvi";

	digital;

	ddc-i2c-bus = <&i2c3>;

	port {
		dvi_connector_in: endpoint {
			remote-endpoint = <&tfp410_out>;
		};
	};
};
+70 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: GPL-2.0-only
%YAML 1.2
---
$id: http://devicetree.org/schemas/display/connector/dvi-connector.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: DVI Connector

maintainers:
  - Laurent Pinchart <Laurent.pinchart@ideasonboard.com>

properties:
  compatible:
    const: dvi-connector

  label: true

  hpd-gpios:
    description: A GPIO line connected to HPD
    maxItems: 1

  ddc-i2c-bus:
    description: phandle link to the I2C controller used for DDC EDID probing
    $ref: /schemas/types.yaml#/definitions/phandle

  analog:
    type: boolean
    description: the connector has DVI analog pins

  digital:
    type: boolean
    description: the connector has DVI digital pins

  dual-link:
    type: boolean
    description: the connector has pins for DVI dual-link

  port:
    description: Connection to controller providing DVI signals

required:
  - compatible
  - port

anyOf:
  - required:
      - analog
  - required:
      - digital

additionalProperties: false

examples:
  - |
    connector {
        compatible = "dvi-connector";
        label = "dvi";

        digital;

        ddc-i2c-bus = <&i2c3>;

        port {
            dvi_connector_in: endpoint {
                remote-endpoint = <&tfp410_out>;
            };
        };
    };

...
+0 −31
Original line number Diff line number Diff line
HDMI Connector
==============

Required properties:
- compatible: "hdmi-connector"
- type: the HDMI connector type: "a", "b", "c", "d" or "e"

Optional properties:
- label: a symbolic name for the connector
- hpd-gpios: HPD GPIO number
- ddc-i2c-bus: phandle link to the I2C controller used for DDC EDID probing
- ddc-en-gpios: signal to enable DDC bus

Required nodes:
- Video port for HDMI input

Example
-------

hdmi0: connector@1 {
	compatible = "hdmi-connector";
	label = "hdmi";

	type = "a";

	port {
		hdmi_connector_in: endpoint {
			remote-endpoint = <&tpd12s015_out>;
		};
	};
};
Loading