1 // SPDX-License-Identifier: GPL-2.0-only
3 * OMAP4 CM instance functions
5 * Copyright (C) 2009 Nokia Corporation
6 * Copyright (C) 2008-2011 Texas Instruments, Inc.
8 * Rajendra Nayak <rnayak@ti.com>
10 * This is needed since CM instances can be in the PRM, PRCM_MPU, CM1,
11 * or CM2 hardware modules. For example, the EMU_CM CM instance is in
12 * the PRM hardware module. What a mess...
15 #include <linux/kernel.h>
16 #include <linux/types.h>
17 #include <linux/errno.h>
18 #include <linux/err.h>
21 #include "clockdomain.h"
26 #include "cm-regbits-34xx.h"
29 #include "prcm_mpu44xx.h"
30 #include "prcm-common.h"
32 #define OMAP4430_IDLEST_SHIFT 16
33 #define OMAP4430_IDLEST_MASK (0x3 << 16)
34 #define OMAP4430_CLKTRCTRL_SHIFT 0
35 #define OMAP4430_CLKTRCTRL_MASK (0x3 << 0)
36 #define OMAP4430_MODULEMODE_SHIFT 0
37 #define OMAP4430_MODULEMODE_MASK (0x3 << 0)
40 * CLKCTRL_IDLEST_*: possible values for the CM_*_CLKCTRL.IDLEST bitfield:
42 * 0x0 func: Module is fully functional, including OCP
43 * 0x1 trans: Module is performing transition: wakeup, or sleep, or sleep
45 * 0x2 idle: Module is in Idle mode (only OCP part). It is functional if
46 * using separate functional clock
47 * 0x3 disabled: Module is disabled and cannot be accessed
50 #define CLKCTRL_IDLEST_FUNCTIONAL 0x0
51 #define CLKCTRL_IDLEST_INTRANSITION 0x1
52 #define CLKCTRL_IDLEST_INTERFACE_IDLE 0x2
53 #define CLKCTRL_IDLEST_DISABLED 0x3
55 static struct omap_domain_base _cm_bases
[OMAP4_MAX_PRCM_PARTITIONS
];
58 * omap_cm_base_init - Populates the cm partitions
60 * Populates the base addresses of the _cm_bases
61 * array used for read/write of cm module registers.
63 static void omap_cm_base_init(void)
65 memcpy(&_cm_bases
[OMAP4430_PRM_PARTITION
], &prm_base
, sizeof(prm_base
));
66 memcpy(&_cm_bases
[OMAP4430_CM1_PARTITION
], &cm_base
, sizeof(cm_base
));
67 memcpy(&_cm_bases
[OMAP4430_CM2_PARTITION
], &cm2_base
, sizeof(cm2_base
));
68 memcpy(&_cm_bases
[OMAP4430_PRCM_MPU_PARTITION
], &prcm_mpu_base
,
69 sizeof(prcm_mpu_base
));
72 /* Private functions */
74 static u32
omap4_cminst_read_inst_reg(u8 part
, u16 inst
, u16 idx
);
77 * _clkctrl_idlest - read a CM_*_CLKCTRL register; mask & shift IDLEST bitfield
78 * @part: PRCM partition ID that the CM_CLKCTRL register exists in
79 * @inst: CM instance register offset (*_INST macro)
80 * @clkctrl_offs: Module clock control register offset (*_CLKCTRL macro)
82 * Return the IDLEST bitfield of a CM_*_CLKCTRL register, shifted down to
85 static u32
_clkctrl_idlest(u8 part
, u16 inst
, u16 clkctrl_offs
)
87 u32 v
= omap4_cminst_read_inst_reg(part
, inst
, clkctrl_offs
);
88 v
&= OMAP4430_IDLEST_MASK
;
89 v
>>= OMAP4430_IDLEST_SHIFT
;
94 * _is_module_ready - can module registers be accessed without causing an abort?
95 * @part: PRCM partition ID that the CM_CLKCTRL register exists in
96 * @inst: CM instance register offset (*_INST macro)
97 * @clkctrl_offs: Module clock control register offset (*_CLKCTRL macro)
99 * Returns true if the module's CM_*_CLKCTRL.IDLEST bitfield is either
100 * *FUNCTIONAL or *INTERFACE_IDLE; false otherwise.
102 static bool _is_module_ready(u8 part
, u16 inst
, u16 clkctrl_offs
)
106 v
= _clkctrl_idlest(part
, inst
, clkctrl_offs
);
108 return (v
== CLKCTRL_IDLEST_FUNCTIONAL
||
109 v
== CLKCTRL_IDLEST_INTERFACE_IDLE
) ? true : false;
112 /* Read a register in a CM instance */
113 static u32
omap4_cminst_read_inst_reg(u8 part
, u16 inst
, u16 idx
)
115 BUG_ON(part
>= OMAP4_MAX_PRCM_PARTITIONS
||
116 part
== OMAP4430_INVALID_PRCM_PARTITION
||
117 !_cm_bases
[part
].va
);
118 return readl_relaxed(_cm_bases
[part
].va
+ inst
+ idx
);
121 /* Write into a register in a CM instance */
122 static void omap4_cminst_write_inst_reg(u32 val
, u8 part
, u16 inst
, u16 idx
)
124 BUG_ON(part
>= OMAP4_MAX_PRCM_PARTITIONS
||
125 part
== OMAP4430_INVALID_PRCM_PARTITION
||
126 !_cm_bases
[part
].va
);
127 writel_relaxed(val
, _cm_bases
[part
].va
+ inst
+ idx
);
130 /* Read-modify-write a register in CM1. Caller must lock */
131 static u32
omap4_cminst_rmw_inst_reg_bits(u32 mask
, u32 bits
, u8 part
, u16 inst
,
136 v
= omap4_cminst_read_inst_reg(part
, inst
, idx
);
139 omap4_cminst_write_inst_reg(v
, part
, inst
, idx
);
144 static u32
omap4_cminst_set_inst_reg_bits(u32 bits
, u8 part
, u16 inst
, s16 idx
)
146 return omap4_cminst_rmw_inst_reg_bits(bits
, bits
, part
, inst
, idx
);
149 static u32
omap4_cminst_clear_inst_reg_bits(u32 bits
, u8 part
, u16 inst
,
152 return omap4_cminst_rmw_inst_reg_bits(bits
, 0x0, part
, inst
, idx
);
155 static u32
omap4_cminst_read_inst_reg_bits(u8 part
, u16 inst
, s16 idx
, u32 mask
)
159 v
= omap4_cminst_read_inst_reg(part
, inst
, idx
);
171 * _clktrctrl_write - write @c to a CM_CLKSTCTRL.CLKTRCTRL register bitfield
172 * @c: CLKTRCTRL register bitfield (LSB = bit 0, i.e., unshifted)
173 * @part: PRCM partition ID that the CM_CLKSTCTRL register exists in
174 * @inst: CM instance register offset (*_INST macro)
175 * @cdoffs: Clockdomain register offset (*_CDOFFS macro)
177 * @c must be the unshifted value for CLKTRCTRL - i.e., this function
178 * will handle the shift itself.
180 static void _clktrctrl_write(u8 c
, u8 part
, u16 inst
, u16 cdoffs
)
184 v
= omap4_cminst_read_inst_reg(part
, inst
, cdoffs
+ OMAP4_CM_CLKSTCTRL
);
185 v
&= ~OMAP4430_CLKTRCTRL_MASK
;
186 v
|= c
<< OMAP4430_CLKTRCTRL_SHIFT
;
187 omap4_cminst_write_inst_reg(v
, part
, inst
, cdoffs
+ OMAP4_CM_CLKSTCTRL
);
191 * omap4_cminst_is_clkdm_in_hwsup - is a clockdomain in hwsup idle mode?
192 * @part: PRCM partition ID that the CM_CLKSTCTRL register exists in
193 * @inst: CM instance register offset (*_INST macro)
194 * @cdoffs: Clockdomain register offset (*_CDOFFS macro)
196 * Returns true if the clockdomain referred to by (@part, @inst, @cdoffs)
197 * is in hardware-supervised idle mode, or 0 otherwise.
199 static bool omap4_cminst_is_clkdm_in_hwsup(u8 part
, u16 inst
, u16 cdoffs
)
203 v
= omap4_cminst_read_inst_reg(part
, inst
, cdoffs
+ OMAP4_CM_CLKSTCTRL
);
204 v
&= OMAP4430_CLKTRCTRL_MASK
;
205 v
>>= OMAP4430_CLKTRCTRL_SHIFT
;
207 return (v
== OMAP34XX_CLKSTCTRL_ENABLE_AUTO
) ? true : false;
211 * omap4_cminst_clkdm_enable_hwsup - put a clockdomain in hwsup-idle mode
212 * @part: PRCM partition ID that the clockdomain registers exist in
213 * @inst: CM instance register offset (*_INST macro)
214 * @cdoffs: Clockdomain register offset (*_CDOFFS macro)
216 * Put a clockdomain referred to by (@part, @inst, @cdoffs) into
217 * hardware-supervised idle mode. No return value.
219 static void omap4_cminst_clkdm_enable_hwsup(u8 part
, u16 inst
, u16 cdoffs
)
221 _clktrctrl_write(OMAP34XX_CLKSTCTRL_ENABLE_AUTO
, part
, inst
, cdoffs
);
225 * omap4_cminst_clkdm_disable_hwsup - put a clockdomain in swsup-idle mode
226 * @part: PRCM partition ID that the clockdomain registers exist in
227 * @inst: CM instance register offset (*_INST macro)
228 * @cdoffs: Clockdomain register offset (*_CDOFFS macro)
230 * Put a clockdomain referred to by (@part, @inst, @cdoffs) into
231 * software-supervised idle mode, i.e., controlled manually by the
232 * Linux OMAP clockdomain code. No return value.
234 static void omap4_cminst_clkdm_disable_hwsup(u8 part
, u16 inst
, u16 cdoffs
)
236 _clktrctrl_write(OMAP34XX_CLKSTCTRL_DISABLE_AUTO
, part
, inst
, cdoffs
);
240 * omap4_cminst_clkdm_force_sleep - try to take a clockdomain out of idle
241 * @part: PRCM partition ID that the clockdomain registers exist in
242 * @inst: CM instance register offset (*_INST macro)
243 * @cdoffs: Clockdomain register offset (*_CDOFFS macro)
245 * Take a clockdomain referred to by (@part, @inst, @cdoffs) out of idle,
246 * waking it up. No return value.
248 static void omap4_cminst_clkdm_force_wakeup(u8 part
, u16 inst
, u16 cdoffs
)
250 _clktrctrl_write(OMAP34XX_CLKSTCTRL_FORCE_WAKEUP
, part
, inst
, cdoffs
);
257 static void omap4_cminst_clkdm_force_sleep(u8 part
, u16 inst
, u16 cdoffs
)
259 _clktrctrl_write(OMAP34XX_CLKSTCTRL_FORCE_SLEEP
, part
, inst
, cdoffs
);
263 * omap4_cminst_wait_module_ready - wait for a module to be in 'func' state
264 * @part: PRCM partition ID that the CM_CLKCTRL register exists in
265 * @inst: CM instance register offset (*_INST macro)
266 * @clkctrl_offs: Module clock control register offset (*_CLKCTRL macro)
267 * @bit_shift: bit shift for the register, ignored for OMAP4+
269 * Wait for the module IDLEST to be functional. If the idle state is in any
270 * the non functional state (trans, idle or disabled), module and thus the
271 * sysconfig cannot be accessed and will probably lead to an "imprecise
274 static int omap4_cminst_wait_module_ready(u8 part
, s16 inst
, u16 clkctrl_offs
,
279 omap_test_timeout(_is_module_ready(part
, inst
, clkctrl_offs
),
280 MAX_MODULE_READY_TIME
, i
);
282 return (i
< MAX_MODULE_READY_TIME
) ? 0 : -EBUSY
;
286 * omap4_cminst_wait_module_idle - wait for a module to be in 'disabled'
288 * @part: PRCM partition ID that the CM_CLKCTRL register exists in
289 * @inst: CM instance register offset (*_INST macro)
290 * @clkctrl_offs: Module clock control register offset (*_CLKCTRL macro)
291 * @bit_shift: Bit shift for the register, ignored for OMAP4+
293 * Wait for the module IDLEST to be disabled. Some PRCM transition,
294 * like reset assertion or parent clock de-activation must wait the
295 * module to be fully disabled.
297 static int omap4_cminst_wait_module_idle(u8 part
, s16 inst
, u16 clkctrl_offs
,
302 omap_test_timeout((_clkctrl_idlest(part
, inst
, clkctrl_offs
) ==
303 CLKCTRL_IDLEST_DISABLED
),
304 MAX_MODULE_DISABLE_TIME
, i
);
306 return (i
< MAX_MODULE_DISABLE_TIME
) ? 0 : -EBUSY
;
310 * omap4_cminst_module_enable - Enable the modulemode inside CLKCTRL
311 * @mode: Module mode (SW or HW)
312 * @part: PRCM partition ID that the CM_CLKCTRL register exists in
313 * @inst: CM instance register offset (*_INST macro)
314 * @clkctrl_offs: Module clock control register offset (*_CLKCTRL macro)
318 static void omap4_cminst_module_enable(u8 mode
, u8 part
, u16 inst
,
323 v
= omap4_cminst_read_inst_reg(part
, inst
, clkctrl_offs
);
324 v
&= ~OMAP4430_MODULEMODE_MASK
;
325 v
|= mode
<< OMAP4430_MODULEMODE_SHIFT
;
326 omap4_cminst_write_inst_reg(v
, part
, inst
, clkctrl_offs
);
330 * omap4_cminst_module_disable - Disable the module inside CLKCTRL
331 * @part: PRCM partition ID that the CM_CLKCTRL register exists in
332 * @inst: CM instance register offset (*_INST macro)
333 * @clkctrl_offs: Module clock control register offset (*_CLKCTRL macro)
337 static void omap4_cminst_module_disable(u8 part
, u16 inst
, u16 clkctrl_offs
)
341 v
= omap4_cminst_read_inst_reg(part
, inst
, clkctrl_offs
);
342 v
&= ~OMAP4430_MODULEMODE_MASK
;
343 omap4_cminst_write_inst_reg(v
, part
, inst
, clkctrl_offs
);
347 * Clockdomain low-level functions
350 static int omap4_clkdm_add_wkup_sleep_dep(struct clockdomain
*clkdm1
,
351 struct clockdomain
*clkdm2
)
353 omap4_cminst_set_inst_reg_bits((1 << clkdm2
->dep_bit
),
354 clkdm1
->prcm_partition
,
355 clkdm1
->cm_inst
, clkdm1
->clkdm_offs
+
360 static int omap4_clkdm_del_wkup_sleep_dep(struct clockdomain
*clkdm1
,
361 struct clockdomain
*clkdm2
)
363 omap4_cminst_clear_inst_reg_bits((1 << clkdm2
->dep_bit
),
364 clkdm1
->prcm_partition
,
365 clkdm1
->cm_inst
, clkdm1
->clkdm_offs
+
370 static int omap4_clkdm_read_wkup_sleep_dep(struct clockdomain
*clkdm1
,
371 struct clockdomain
*clkdm2
)
373 return omap4_cminst_read_inst_reg_bits(clkdm1
->prcm_partition
,
377 (1 << clkdm2
->dep_bit
));
380 static int omap4_clkdm_clear_all_wkup_sleep_deps(struct clockdomain
*clkdm
)
382 struct clkdm_dep
*cd
;
385 if (!clkdm
->prcm_partition
)
388 for (cd
= clkdm
->wkdep_srcs
; cd
&& cd
->clkdm_name
; cd
++) {
390 continue; /* only happens if data is erroneous */
392 mask
|= 1 << cd
->clkdm
->dep_bit
;
393 cd
->wkdep_usecount
= 0;
396 omap4_cminst_clear_inst_reg_bits(mask
, clkdm
->prcm_partition
,
397 clkdm
->cm_inst
, clkdm
->clkdm_offs
+
402 static int omap4_clkdm_sleep(struct clockdomain
*clkdm
)
404 if (clkdm
->flags
& CLKDM_CAN_HWSUP
)
405 omap4_cminst_clkdm_enable_hwsup(clkdm
->prcm_partition
,
408 else if (clkdm
->flags
& CLKDM_CAN_FORCE_SLEEP
)
409 omap4_cminst_clkdm_force_sleep(clkdm
->prcm_partition
,
418 static int omap4_clkdm_wakeup(struct clockdomain
*clkdm
)
420 omap4_cminst_clkdm_force_wakeup(clkdm
->prcm_partition
,
421 clkdm
->cm_inst
, clkdm
->clkdm_offs
);
425 static void omap4_clkdm_allow_idle(struct clockdomain
*clkdm
)
427 omap4_cminst_clkdm_enable_hwsup(clkdm
->prcm_partition
,
428 clkdm
->cm_inst
, clkdm
->clkdm_offs
);
431 static void omap4_clkdm_deny_idle(struct clockdomain
*clkdm
)
433 if (clkdm
->flags
& CLKDM_CAN_FORCE_WAKEUP
)
434 omap4_clkdm_wakeup(clkdm
);
436 omap4_cminst_clkdm_disable_hwsup(clkdm
->prcm_partition
,
441 static int omap4_clkdm_clk_enable(struct clockdomain
*clkdm
)
443 if (clkdm
->flags
& CLKDM_CAN_FORCE_WAKEUP
)
444 return omap4_clkdm_wakeup(clkdm
);
449 static int omap4_clkdm_clk_disable(struct clockdomain
*clkdm
)
453 if (!clkdm
->prcm_partition
)
457 * The CLKDM_MISSING_IDLE_REPORTING flag documentation has
458 * more details on the unpleasant problem this is working
461 if (clkdm
->flags
& CLKDM_MISSING_IDLE_REPORTING
&&
462 !(clkdm
->flags
& CLKDM_CAN_FORCE_SLEEP
)) {
463 omap4_clkdm_allow_idle(clkdm
);
467 hwsup
= omap4_cminst_is_clkdm_in_hwsup(clkdm
->prcm_partition
,
468 clkdm
->cm_inst
, clkdm
->clkdm_offs
);
470 if (!hwsup
&& (clkdm
->flags
& CLKDM_CAN_FORCE_SLEEP
))
471 omap4_clkdm_sleep(clkdm
);
476 static u32
omap4_cminst_xlate_clkctrl(u8 part
, u16 inst
, u16 offset
)
478 return _cm_bases
[part
].pa
+ inst
+ offset
;
482 * omap4_clkdm_save_context - Save the clockdomain modulemode context
483 * @clkdm: The clockdomain pointer whose context needs to be saved
485 * Save the clockdomain modulemode context.
487 static int omap4_clkdm_save_context(struct clockdomain
*clkdm
)
489 clkdm
->context
= omap4_cminst_read_inst_reg(clkdm
->prcm_partition
,
493 clkdm
->context
&= OMAP4430_MODULEMODE_MASK
;
498 * omap4_clkdm_restore_context - Restore the clockdomain modulemode context
499 * @clkdm: The clockdomain pointer whose context needs to be restored
501 * Restore the clockdomain modulemode context.
503 static int omap4_clkdm_restore_context(struct clockdomain
*clkdm
)
505 switch (clkdm
->context
) {
506 case OMAP34XX_CLKSTCTRL_DISABLE_AUTO
:
507 omap4_clkdm_deny_idle(clkdm
);
509 case OMAP34XX_CLKSTCTRL_FORCE_SLEEP
:
510 omap4_clkdm_sleep(clkdm
);
512 case OMAP34XX_CLKSTCTRL_FORCE_WAKEUP
:
513 omap4_clkdm_wakeup(clkdm
);
515 case OMAP34XX_CLKSTCTRL_ENABLE_AUTO
:
516 omap4_clkdm_allow_idle(clkdm
);
522 struct clkdm_ops omap4_clkdm_operations
= {
523 .clkdm_add_wkdep
= omap4_clkdm_add_wkup_sleep_dep
,
524 .clkdm_del_wkdep
= omap4_clkdm_del_wkup_sleep_dep
,
525 .clkdm_read_wkdep
= omap4_clkdm_read_wkup_sleep_dep
,
526 .clkdm_clear_all_wkdeps
= omap4_clkdm_clear_all_wkup_sleep_deps
,
527 .clkdm_add_sleepdep
= omap4_clkdm_add_wkup_sleep_dep
,
528 .clkdm_del_sleepdep
= omap4_clkdm_del_wkup_sleep_dep
,
529 .clkdm_read_sleepdep
= omap4_clkdm_read_wkup_sleep_dep
,
530 .clkdm_clear_all_sleepdeps
= omap4_clkdm_clear_all_wkup_sleep_deps
,
531 .clkdm_sleep
= omap4_clkdm_sleep
,
532 .clkdm_wakeup
= omap4_clkdm_wakeup
,
533 .clkdm_allow_idle
= omap4_clkdm_allow_idle
,
534 .clkdm_deny_idle
= omap4_clkdm_deny_idle
,
535 .clkdm_clk_enable
= omap4_clkdm_clk_enable
,
536 .clkdm_clk_disable
= omap4_clkdm_clk_disable
,
537 .clkdm_save_context
= omap4_clkdm_save_context
,
538 .clkdm_restore_context
= omap4_clkdm_restore_context
,
541 struct clkdm_ops am43xx_clkdm_operations
= {
542 .clkdm_sleep
= omap4_clkdm_sleep
,
543 .clkdm_wakeup
= omap4_clkdm_wakeup
,
544 .clkdm_allow_idle
= omap4_clkdm_allow_idle
,
545 .clkdm_deny_idle
= omap4_clkdm_deny_idle
,
546 .clkdm_clk_enable
= omap4_clkdm_clk_enable
,
547 .clkdm_clk_disable
= omap4_clkdm_clk_disable
,
550 static const struct cm_ll_data omap4xxx_cm_ll_data
= {
551 .wait_module_ready
= &omap4_cminst_wait_module_ready
,
552 .wait_module_idle
= &omap4_cminst_wait_module_idle
,
553 .module_enable
= &omap4_cminst_module_enable
,
554 .module_disable
= &omap4_cminst_module_disable
,
555 .xlate_clkctrl
= &omap4_cminst_xlate_clkctrl
,
558 int __init
omap4_cm_init(const struct omap_prcm_init_data
*data
)
562 return cm_register(&omap4xxx_cm_ll_data
);
565 static void __exit
omap4_cm_exit(void)
567 cm_unregister(&omap4xxx_cm_ll_data
);
569 __exitcall(omap4_cm_exit
);