state.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Intel corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_PM_STATE_H_
#define ZEPHYR_INCLUDE_PM_STATE_H_
 
#include <zephyr/sys/util.h>
#include <zephyr/devicetree.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum pm_state {
        PM_STATE_ACTIVE,
        PM_STATE_RUNTIME_IDLE,
        PM_STATE_SUSPEND_TO_IDLE,
        PM_STATE_STANDBY,
        PM_STATE_SUSPEND_TO_RAM,
        PM_STATE_SUSPEND_TO_DISK,
        PM_STATE_SOFT_OFF,
        PM_STATE_COUNT,
};
 
struct pm_state_info {
        enum pm_state state;
 
        uint8_t substate_id;
 
        bool pm_device_disabled;
 
        uint32_t min_residency_us;
 
        uint32_t exit_latency_us;
};
 
struct pm_state_constraint {
        enum pm_state state;
        uint8_t substate_id;
};
 
#define Z_DT_PHANDLE_01(node_id, prop, idx) \
        COND_CODE_1(DT_NODE_HAS_STATUS_OKAY(DT_PHANDLE_BY_IDX(node_id, prop, idx)), \
                    (1), (0))
 
#define Z_PM_STATE_INFO_FROM_DT_CPU(i, node_id)                                                   \
        COND_CODE_1(DT_NODE_HAS_STATUS_OKAY(DT_PHANDLE_BY_IDX(node_id, cpu_power_states, i)),     \
                    (PM_STATE_INFO_DT_INIT(DT_PHANDLE_BY_IDX(node_id, cpu_power_states, i)),), ())
 
#define Z_PM_STATE_FROM_DT_CPU(i, node_id)                                                        \
        COND_CODE_1(DT_NODE_HAS_STATUS_OKAY(DT_PHANDLE_BY_IDX(node_id, cpu_power_states, i)),     \
                    (PM_STATE_DT_INIT(DT_PHANDLE_BY_IDX(node_id, cpu_power_states, i)),), ())
 
#define PM_STATE_INFO_DT_INIT(node_id)                                         \
        {                                                                      \
                .state = PM_STATE_DT_INIT(node_id),                            \
                .substate_id = DT_PROP_OR(node_id, substate_id, 0),            \
                .min_residency_us = DT_PROP_OR(node_id, min_residency_us, 0),  \
                .exit_latency_us = DT_PROP_OR(node_id, exit_latency_us, 0),    \
                .pm_device_disabled = DT_PROP(node_id, zephyr_pm_device_disabled),    \
        }
 
#define PM_STATE_DT_INIT(node_id) \
        DT_ENUM_IDX(node_id, power_state_name)
 
#define DT_NUM_CPU_POWER_STATES(node_id)                                                           \
        COND_CODE_1(DT_NODE_HAS_PROP(node_id, cpu_power_states),                                   \
                    (DT_FOREACH_PROP_ELEM_SEP(node_id, cpu_power_states, Z_DT_PHANDLE_01, (+))),   \
                    (0))
 
#define PM_STATE_INFO_LIST_FROM_DT_CPU(node_id)                                \
        {                                                                      \
                LISTIFY(DT_PROP_LEN_OR(node_id, cpu_power_states, 0),          \
                        Z_PM_STATE_INFO_FROM_DT_CPU, (), node_id)              \
        }
 
#define PM_STATE_LIST_FROM_DT_CPU(node_id)                                     \
        {                                                                      \
                LISTIFY(DT_PROP_LEN_OR(node_id, cpu_power_states, 0),          \
                        Z_PM_STATE_FROM_DT_CPU, (), node_id)                   \
        }
 
 
#if defined(CONFIG_PM) || defined(__DOXYGEN__)
uint8_t pm_state_cpu_get_all(uint8_t cpu, const struct pm_state_info **states);
 
#else  /* CONFIG_PM */
 
static inline uint8_t pm_state_cpu_get_all(uint8_t cpu, const struct pm_state_info **states)
{
        ARG_UNUSED(cpu);
        ARG_UNUSED(states);
 
        return 0;
}
 
#endif /* CONFIG_PM */
 
#ifdef __cplusplus
}
#endif
 
#endif