GNU Linux-libre 4.19.304-gnu1
[releases.git] / Documentation / devicetree / bindings / display / exynos / exynos_dsim.txt
1 Exynos MIPI DSI Master
2
3 Required properties:
4   - compatible: value should be one of the following
5                 "samsung,exynos3250-mipi-dsi" /* for Exynos3250/3472 SoCs */
6                 "samsung,exynos4210-mipi-dsi" /* for Exynos4 SoCs */
7                 "samsung,exynos5410-mipi-dsi" /* for Exynos5410/5420/5440 SoCs */
8                 "samsung,exynos5422-mipi-dsi" /* for Exynos5422/5800 SoCs */
9                 "samsung,exynos5433-mipi-dsi" /* for Exynos5433 SoCs */
10   - reg: physical base address and length of the registers set for the device
11   - interrupts: should contain DSI interrupt
12   - clocks: list of clock specifiers, must contain an entry for each required
13     entry in clock-names
14   - clock-names: should include "bus_clk"and "sclk_mipi" entries
15                  the use of "pll_clk" is deprecated
16   - phys: list of phy specifiers, must contain an entry for each required
17     entry in phy-names
18   - phy-names: should include "dsim" entry
19   - vddcore-supply: MIPI DSIM Core voltage supply (e.g. 1.1V)
20   - vddio-supply: MIPI DSIM I/O and PLL voltage supply (e.g. 1.8V)
21   - samsung,pll-clock-frequency: specifies frequency of the oscillator clock
22   - #address-cells, #size-cells: should be set respectively to <1> and <0>
23     according to DSI host bindings (see MIPI DSI bindings [1])
24
25 Optional properties:
26   - power-domains: a phandle to DSIM power domain node
27
28 Child nodes:
29   Should contain DSI peripheral nodes (see MIPI DSI bindings [1]).
30
31 Video interfaces:
32   Device node can contain video interface port nodes according to [2].
33   The following are properties specific to those nodes:
34
35   port node inbound:
36     - reg: (required) must be 0.
37   port node outbound:
38     - reg: (required) must be 1.
39
40   endpoint node connected from mic node (reg = 0):
41     - remote-endpoint: specifies the endpoint in mic node. This node is required
42                        for Exynos5433 mipi dsi. So mic can access to panel node
43                        throughout this dsi node.
44   endpoint node connected to panel node (reg = 1):
45     - remote-endpoint: specifies the endpoint in panel node. This node is
46                        required in all kinds of exynos mipi dsi to represent
47                        the connection between mipi dsi and panel.
48     - samsung,burst-clock-frequency: specifies DSI frequency in high-speed burst
49       mode
50     - samsung,esc-clock-frequency: specifies DSI frequency in escape mode
51
52 [1]: Documentation/devicetree/bindings/display/mipi-dsi-bus.txt
53 [2]: Documentation/devicetree/bindings/media/video-interfaces.txt
54
55 Example:
56
57         dsi@11c80000 {
58                 compatible = "samsung,exynos4210-mipi-dsi";
59                 reg = <0x11C80000 0x10000>;
60                 interrupts = <0 79 0>;
61                 clocks = <&clock 286>, <&clock 143>;
62                 clock-names = "bus_clk", "sclk_mipi";
63                 phys = <&mipi_phy 1>;
64                 phy-names = "dsim";
65                 vddcore-supply = <&vusb_reg>;
66                 vddio-supply = <&vmipi_reg>;
67                 power-domains = <&pd_lcd0>;
68                 #address-cells = <1>;
69                 #size-cells = <0>;
70                 samsung,pll-clock-frequency = <24000000>;
71
72                 panel@1 {
73                         reg = <0>;
74                         ...
75                         port {
76                                 panel_ep: endpoint {
77                                         remote-endpoint = <&dsi_ep>;
78                                 };
79                         };
80                 };
81
82                 ports {
83                         #address-cells = <1>;
84                         #size-cells = <0>;
85
86                         port@0 {
87                                 reg = <0>;
88                                 decon_to_mic: endpoint {
89                                         remote-endpoint = <&mic_to_decon>;
90                                 };
91                         };
92
93                         port@1 {
94                                 reg = <1>;
95                                 dsi_ep: endpoint {
96                                         reg = <0>;
97                                         samsung,burst-clock-frequency = <500000000>;
98                                         samsung,esc-clock-frequency = <20000000>;
99                                         remote-endpoint = <&panel_ep>;
100                                 };
101                         };
102                 };
103         };