From 76ec6ced300a213163e6dc6e9ad6bf78cb648c4d Mon Sep 17 00:00:00 2001
From: Dietmar Muscholik <dietmar.muscholik@seco.com>
Date: Thu, 27 Feb 2025 09:39:21 +0000
Subject: [PATCH] [DRIVER] Update documentation of ptn3460 driver

---
 .../display/bridge/seco-pn3460-qcom.txt       | 59 ++++++++++++++++++-
 1 file changed, 57 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/display/bridge/seco-pn3460-qcom.txt b/Documentation/devicetree/bindings/display/bridge/seco-pn3460-qcom.txt
index d47464145f3d1..0cb40bee65fec 100644
--- a/Documentation/devicetree/bindings/display/bridge/seco-pn3460-qcom.txt
+++ b/Documentation/devicetree/bindings/display/bridge/seco-pn3460-qcom.txt
@@ -14,14 +14,69 @@ Properties
 - width  = <int>: panel width
 - height  = <int>: panel height
 - data-mapping = "vesa24" | "jeida-24" | "jeida-18"
-- panel-timing: panel timing, see display-timings.yaml
+- panel-timing: panel timing,
+  see Documentation/devicetree/bindings/display/panel/display-timings.yaml
+- dual-lvds: boolean, use dul-lvds if set
+- port@0: input port for the bridge
+  see https://github.com/devicetree-org/dt-schema/blob/main/dtschema/schemas/graph.yaml
 
 If no panel-timing is defined edid-emulation selects one of the
 7 EDIDs preconfigured in the bridge.
 
+Ports are not used by the driver itself. Nevertheless the input port
+defines a dependance of devices for the purpose an endpoint can defer
+it's probe until the bridge is probed.
+
+
 Required
 --------
 - compatible
 - reg
 - reset-gpios
-- hpd-gpios
+
+
+Examples
+--------
+&i2c13 {
+	edp2lvds: ptn3460@60 {
+		compatible = "seco,ptn3460-qcom";
+		reg = <0x60>; // DEV_CFG is floating
+		powerdown-gpios = <&tlmm 46 0>;
+		reset-gpios = <&tlmm 44 0>;
+		hpd-gpios = <&stm32 3 (GPIO_PUSH_PULL | GPIO_ACTIVE_HIGH)>;
+		lvds-enable-gpios = <LCD0_VDD_EN (GPIO_PUSH_PULL | GPIO_ACTIVE_HIGH)>;
+		edid-emulation = <0>;
+		status = "disabled";
+
+		panel-timing {
+			clock-frequency = <71100000>;
+			hactive = <1280>;
+			hfront-porch = <75>;
+			hsync-len = <10>;
+			hback-porch = <75>;
+			//htotal = <1440>;
+
+			vactive = <800>;
+			vfront-porch = <10>;
+			vsync-len = <3>;
+			vback-porch = <10>;
+			//vtotal = <823>;
+
+			vsync-active = <0>;
+			hsync-active = <0>;
+			de-active = <1>;
+			pixelclk-active = <1>;
+		};
+
+		ports {
+			#address-cells = <1>;
+			#size-cells = <0>;
+			port@0 {
+				reg = <0>;
+				edp2lvds_in: endpoint {
+					remote-endpoint = <&mdss_edp0_out>;
+				};
+			};
+		};
+	};
+};
-- 
GitLab