dt-bindings: display: bridge: thc63lvd1024: Convert binding to YAML

Thine Electronics THC63LVD1024 LVDS decoder

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

The THC63LVD1024 is a dual link LVDS receiver designed to convert LVDS streams

to parallel data outputs. The chip supports single/dual input/output modes,

handling up to two LVDS input streams and up to two digital CMOS/TTL outputs.

Single or dual operation mode, output data mapping and DDR output modes are

configured through input signals and the chip does not expose any control bus.

Required properties:

- compatible: Shall be "thine,thc63lvd1024"

- vcc-supply: Power supply for TTL output, TTL CLOCKOUT signal, LVDS input,

  PPL and digital circuitry

Optional properties:

- powerdown-gpios: Power down GPIO signal, pin name "/PDWN". Active low

- oe-gpios: Output enable GPIO signal, pin name "OE". Active high

The THC63LVD1024 video port connections are modeled according

to OF graph bindings specified by Documentation/devicetree/bindings/graph.txt

Required video port nodes:

- port@0: First LVDS input port

- port@2: First digital CMOS/TTL parallel output

Optional video port nodes:

- port@1: Second LVDS input port

- port@3: Second digital CMOS/TTL parallel output

The device can operate in single-link mode or dual-link mode. In single-link

mode, all pixels are received on port@0, and port@1 shall not contain any

endpoint. In dual-link mode, even-numbered pixels are received on port@0 and

odd-numbered pixels on port@1, and both port@0 and port@1 shall contain

endpoints.

Example:

--------

	thc63lvd1024: lvds-decoder {

		compatible = "thine,thc63lvd1024";

		vcc-supply = <&reg_lvds_vcc>;

		powerdown-gpios = <&gpio4 15 GPIO_ACTIVE_LOW>;

		ports {

			#address-cells = <1>;

			#size-cells = <0>;

			port@0 {

				reg = <0>;

				lvds_dec_in_0: endpoint {

					remote-endpoint = <&lvds_out>;

				};

			};

			port@2{

				reg = <2>;

				lvds_dec_out_2: endpoint {

					remote-endpoint = <&adv7511_in>;

				};

			};

		};

	};

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/bridge/thine,thc63lvd1024.yaml#

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

title: Thine Electronics THC63LVD1024 LVDS Decoder

maintainers:

  - Jacopo Mondi <jacopo+renesas@jmondi.org>

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

description: |

  The THC63LVD1024 is a dual link LVDS receiver designed to convert LVDS

  streams to parallel data outputs. The chip supports single/dual input/output

  modes, handling up to two LVDS input streams and up to two digital CMOS/TTL

  outputs.

  Single or dual operation mode, output data mapping and DDR output modes are

  configured through input signals and the chip does not expose any control

  bus.

properties:

  compatible:

    const: thine,thc63lvd1024

  ports:

    type: object

    description: |

      This device has four video ports. Their connections are modeled using the

      OF graph bindings specified in Documentation/devicetree/bindings/graph.txt.

      The device can operate in single-link mode or dual-link mode. In

      single-link mode, all pixels are received on port@0, and port@1 shall not

      contain any endpoint. In dual-link mode, even-numbered pixels are

      received on port@0 and odd-numbered pixels on port@1, and both port@0 and

      port@1 shall contain endpoints.

    properties:

      '#address-cells':

        const: 1

      '#size-cells':

        const: 0

      port@0:

        type: object

        description: First LVDS input port

      port@1:

        type: object

        description: Second LVDS input port

      port@2:

        type: object

        description: First digital CMOS/TTL parallel output

      port@3:

        type: object

        description: Second digital CMOS/TTL parallel output

    required:

      - port@0

      - port@2

    additionalProperties: false

  oe-gpios:

    maxItems: 1

    description: Output enable GPIO signal, pin name "OE", active high.

  powerdown-gpios:

    maxItems: 1

    description: Power down GPIO signal, pin name "/PDWN", active low.

  vcc-supply:

    maxItems: 1

    description:

      Power supply for the TTL output, TTL CLOCKOUT signal, LVDS input, PLL and

      digital circuitry.

required:

  - compatible

  - ports

  - vcc-supply

additionalProperties: false

examples:

  - |

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

    lvds-decoder {

        compatible = "thine,thc63lvd1024";

        vcc-supply = <&reg_lvds_vcc>;

        powerdown-gpios = <&gpio4 15 GPIO_ACTIVE_LOW>;

        ports {

            #address-cells = <1>;

            #size-cells = <0>;

            port@0 {

                reg = <0>;

                lvds_dec_in_0: endpoint {

                    remote-endpoint = <&lvds_out>;

                };

            };

            port@2 {

                reg = <2>;

                lvds_dec_out_2: endpoint {

                    remote-endpoint = <&adv7511_in>;

                };

            };

        };

    };

...