dt-bindings: display: bridge: convert analogix_dp.txt to yaml
authorJohan Jonker <jbx6244@gmail.com>
Thu, 22 Dec 2022 14:26:57 +0000 (15:26 +0100)
committerHeiko Stuebner <heiko@sntech.de>
Sun, 5 Feb 2023 14:05:53 +0000 (15:05 +0100)
Convert analogix_dp.txt to yaml for use as common document.

Changed:
  Relexed requirements

Signed-off-by: Johan Jonker <jbx6244@gmail.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Heiko Stuebner <heiko@sntech.de>
Link: https://patchwork.freedesktop.org/patch/msgid/489e7bd3-fa26-885f-4104-8b0b29aa4f2b@gmail.com
Documentation/devicetree/bindings/display/bridge/analogix,dp.yaml [new file with mode: 0644]
Documentation/devicetree/bindings/display/bridge/analogix_dp.txt [deleted file]
Documentation/devicetree/bindings/display/exynos/exynos_dp.txt

diff --git a/Documentation/devicetree/bindings/display/bridge/analogix,dp.yaml b/Documentation/devicetree/bindings/display/bridge/analogix,dp.yaml
new file mode 100644 (file)
index 0000000..c9b0688
--- /dev/null
@@ -0,0 +1,63 @@
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/display/bridge/analogix,dp.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Analogix Display Port bridge
+
+maintainers:
+  - Rob Herring <robh@kernel.org>
+
+properties:
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  clocks: true
+
+  clock-names: true
+
+  phys: true
+
+  phy-names:
+    const: dp
+
+  force-hpd:
+    description:
+      Indicate driver need force hpd when hpd detect failed, this
+      is used for some eDP screen which don not have a hpd signal.
+
+  hpd-gpios:
+    description:
+      Hotplug detect GPIO.
+      Indicates which GPIO should be used for hotplug detection
+
+  ports:
+    $ref: /schemas/graph.yaml#/properties/ports
+
+    properties:
+      port@0:
+        $ref: /schemas/graph.yaml#/properties/port
+        description:
+          Input node to receive pixel data.
+
+      port@1:
+        $ref: /schemas/graph.yaml#/properties/port
+        description:
+          Port node with one endpoint connected to a dp-connector node.
+
+    required:
+      - port@0
+      - port@1
+
+required:
+  - reg
+  - interrupts
+  - clock-names
+  - clocks
+  - ports
+
+additionalProperties: true
diff --git a/Documentation/devicetree/bindings/display/bridge/analogix_dp.txt b/Documentation/devicetree/bindings/display/bridge/analogix_dp.txt
deleted file mode 100644 (file)
index 027d76c..0000000
+++ /dev/null
@@ -1,51 +0,0 @@
-Analogix Display Port bridge bindings
-
-Required properties for dp-controller:
-       -compatible:
-               platform specific such as:
-                * "samsung,exynos5-dp"
-                * "rockchip,rk3288-dp"
-                * "rockchip,rk3399-edp"
-       -reg:
-               physical base address of the controller and length
-               of memory mapped region.
-       -interrupts:
-               interrupt combiner values.
-       -clocks:
-               from common clock binding: handle to dp clock.
-       -clock-names:
-               from common clock binding: Shall be "dp".
-       -phys:
-               from general PHY binding: the phandle for the PHY device.
-       -phy-names:
-               from general PHY binding: Should be "dp".
-
-Optional properties for dp-controller:
-       -force-hpd:
-               Indicate driver need force hpd when hpd detect failed, this
-               is used for some eDP screen which don't have hpd signal.
-       -hpd-gpios:
-               Hotplug detect GPIO.
-               Indicates which GPIO should be used for hotplug detection
-       -port@[X]: SoC specific port nodes with endpoint definitions as defined
-               in Documentation/devicetree/bindings/media/video-interfaces.txt,
-               please refer to the SoC specific binding document:
-               * Documentation/devicetree/bindings/display/exynos/exynos_dp.txt
-               * Documentation/devicetree/bindings/display/rockchip/analogix_dp-rockchip.txt
-
-[1]: Documentation/devicetree/bindings/media/video-interfaces.txt
--------------------------------------------------------------------------------
-
-Example:
-
-       dp-controller {
-               compatible = "samsung,exynos5-dp";
-               reg = <0x145b0000 0x10000>;
-               interrupts = <10 3>;
-               interrupt-parent = <&combiner>;
-               clocks = <&clock 342>;
-               clock-names = "dp";
-
-               phys = <&dp_phy>;
-               phy-names = "dp";
-       };
index 9b6cba3..3a40159 100644 (file)
@@ -50,7 +50,7 @@ Optional properties for dp-controller:
                Documentation/devicetree/bindings/display/panel/display-timing.txt
 
 For the below properties, please refer to Analogix DP binding document:
- * Documentation/devicetree/bindings/display/bridge/analogix_dp.txt
+ * Documentation/devicetree/bindings/display/bridge/analogix,dp.yaml
        -phys (required)
        -phy-names (required)
        -hpd-gpios (optional)