2 * OMAP2+ common Clock Management (CM) IP block functions
4 * Copyright (C) 2012 Texas Instruments, Inc.
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
11 * XXX This code should eventually be moved to a CM driver.
14 #include <linux/kernel.h>
15 #include <linux/init.h>
16 #include <linux/errno.h>
17 #include <linux/bug.h>
19 #include <linux/of_address.h>
28 * cm_ll_data: function pointers to SoC-specific implementations of
31 static struct cm_ll_data null_cm_ll_data
;
32 static struct cm_ll_data
*cm_ll_data
= &null_cm_ll_data
;
34 /* cm_base: base virtual address of the CM IP block */
35 void __iomem
*cm_base
;
37 /* cm2_base: base virtual address of the CM2 IP block (OMAP44xx only) */
38 void __iomem
*cm2_base
;
40 #define CM_NO_CLOCKS 0x1
41 #define CM_SINGLE_INSTANCE 0x2
44 * omap2_set_globals_cm - set the CM/CM2 base addresses (for early use)
45 * @cm: CM base virtual address
46 * @cm2: CM2 base virtual address (if present on the booted SoC)
48 * XXX Will be replaced when the PRM/CM drivers are completed.
50 void __init
omap2_set_globals_cm(void __iomem
*cm
, void __iomem
*cm2
)
57 * cm_split_idlest_reg - split CM_IDLEST reg addr into its components
58 * @idlest_reg: CM_IDLEST* virtual address
59 * @prcm_inst: pointer to an s16 to return the PRCM instance offset
60 * @idlest_reg_id: pointer to a u8 to return the CM_IDLESTx register ID
62 * Given an absolute CM_IDLEST register address @idlest_reg, passes
63 * the PRCM instance offset and IDLEST register ID back to the caller
64 * via the @prcm_inst and @idlest_reg_id. Returns -EINVAL upon error,
65 * or 0 upon success. XXX This function is only needed until absolute
66 * register addresses are removed from the OMAP struct clk records.
68 int cm_split_idlest_reg(void __iomem
*idlest_reg
, s16
*prcm_inst
,
71 if (!cm_ll_data
->split_idlest_reg
) {
72 WARN_ONCE(1, "cm: %s: no low-level function defined\n",
77 return cm_ll_data
->split_idlest_reg(idlest_reg
, prcm_inst
,
82 * omap_cm_wait_module_ready - wait for a module to leave idle or standby
83 * @part: PRCM partition
84 * @prcm_mod: PRCM module offset
85 * @idlest_reg: CM_IDLESTx register
86 * @idlest_shift: shift of the bit in the CM_IDLEST* register to check
88 * Wait for the PRCM to indicate that the module identified by
89 * (@prcm_mod, @idlest_id, @idlest_shift) is clocked. Return 0 upon
90 * success, -EBUSY if the module doesn't enable in time, or -EINVAL if
91 * no per-SoC wait_module_ready() function pointer has been registered
92 * or if the idlest register is unknown on the SoC.
94 int omap_cm_wait_module_ready(u8 part
, s16 prcm_mod
, u16 idlest_reg
,
97 if (!cm_ll_data
->wait_module_ready
) {
98 WARN_ONCE(1, "cm: %s: no low-level function defined\n",
103 return cm_ll_data
->wait_module_ready(part
, prcm_mod
, idlest_reg
,
108 * omap_cm_wait_module_idle - wait for a module to enter idle or standby
109 * @part: PRCM partition
110 * @prcm_mod: PRCM module offset
111 * @idlest_reg: CM_IDLESTx register
112 * @idlest_shift: shift of the bit in the CM_IDLEST* register to check
114 * Wait for the PRCM to indicate that the module identified by
115 * (@prcm_mod, @idlest_id, @idlest_shift) is no longer clocked. Return
116 * 0 upon success, -EBUSY if the module doesn't enable in time, or
117 * -EINVAL if no per-SoC wait_module_idle() function pointer has been
118 * registered or if the idlest register is unknown on the SoC.
120 int omap_cm_wait_module_idle(u8 part
, s16 prcm_mod
, u16 idlest_reg
,
123 if (!cm_ll_data
->wait_module_idle
) {
124 WARN_ONCE(1, "cm: %s: no low-level function defined\n",
129 return cm_ll_data
->wait_module_idle(part
, prcm_mod
, idlest_reg
,
134 * omap_cm_module_enable - enable a module
135 * @mode: target mode for the module
136 * @part: PRCM partition
137 * @inst: PRCM instance
138 * @clkctrl_offs: CM_CLKCTRL register offset for the module
140 * Enables clocks for a module identified by (@part, @inst, @clkctrl_offs)
141 * making its IO space accessible. Return 0 upon success, -EINVAL if no
142 * per-SoC module_enable() function pointer has been registered.
144 int omap_cm_module_enable(u8 mode
, u8 part
, u16 inst
, u16 clkctrl_offs
)
146 if (!cm_ll_data
->module_enable
) {
147 WARN_ONCE(1, "cm: %s: no low-level function defined\n",
152 cm_ll_data
->module_enable(mode
, part
, inst
, clkctrl_offs
);
157 * omap_cm_module_disable - disable a module
158 * @part: PRCM partition
159 * @inst: PRCM instance
160 * @clkctrl_offs: CM_CLKCTRL register offset for the module
162 * Disables clocks for a module identified by (@part, @inst, @clkctrl_offs)
163 * makings its IO space inaccessible. Return 0 upon success, -EINVAL if
164 * no per-SoC module_disable() function pointer has been registered.
166 int omap_cm_module_disable(u8 part
, u16 inst
, u16 clkctrl_offs
)
168 if (!cm_ll_data
->module_disable
) {
169 WARN_ONCE(1, "cm: %s: no low-level function defined\n",
174 cm_ll_data
->module_disable(part
, inst
, clkctrl_offs
);
179 * cm_register - register per-SoC low-level data with the CM
180 * @cld: low-level per-SoC OMAP CM data & function pointers to register
182 * Register per-SoC low-level OMAP CM data and function pointers with
183 * the OMAP CM common interface. The caller must keep the data
184 * pointed to by @cld valid until it calls cm_unregister() and
185 * it returns successfully. Returns 0 upon success, -EINVAL if @cld
186 * is NULL, or -EEXIST if cm_register() has already been called
187 * without an intervening cm_unregister().
189 int cm_register(struct cm_ll_data
*cld
)
194 if (cm_ll_data
!= &null_cm_ll_data
)
203 * cm_unregister - unregister per-SoC low-level data & function pointers
204 * @cld: low-level per-SoC OMAP CM data & function pointers to unregister
206 * Unregister per-SoC low-level OMAP CM data and function pointers
207 * that were previously registered with cm_register(). The
208 * caller may not destroy any of the data pointed to by @cld until
209 * this function returns successfully. Returns 0 upon success, or
210 * -EINVAL if @cld is NULL or if @cld does not match the struct
211 * cm_ll_data * previously registered by cm_register().
213 int cm_unregister(struct cm_ll_data
*cld
)
215 if (!cld
|| cm_ll_data
!= cld
)
218 cm_ll_data
= &null_cm_ll_data
;
223 #if defined(CONFIG_ARCH_OMAP4) || defined(CONFIG_SOC_OMAP5) || \
224 defined(CONFIG_SOC_DRA7XX)
225 static struct omap_prcm_init_data cm_data __initdata
= {
227 .init
= omap4_cm_init
,
230 static struct omap_prcm_init_data cm2_data __initdata
= {
231 .index
= TI_CLKM_CM2
,
232 .init
= omap4_cm_init
,
236 #ifdef CONFIG_ARCH_OMAP2
237 static struct omap_prcm_init_data omap2_prcm_data __initdata
= {
239 .init
= omap2xxx_cm_init
,
240 .flags
= CM_NO_CLOCKS
| CM_SINGLE_INSTANCE
,
244 #ifdef CONFIG_ARCH_OMAP3
245 static struct omap_prcm_init_data omap3_cm_data __initdata
= {
247 .init
= omap3xxx_cm_init
,
248 .flags
= CM_SINGLE_INSTANCE
,
251 * IVA2 offset is a negative value, must offset the cm_base address
252 * by this to get it to positive side on the iomap
254 .offset
= -OMAP3430_IVA2_MOD
,
258 #if defined(CONFIG_SOC_AM33XX) || defined(CONFIG_SOC_TI81XX)
259 static struct omap_prcm_init_data am3_prcm_data __initdata
= {
261 .flags
= CM_NO_CLOCKS
| CM_SINGLE_INSTANCE
,
262 .init
= am33xx_cm_init
,
266 #ifdef CONFIG_SOC_AM43XX
267 static struct omap_prcm_init_data am4_prcm_data __initdata
= {
269 .flags
= CM_NO_CLOCKS
| CM_SINGLE_INSTANCE
,
270 .init
= omap4_cm_init
,
274 static const struct of_device_id omap_cm_dt_match_table
[] __initconst
= {
275 #ifdef CONFIG_ARCH_OMAP2
276 { .compatible
= "ti,omap2-prcm", .data
= &omap2_prcm_data
},
278 #ifdef CONFIG_ARCH_OMAP3
279 { .compatible
= "ti,omap3-cm", .data
= &omap3_cm_data
},
281 #ifdef CONFIG_ARCH_OMAP4
282 { .compatible
= "ti,omap4-cm1", .data
= &cm_data
},
283 { .compatible
= "ti,omap4-cm2", .data
= &cm2_data
},
285 #ifdef CONFIG_SOC_OMAP5
286 { .compatible
= "ti,omap5-cm-core-aon", .data
= &cm_data
},
287 { .compatible
= "ti,omap5-cm-core", .data
= &cm2_data
},
289 #ifdef CONFIG_SOC_DRA7XX
290 { .compatible
= "ti,dra7-cm-core-aon", .data
= &cm_data
},
291 { .compatible
= "ti,dra7-cm-core", .data
= &cm2_data
},
293 #ifdef CONFIG_SOC_AM33XX
294 { .compatible
= "ti,am3-prcm", .data
= &am3_prcm_data
},
296 #ifdef CONFIG_SOC_AM43XX
297 { .compatible
= "ti,am4-prcm", .data
= &am4_prcm_data
},
299 #ifdef CONFIG_SOC_TI81XX
300 { .compatible
= "ti,dm814-prcm", .data
= &am3_prcm_data
},
301 { .compatible
= "ti,dm816-prcm", .data
= &am3_prcm_data
},
307 * omap2_cm_base_init - initialize iomappings for the CM drivers
309 * Detects and initializes the iomappings for the CM driver, based
310 * on the DT data. Returns 0 in success, negative error value
313 int __init
omap2_cm_base_init(void)
315 struct device_node
*np
;
316 const struct of_device_id
*match
;
317 struct omap_prcm_init_data
*data
;
320 for_each_matching_node_and_match(np
, omap_cm_dt_match_table
, &match
) {
321 data
= (struct omap_prcm_init_data
*)match
->data
;
323 mem
= of_iomap(np
, 0);
327 if (data
->index
== TI_CLKM_CM
)
328 cm_base
= mem
+ data
->offset
;
330 if (data
->index
== TI_CLKM_CM2
)
331 cm2_base
= mem
+ data
->offset
;
337 if (data
->init
&& (data
->flags
& CM_SINGLE_INSTANCE
||
338 (cm_base
&& cm2_base
)))
346 * omap_cm_init - low level init for the CM drivers
348 * Initializes the low level clock infrastructure for CM drivers.
349 * Returns 0 in success, negative error value in failure.
351 int __init
omap_cm_init(void)
353 struct device_node
*np
;
354 const struct of_device_id
*match
;
355 const struct omap_prcm_init_data
*data
;
358 for_each_matching_node_and_match(np
, omap_cm_dt_match_table
, &match
) {
361 if (data
->flags
& CM_NO_CLOCKS
)
364 ret
= omap2_clk_provider_init(np
, data
->index
, NULL
, data
->mem
);