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;
 
        uint32_t min_residency_us;
 
        uint32_t exit_latency_us;
};
 
#define Z_PM_STATE_INFO_FROM_DT_CPU(i, node_id) \
        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) \
        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),    \
        }
 
#define PM_STATE_DT_INIT(node_id) \
        DT_ENUM_IDX(node_id, power_state_name)
 
#define DT_NUM_CPU_POWER_STATES(node_id) \
        DT_PROP_LEN_OR(node_id, cpu_power_states, 0)
 
#define PM_STATE_INFO_LIST_FROM_DT_CPU(node_id)                                \
        {                                                                      \
                LISTIFY(DT_NUM_CPU_POWER_STATES(node_id),                      \
                        Z_PM_STATE_INFO_FROM_DT_CPU, (,), node_id)             \
        }
 
#define PM_STATE_LIST_FROM_DT_CPU(node_id)                                     \
        {                                                                      \
                LISTIFY(DT_NUM_CPU_POWER_STATES(node_id),                      \
                        Z_PM_STATE_FROM_DT_CPU, (,), node_id)                  \
        }
 
 
uint8_t pm_state_cpu_get_all(uint8_t cpu, const struct pm_state_info **states);
 
#ifdef __cplusplus
}
#endif
 
#endif