/* * Copyright (c) 2016 Wind River Systems, Inc. * * SPDX-License-Identifier: Apache-2.0 */ #include #include #include #include #include #include #include #include #ifdef CONFIG_TICKLESS_IDLE_THRESH #define IDLE_THRESH CONFIG_TICKLESS_IDLE_THRESH #else #define IDLE_THRESH 1 #endif #ifdef CONFIG_SYS_POWER_MANAGEMENT /* * Used to allow sys_suspend() implementation to control notification * of the event that caused exit from kernel idling after pm operations. */ unsigned char sys_pm_idle_exit_notify; #if defined(CONFIG_SYS_POWER_LOW_POWER_STATE) void __attribute__((weak)) sys_resume(void) { } #endif #if defined(CONFIG_SYS_POWER_DEEP_SLEEP) void __attribute__((weak)) sys_resume_from_deep_sleep(void) { } #endif #endif /* CONFIG_SYS_POWER_MANAGEMENT */ /** * * @brief Indicate that kernel is idling in tickless mode * * Sets the kernel data structure idle field to either a positive value or * K_FOREVER. * * @param ticks the number of ticks to idle * * @return N/A */ static void set_kernel_idle_time_in_ticks(s32_t ticks) { #ifdef CONFIG_SYS_POWER_MANAGEMENT _kernel.idle = ticks; #endif } #ifndef CONFIG_SMP static void sys_power_save_idle(void) { s32_t ticks = _get_next_timeout_expiry(); /* The documented behavior of CONFIG_TICKLESS_IDLE_THRESH is * that the system should not enter a tickless idle for * periods less than that. This seems... silly, given that it * saves no power and does not improve latency. But it's an * API we need to honor... */ #ifdef CONFIG_SYS_CLOCK_EXISTS z_set_timeout_expiry((ticks < IDLE_THRESH) ? 1 : ticks, true); #endif set_kernel_idle_time_in_ticks(ticks); #if (defined(CONFIG_SYS_POWER_LOW_POWER_STATE) || \ defined(CONFIG_SYS_POWER_DEEP_SLEEP)) sys_pm_idle_exit_notify = 1U; /* * Call the suspend hook function of the soc interface to allow * entry into a low power state. The function returns * SYS_PM_NOT_HANDLED if low power state was not entered, in which * case, kernel does normal idle processing. * * This function is entered with interrupts disabled. If a low power * state was entered, then the hook function should enable inerrupts * before exiting. This is because the kernel does not do its own idle * processing in those cases i.e. skips k_cpu_idle(). The kernel's * idle processing re-enables interrupts which is essential for * the kernel's scheduling logic. */ if (sys_suspend(ticks) == SYS_PM_NOT_HANDLED) { sys_pm_idle_exit_notify = 0U; k_cpu_idle(); } #else k_cpu_idle(); #endif } #endif void _sys_power_save_idle_exit(s32_t ticks) { #if defined(CONFIG_SYS_POWER_LOW_POWER_STATE) /* Some CPU low power states require notification at the ISR * to allow any operations that needs to be done before kernel * switches task or processes nested interrupts. This can be * disabled by calling sys_pm_idle_exit_notification_disable(). * Alternatively it can be simply ignored if not required. */ if (sys_pm_idle_exit_notify) { sys_resume(); } #endif z_clock_idle_exit(); } #if K_IDLE_PRIO < 0 #define IDLE_YIELD_IF_COOP() k_yield() #else #define IDLE_YIELD_IF_COOP() do { } while (false) #endif void idle(void *unused1, void *unused2, void *unused3) { ARG_UNUSED(unused1); ARG_UNUSED(unused2); ARG_UNUSED(unused3); #ifdef CONFIG_BOOT_TIME_MEASUREMENT /* record timestamp when idling begins */ extern u64_t __idle_time_stamp; __idle_time_stamp = (u64_t)k_cycle_get_32(); #endif #ifdef CONFIG_SMP /* Simplified idle for SMP CPUs pending driver support. The * busy waiting is needed to prevent lock contention. Long * term we need to wake up idle CPUs with an IPI. */ while (true) { k_busy_wait(100); k_yield(); } #else for (;;) { (void)irq_lock(); sys_power_save_idle(); IDLE_YIELD_IF_COOP(); } #endif }