arch/arm/mach-omap2/powerdomain.c
Source file repositories/reference/linux-study-clean/arch/arm/mach-omap2/powerdomain.c
File Facts
- System
- Linux kernel
- Corpus path
arch/arm/mach-omap2/powerdomain.c- Extension
.c- Size
- 31519 bytes
- Lines
- 1186
- Domain
- Architecture Layer
- Bucket
- arch/arm
- Inferred role
- Architecture Layer: implementation source
- Status
- source implementation candidate
Why This File Exists
CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/cpu_pm.hlinux/kernel.hlinux/types.hlinux/list.hlinux/errno.hlinux/string.hlinux/spinlock.htrace/events/power.hcm2xxx_3xxx.hprcm44xx.hcm44xx.hprm2xxx_3xxx.hprm44xx.hasm/cpu.hpowerdomain.hclockdomain.hvoltage.hsoc.hpm.h
Detected Declarations
function list_for_each_entryfunction _pwrdm_registerfunction _update_logic_membank_countersfunction _pwrdm_state_switchfunction _pwrdm_pre_transition_cbfunction _pwrdm_post_transition_cbfunction omap_set_pwrdm_statefunction _pwrdm_save_clkdm_state_and_activatefunction pwrdm_register_platform_funcsfunction pwrdm_register_pwrdmsfunction cpu_notifierfunction pwrdm_register_pwrdmsfunction pwrdm_lockfunction pwrdm_unlockfunction pwrdm_for_eachfunction list_for_each_entryfunction pwrdm_add_clkdmfunction pwrdm_get_mem_bank_countfunction pwrdm_set_next_pwrstfunction pwrdm_read_next_pwrstfunction pwrdm_read_pwrstfunction pwrdm_read_prev_pwrstfunction pwrdm_set_logic_retstfunction pwrdm_set_mem_onstfunction pwrdm_set_mem_retstfunction pwrdm_read_logic_pwrstfunction pwrdm_read_prev_logic_pwrstfunction pwrdm_read_logic_retstfunction pwrdm_read_mem_pwrstfunction pwrdm_read_prev_mem_pwrstfunction pwrdm_read_mem_retstfunction pwrdm_clear_all_prev_pwrstfunction pwrdm_enable_hdwr_sarfunction pwrdm_disable_hdwr_sarfunction pwrdm_has_hdwr_sarfunction pwrdm_state_switch_nolockfunction pwrdm_state_switchfunction pwrdm_pre_transitionfunction pwrdm_post_transitionfunction pwrdm_get_valid_lp_statefunction omap_set_pwrdm_statefunction pwrdm_save_contextfunction pwrdm_restore_contextfunction pwrdms_save_contextfunction pwrdms_restore_context
Annotated Snippet
if (!strcmp(name, temp_pwrdm->name)) {
pwrdm = temp_pwrdm;
break;
}
}
return pwrdm;
}
/**
* _pwrdm_register - register a powerdomain
* @pwrdm: struct powerdomain * to register
*
* Adds a powerdomain to the internal powerdomain list. Returns
* -EINVAL if given a null pointer, -EEXIST if a powerdomain is
* already registered by the provided name, or 0 upon success.
*/
static int _pwrdm_register(struct powerdomain *pwrdm)
{
int i;
struct voltagedomain *voltdm;
if (!pwrdm || !pwrdm->name)
return -EINVAL;
if (cpu_is_omap44xx() &&
pwrdm->prcm_partition == OMAP4430_INVALID_PRCM_PARTITION) {
pr_err("powerdomain: %s: missing OMAP4 PRCM partition ID\n",
pwrdm->name);
return -EINVAL;
}
if (_pwrdm_lookup(pwrdm->name))
return -EEXIST;
if (arch_pwrdm && arch_pwrdm->pwrdm_has_voltdm)
if (!arch_pwrdm->pwrdm_has_voltdm())
goto skip_voltdm;
voltdm = voltdm_lookup(pwrdm->voltdm.name);
if (!voltdm) {
pr_err("powerdomain: %s: voltagedomain %s does not exist\n",
pwrdm->name, pwrdm->voltdm.name);
return -EINVAL;
}
pwrdm->voltdm.ptr = voltdm;
INIT_LIST_HEAD(&pwrdm->voltdm_node);
skip_voltdm:
spin_lock_init(&pwrdm->_lock);
list_add(&pwrdm->node, &pwrdm_list);
/* Initialize the powerdomain's state counter */
for (i = 0; i < PWRDM_MAX_PWRSTS; i++)
pwrdm->state_counter[i] = 0;
pwrdm->ret_logic_off_counter = 0;
for (i = 0; i < pwrdm->banks; i++)
pwrdm->ret_mem_off_counter[i] = 0;
if (arch_pwrdm && arch_pwrdm->pwrdm_wait_transition)
arch_pwrdm->pwrdm_wait_transition(pwrdm);
pwrdm->state = pwrdm_read_pwrst(pwrdm);
pwrdm->state_counter[pwrdm->state] = 1;
pr_debug("powerdomain: registered %s\n", pwrdm->name);
return 0;
}
static void _update_logic_membank_counters(struct powerdomain *pwrdm)
{
int i;
u8 prev_logic_pwrst, prev_mem_pwrst;
prev_logic_pwrst = pwrdm_read_prev_logic_pwrst(pwrdm);
if ((pwrdm->pwrsts_logic_ret == PWRSTS_OFF_RET) &&
(prev_logic_pwrst == PWRDM_POWER_OFF))
pwrdm->ret_logic_off_counter++;
for (i = 0; i < pwrdm->banks; i++) {
prev_mem_pwrst = pwrdm_read_prev_mem_pwrst(pwrdm, i);
if ((pwrdm->pwrsts_mem_ret[i] == PWRSTS_OFF_RET) &&
(prev_mem_pwrst == PWRDM_POWER_OFF))
pwrdm->ret_mem_off_counter[i]++;
}
}
static int _pwrdm_state_switch(struct powerdomain *pwrdm, int flag)
Annotation
- Immediate include surface: `linux/cpu_pm.h`, `linux/kernel.h`, `linux/types.h`, `linux/list.h`, `linux/errno.h`, `linux/string.h`, `linux/spinlock.h`, `trace/events/power.h`.
- Detected declarations: `function list_for_each_entry`, `function _pwrdm_register`, `function _update_logic_membank_counters`, `function _pwrdm_state_switch`, `function _pwrdm_pre_transition_cb`, `function _pwrdm_post_transition_cb`, `function omap_set_pwrdm_state`, `function _pwrdm_save_clkdm_state_and_activate`, `function pwrdm_register_platform_funcs`, `function pwrdm_register_pwrdms`.
- Atlas domain: Architecture Layer / arch/arm.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.