Commit 844f5ed5 authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Rob Herring
Browse files

dt-bindings: display: bridge: parade,ps8622: convert to dtschema



Convert the Parade PS8622/PS8625 DisplayPort to LVDS Converter bindings
to DT schema.  Changes during conversion: add missing vdd12-supply, used
by Linux driver.

Signed-off-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20230221170955.62448-1-krzysztof.kozlowski@linaro.org


Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 36b3ff49
Loading
Loading
Loading
Loading
+115 −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/display/bridge/parade,ps8622.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Parade PS8622/PS8625 DisplayPort to LVDS Converter

maintainers:
  - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>

properties:
  compatible:
    enum:
      - parade,ps8622
      - parade,ps8625

  reg:
    maxItems: 1

  lane-count:
    $ref: /schemas/types.yaml#/definitions/uint32
    enum: [1, 2]
    description: Number of DP lanes to use.

  use-external-pwm:
    type: boolean
    description: Backlight will be controlled by an external PWM.

  reset-gpios:
    maxItems: 1
    description: GPIO connected to RST_ pin.

  sleep-gpios:
    maxItems: 1
    description: GPIO connected to PD_ pin.

  vdd12-supply: true

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

    properties:
      port@0:
        $ref: /schemas/graph.yaml#/properties/port
        description: Video port for LVDS output.

      port@1:
        $ref: /schemas/graph.yaml#/properties/port
        description: Video port for DisplayPort input.

    required:
      - port@0
      - port@1

required:
  - compatible
  - reg
  - reset-gpios
  - sleep-gpios
  - ports

allOf:
  - if:
      properties:
        compatible:
          const: parade,ps8622
    then:
      properties:
        lane-count:
          const: 1
    else:
      properties:
        lane-count:
          const: 2

additionalProperties: false

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>
    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        lvds-bridge@48 {
            compatible = "parade,ps8625";
            reg = <0x48>;
            sleep-gpios = <&gpx3 5 GPIO_ACTIVE_HIGH>;
            reset-gpios = <&gpy7 7 GPIO_ACTIVE_HIGH>;
            lane-count = <2>;
            use-external-pwm;

            ports {
                #address-cells = <1>;
                #size-cells = <0>;

                port@0 {
                    reg = <0>;

                    bridge_out: endpoint {
                        remote-endpoint = <&panel_in>;
                    };
                };

                port@1 {
                    reg = <1>;

                    bridge_in: endpoint {
                        remote-endpoint = <&dp_out>;
                    };
                };
            };
        };
    };
+0 −31
Original line number Diff line number Diff line
ps8622-bridge bindings

Required properties:
	- compatible: "parade,ps8622" or "parade,ps8625"
	- reg: first i2c address of the bridge
	- sleep-gpios: OF device-tree gpio specification for PD_ pin.
	- reset-gpios: OF device-tree gpio specification for RST_ pin.

Optional properties:
	- lane-count: number of DP lanes to use
	- use-external-pwm: backlight will be controlled by an external PWM
	- video interfaces: Device node can contain video interface port
			    nodes for panel according to [1].

[1]: Documentation/devicetree/bindings/media/video-interfaces.txt

Example:
	lvds-bridge@48 {
		compatible = "parade,ps8622";
		reg = <0x48>;
		sleep-gpios = <&gpc3 6 1 0 0>;
		reset-gpios = <&gpc3 1 1 0 0>;
		lane-count = <1>;
		ports {
			port@0 {
				bridge_out: endpoint {
					remote-endpoint = <&panel_in>;
				};
			};
		};
	};