1* Samsung Exynos5260 Clock Controller
2
3Exynos5260 has 13 clock controllers which are instantiated
4independently from the device-tree. These clock controllers
5generate and supply clocks to various hardware blocks within
6the SoC.
7
8Each clock is assigned an identifier and client nodes can use
9this identifier to specify the clock which they consume. All
10available clocks are defined as preprocessor macros in
11dt-bindings/clock/exynos5260-clk.h header and can be used in
12device tree sources.
13
14External clocks:
15
16There are several clocks that are generated outside the SoC. It
17is expected that they are defined using standard clock bindings
18with following clock-output-names:
19
20 - "fin_pll" - PLL input clock from XXTI
21 - "xrtcxti" - input clock from XRTCXTI
22 - "ioclk_pcm_extclk" - pcm external operation clock
23 - "ioclk_spdif_extclk" - spdif external operation clock
24 - "ioclk_i2s_cdclk" - i2s0 codec clock
25
26Phy clocks:
27
28There are several clocks which are generated by specific PHYs.
29These clocks are fed into the clock controller and then routed to
30the hardware blocks. These clocks are defined as fixed clocks in the
31driver with following names:
32
33 - "phyclk_dptx_phy_ch3_txd_clk" - dp phy clock for channel 3
34 - "phyclk_dptx_phy_ch2_txd_clk" - dp phy clock for channel 2
35 - "phyclk_dptx_phy_ch1_txd_clk" - dp phy clock for channel 1
36 - "phyclk_dptx_phy_ch0_txd_clk" - dp phy clock for channel 0
37 - "phyclk_hdmi_phy_tmds_clko" - hdmi phy tmds clock
38 - "phyclk_hdmi_phy_pixel_clko" - hdmi phy pixel clock
39 - "phyclk_hdmi_link_o_tmds_clkhi" - hdmi phy for hdmi link
40 - "phyclk_dptx_phy_o_ref_clk_24m" - dp phy reference clock
41 - "phyclk_dptx_phy_clk_div2"
42 - "phyclk_mipi_dphy_4l_m_rxclkesc0"
43 - "phyclk_usbhost20_phy_phyclock" - usb 2.0 phy clock
44 - "phyclk_usbhost20_phy_freeclk"
45 - "phyclk_usbhost20_phy_clk48mohci"
46 - "phyclk_usbdrd30_udrd30_pipe_pclk"
47 - "phyclk_usbdrd30_udrd30_phyclock" - usb 3.0 phy clock
48
49Required Properties for Clock Controller:
50
51 - compatible: should be one of the following.
52	1) "samsung,exynos5260-clock-top"
53	2) "samsung,exynos5260-clock-peri"
54	3) "samsung,exynos5260-clock-egl"
55	4) "samsung,exynos5260-clock-kfc"
56	5) "samsung,exynos5260-clock-g2d"
57	6) "samsung,exynos5260-clock-mif"
58	7) "samsung,exynos5260-clock-mfc"
59	8) "samsung,exynos5260-clock-g3d"
60	9) "samsung,exynos5260-clock-fsys"
61	10) "samsung,exynos5260-clock-aud"
62	11) "samsung,exynos5260-clock-isp"
63	12) "samsung,exynos5260-clock-gscl"
64	13) "samsung,exynos5260-clock-disp"
65
66 - reg: physical base address of the controller and the length of
67	memory mapped region.
68
69 - #clock-cells: should be 1.
70
71 - clocks: list of clock identifiers which are fed as the input to
72	the given clock controller. Please refer the next section to find
73	the input clocks for a given controller.
74
75 - clock-names: list of names of clocks which are fed as the input
76	to the given clock controller.
77
78Input clocks for top clock controller:
79	- fin_pll
80	- dout_mem_pll
81	- dout_bus_pll
82	- dout_media_pll
83
84Input clocks for peri clock controller:
85	- fin_pll
86	- ioclk_pcm_extclk
87	- ioclk_i2s_cdclk
88	- ioclk_spdif_extclk
89	- phyclk_hdmi_phy_ref_cko
90	- dout_aclk_peri_66
91	- dout_sclk_peri_uart0
92	- dout_sclk_peri_uart1
93	- dout_sclk_peri_uart2
94	- dout_sclk_peri_spi0_b
95	- dout_sclk_peri_spi1_b
96	- dout_sclk_peri_spi2_b
97	- dout_aclk_peri_aud
98	- dout_sclk_peri_spi0_b
99
100Input clocks for egl clock controller:
101	- fin_pll
102	- dout_bus_pll
103
104Input clocks for kfc clock controller:
105	- fin_pll
106	- dout_media_pll
107
108Input clocks for g2d clock controller:
109	- fin_pll
110	- dout_aclk_g2d_333
111
112Input clocks for mif clock controller:
113	- fin_pll
114
115Input clocks for mfc clock controller:
116	- fin_pll
117	- dout_aclk_mfc_333
118
119Input clocks for g3d clock controller:
120	- fin_pll
121
122Input clocks for fsys clock controller:
123	- fin_pll
124	- phyclk_usbhost20_phy_phyclock
125	- phyclk_usbhost20_phy_freeclk
126	- phyclk_usbhost20_phy_clk48mohci
127	- phyclk_usbdrd30_udrd30_pipe_pclk
128	- phyclk_usbdrd30_udrd30_phyclock
129	- dout_aclk_fsys_200
130
131Input clocks for aud clock controller:
132	- fin_pll
133	- fout_aud_pll
134	- ioclk_i2s_cdclk
135	- ioclk_pcm_extclk
136
137Input clocks for isp clock controller:
138	- fin_pll
139	- dout_aclk_isp1_266
140	- dout_aclk_isp1_400
141	- mout_aclk_isp1_266
142
143Input clocks for gscl clock controller:
144	- fin_pll
145	- dout_aclk_gscl_400
146	- dout_aclk_gscl_333
147
148Input clocks for disp clock controller:
149	- fin_pll
150	- phyclk_dptx_phy_ch3_txd_clk
151	- phyclk_dptx_phy_ch2_txd_clk
152	- phyclk_dptx_phy_ch1_txd_clk
153	- phyclk_dptx_phy_ch0_txd_clk
154	- phyclk_hdmi_phy_tmds_clko
155	- phyclk_hdmi_phy_ref_clko
156	- phyclk_hdmi_phy_pixel_clko
157	- phyclk_hdmi_link_o_tmds_clkhi
158	- phyclk_mipi_dphy_4l_m_txbyte_clkhs
159	- phyclk_dptx_phy_o_ref_clk_24m
160	- phyclk_dptx_phy_clk_div2
161	- phyclk_mipi_dphy_4l_m_rxclkesc0
162	- phyclk_hdmi_phy_ref_cko
163	- ioclk_spdif_extclk
164	- dout_aclk_peri_aud
165	- dout_aclk_disp_222
166	- dout_sclk_disp_pixel
167	- dout_aclk_disp_333
168
169Example 1: An example of a clock controller node is listed below.
170
171	clock_mfc: clock-controller@11090000 {
172		compatible = "samsung,exynos5260-clock-mfc";
173		clock = <&fin_pll>, <&clock_top TOP_DOUT_ACLK_MFC_333>;
174		clock-names = "fin_pll", "dout_aclk_mfc_333";
175		reg = <0x11090000 0x10000>;
176		#clock-cells = <1>;
177	};
178
179Example 2: UART controller node that consumes the clock generated by the
180		peri clock controller. Refer to the standard clock bindings for
181		information about 'clocks' and 'clock-names' property.
182
183	serial@12C00000 {
184		compatible = "samsung,exynos4210-uart";
185		reg = <0x12C00000 0x100>;
186		interrupts = <0 146 0>;
187		clocks = <&clock_peri PERI_PCLK_UART0>, <&clock_peri PERI_SCLK_UART0>;
188		clock-names = "uart", "clk_uart_baud0";
189	};
190
191