xref: /freebsd/sys/contrib/device-tree/Bindings/display/exynos/exynos_dp.txt (revision 2e3507c25e42292b45a5482e116d278f5515d04d) 
1The Exynos display port interface should be configured based on
2the type of panel connected to it.
3
4We use two nodes:
5	-dp-controller node
6	-dptx-phy node(defined inside dp-controller node)
7
8For the DP-PHY initialization, we use the dptx-phy node.
9Required properties for dptx-phy: deprecated, use phys and phy-names
10	-reg: deprecated
11		Base address of DP PHY register.
12	-samsung,enable-mask: deprecated
13		The bit-mask used to enable/disable DP PHY.
14
15For the Panel initialization, we read data from dp-controller node.
16Required properties for dp-controller:
17	-compatible:
18		should be "samsung,exynos5-dp".
19	-reg:
20		physical base address of the controller and length
21		of memory mapped region.
22	-interrupts:
23		interrupt combiner values.
24	-clocks:
25		from common clock binding: handle to dp clock.
26	-clock-names:
27		from common clock binding: Shall be "dp".
28	-phys:
29		from general PHY binding: the phandle for the PHY device.
30	-phy-names:
31		from general PHY binding: Should be "dp".
32
33Optional properties for dp-controller:
34	-interlaced:
35		interlace scan mode.
36			Progressive if defined, Interlaced if not defined
37	-vsync-active-high:
38		VSYNC polarity configuration.
39			High if defined, Low if not defined
40	-hsync-active-high:
41		HSYNC polarity configuration.
42			High if defined, Low if not defined
43	-samsung,hpd-gpio:
44		Hotplug detect GPIO.
45			Indicates which GPIO should be used for hotplug
46			detection
47	-video interfaces: Device node can contain video interface port
48			nodes according to [1].
49	- display-timings: timings for the connected panel as described by
50		Documentation/devicetree/bindings/display/panel/display-timing.txt
51
52For the below properties, please refer to Analogix DP binding document:
53 * Documentation/devicetree/bindings/display/bridge/analogix,dp.yaml
54	-phys (required)
55	-phy-names (required)
56	-hpd-gpios (optional)
57	 force-hpd (optional)
58
59Deprecated properties for DisplayPort:
60-interlaced:            deprecated prop that can parsed from drm_display_mode.
61-vsync-active-high:     deprecated prop that can parsed from drm_display_mode.
62-hsync-active-high:     deprecated prop that can parsed from drm_display_mode.
63-samsung,ycbcr-coeff:   deprecated prop that can parsed from drm_display_mode.
64-samsung,dynamic-range: deprecated prop that can parsed from drm_display_mode.
65-samsung,color-space:   deprecated prop that can parsed from drm_display_info.
66-samsung,color-depth:   deprecated prop that can parsed from drm_display_info.
67-samsung,link-rate:     deprecated prop that can reading from monitor by dpcd method.
68-samsung,lane-count:    deprecated prop that can reading from monitor by dpcd method.
69-samsung,hpd-gpio:      deprecated name for hpd-gpios.
70
71-------------------------------------------------------------------------------
72
73Example:
74
75SOC specific portion:
76	dp-controller {
77		compatible = "samsung,exynos5-dp";
78		reg = <0x145b0000 0x10000>;
79		interrupts = <10 3>;
80		interrupt-parent = <&combiner>;
81		clocks = <&clock 342>;
82		clock-names = "dp";
83
84		phys = <&dp_phy>;
85		phy-names = "dp";
86	};
87
88Board Specific portion:
89	dp-controller {
90		display-timings {
91			native-mode = <&lcd_timing>;
92			lcd_timing: 1366x768 {
93				clock-frequency = <70589280>;
94				hactive = <1366>;
95				vactive = <768>;
96				hfront-porch = <40>;
97				hback-porch = <40>;
98				hsync-len = <32>;
99				vback-porch = <10>;
100				vfront-porch = <12>;
101				vsync-len = <6>;
102			};
103		};
104
105		ports {
106			port@0 {
107				dp_out: endpoint {
108					remote-endpoint = <&bridge_in>;
109				};
110			};
111		};
112	};
113