7#ifndef ZEPHYR_INCLUDE_PM_DEVICE_H_
8#define ZEPHYR_INCLUDE_PM_DEVICE_H_
35 PM_DEVICE_FLAG_TURN_ON_FAILED,
37 PM_DEVICE_FLAG_PD_CLAIMED,
42 PM_DEVICE_FLAG_WS_CAPABLE,
44 PM_DEVICE_FLAG_WS_ENABLED,
46 PM_DEVICE_FLAG_RUNTIME_ENABLED,
50 PM_DEVICE_FLAG_RUNTIME_AUTO,
52 PM_DEVICE_FLAG_ISR_SAFE,
65#define PM_DEVICE_ISR_SAFE 1
146#if defined(CONFIG_PM_DEVICE_RUNTIME) || defined(__DOXYGEN__)
150#ifdef CONFIG_PM_DEVICE_POWER_DOMAIN
152 const struct device *domain;
166#if defined(CONFIG_PM_DEVICE_RUNTIME) || defined(__DOXYGEN__)
188#if defined(CONFIG_PM_DEVICE_RUNTIME) || defined(__DOXYGEN__)
195BUILD_ASSERT(offsetof(
struct pm_device, base) == 0);
200#ifdef CONFIG_PM_DEVICE_RUNTIME
201#define Z_PM_DEVICE_RUNTIME_INIT(obj) \
202 .lock = Z_SEM_INITIALIZER(obj.lock, 1, 1), \
203 .event = Z_EVENT_INITIALIZER(obj.event),
205#define Z_PM_DEVICE_RUNTIME_INIT(obj)
208#ifdef CONFIG_PM_DEVICE_POWER_DOMAIN
209#define Z_PM_DEVICE_POWER_DOMAIN_INIT(_node_id) \
210 .domain = DEVICE_DT_GET_OR_NULL(DT_PHANDLE(_node_id, \
213#define Z_PM_DEVICE_POWER_DOMAIN_INIT(obj)
221#define Z_PM_DEVICE_FLAGS(node_id) \
223 DT_NODE_EXISTS(node_id), \
224 ((DT_PROP_OR(node_id, wakeup_source, 0) \
225 << PM_DEVICE_FLAG_WS_CAPABLE) | \
226 (DT_PROP_OR(node_id, zephyr_pm_device_runtime_auto, 0) \
227 << PM_DEVICE_FLAG_RUNTIME_AUTO) | \
228 (DT_NODE_HAS_COMPAT(node_id, power_domain) << \
229 PM_DEVICE_FLAG_PD)), \
243#define Z_PM_DEVICE_BASE_INIT(obj, node_id, pm_action_cb, _flags) \
245 .flags = ATOMIC_INIT(Z_PM_DEVICE_FLAGS(node_id) | (_flags)), \
246 .state = PM_DEVICE_STATE_ACTIVE, \
247 .action_cb = pm_action_cb, \
248 Z_PM_DEVICE_POWER_DOMAIN_INIT(node_id) \
261#define Z_PM_DEVICE_INIT(obj, node_id, pm_action_cb, isr_safe) \
263 .base = Z_PM_DEVICE_BASE_INIT(obj, node_id, pm_action_cb, \
264 isr_safe ? BIT(PM_DEVICE_FLAG_ISR_SAFE) : 0), \
265 COND_CODE_1(isr_safe, (), (Z_PM_DEVICE_RUNTIME_INIT(obj))) \
273#define Z_PM_DEVICE_NAME(dev_id) _CONCAT(__pm_device_, dev_id)
287#define Z_PM_DEVICE_DEFINE_SLOT(dev_id) \
288 static STRUCT_SECTION_ITERABLE_ALTERNATE(pm_device_slots, device, \
289 _CONCAT(__pm_slot_, dev_id))
291#define Z_PM_DEVICE_DEFINE_SLOT(dev_id)
294#ifdef CONFIG_PM_DEVICE
302#define Z_PM_DEVICE_DEFINE(node_id, dev_id, pm_action_cb, isr_safe) \
303 Z_PM_DEVICE_DEFINE_SLOT(dev_id); \
304 static struct COND_CODE_1(isr_safe, (pm_device_isr), (pm_device)) \
305 Z_PM_DEVICE_NAME(dev_id) = \
306 Z_PM_DEVICE_INIT(Z_PM_DEVICE_NAME(dev_id), node_id, \
307 pm_action_cb, isr_safe)
314#define Z_PM_DEVICE_GET(dev_id) ((struct pm_device_base *)&Z_PM_DEVICE_NAME(dev_id))
317#define Z_PM_DEVICE_DEFINE(node_id, dev_id, pm_action_cb, isr_safe)
318#define Z_PM_DEVICE_GET(dev_id) NULL
334#define PM_DEVICE_DEFINE(dev_id, pm_action_cb, ...) \
335 Z_PM_DEVICE_DEFINE(DT_INVALID_NODE, dev_id, pm_action_cb, \
336 COND_CODE_1(IS_EMPTY(__VA_ARGS__), (0), (__VA_ARGS__)))
349#define PM_DEVICE_DT_DEFINE(node_id, pm_action_cb, ...) \
350 Z_PM_DEVICE_DEFINE(node_id, Z_DEVICE_DT_DEV_ID(node_id), pm_action_cb, \
351 COND_CODE_1(IS_EMPTY(__VA_ARGS__), (0), (__VA_ARGS__)))
364#define PM_DEVICE_DT_INST_DEFINE(idx, pm_action_cb, ...) \
365 Z_PM_DEVICE_DEFINE(DT_DRV_INST(idx), \
366 Z_DEVICE_DT_DEV_ID(DT_DRV_INST(idx)), \
368 COND_CODE_1(IS_EMPTY(__VA_ARGS__), (0), (__VA_ARGS__)))
378#define PM_DEVICE_GET(dev_id) \
379 Z_PM_DEVICE_GET(dev_id)
389#define PM_DEVICE_DT_GET(node_id) \
390 PM_DEVICE_GET(Z_DEVICE_DT_DEV_ID(node_id))
400#define PM_DEVICE_DT_INST_GET(idx) \
401 PM_DEVICE_DT_GET(DT_DRV_INST(idx))
444#if defined(CONFIG_PM_DEVICE) || defined(__DOXYGEN__)
594 const struct device *domain);
609 const struct device *domain);
695 const struct device *domain)
703 const struct device *domain)
722 if ((rc < 0) && (rc != -
ENOTSUP)) {
long atomic_t
Definition atomic_types.h:15
bool pm_device_wakeup_is_enabled(const struct device *dev)
Check if a device is enabled as a wake up source.
int pm_device_power_domain_remove(const struct device *dev, const struct device *domain)
Remove a device from a power domain.
bool pm_device_on_power_domain(const struct device *dev)
Check if the device is on a switchable power domain.
int pm_device_action_run(const struct device *dev, enum pm_device_action action)
Run a pm action on a device.
static void pm_device_init_suspended(const struct device *dev)
Initialize a device state to PM_DEVICE_STATE_SUSPENDED.
Definition device.h:468
pm_device_state
Device power states.
Definition device.h:68
bool pm_device_wakeup_enable(const struct device *dev, bool enable)
Enable or disable a device as a wake up source.
void pm_device_children_action_run(const struct device *dev, enum pm_device_action action, pm_device_action_failed_cb_t failure_cb)
Run a pm action on all children of a device.
void pm_device_busy_set(const struct device *dev)
Mark a device as busy.
int(* pm_device_action_cb_t)(const struct device *dev, enum pm_device_action action)
Device PM action callback.
Definition device.h:119
void pm_device_busy_clear(const struct device *dev)
Clear a device busy status.
bool pm_device_is_busy(const struct device *dev)
Check if a device is busy.
bool(* pm_device_action_failed_cb_t)(const struct device *dev, int err)
Device PM action failed callback.
Definition device.h:130
bool pm_device_is_powered(const struct device *dev)
Check if the device is currently powered.
int pm_device_power_domain_add(const struct device *dev, const struct device *domain)
Add a device to a power domain.
bool pm_device_wakeup_is_capable(const struct device *dev)
Check if a device is wake up capable.
const char * pm_device_state_str(enum pm_device_state state)
Get name of device PM state.
int pm_device_driver_init(const struct device *dev, pm_device_action_cb_t action_cb)
Setup a device driver into the lowest valid power mode.
bool pm_device_is_any_busy(void)
Check if any device is busy.
pm_device_action
Device PM actions.
Definition device.h:90
static void pm_device_init_off(const struct device *dev)
Initialize a device state to PM_DEVICE_STATE_OFF.
Definition device.h:488
int pm_device_state_get(const struct device *dev, enum pm_device_state *state)
Obtain the power state of a device.
@ PM_DEVICE_STATE_SUSPENDED
Device is suspended.
Definition device.h:77
@ PM_DEVICE_STATE_OFF
Device is turned off (power removed).
Definition device.h:86
@ PM_DEVICE_STATE_SUSPENDING
Device is being suspended.
Definition device.h:79
@ PM_DEVICE_STATE_ACTIVE
Device is in active or regular state.
Definition device.h:70
@ PM_DEVICE_ACTION_TURN_OFF
Turn off.
Definition device.h:100
@ PM_DEVICE_ACTION_SUSPEND
Suspend.
Definition device.h:92
@ PM_DEVICE_ACTION_RESUME
Resume.
Definition device.h:94
@ PM_DEVICE_ACTION_TURN_ON
Turn on.
Definition device.h:106
#define ENOSYS
Function not implemented.
Definition errno.h:82
#define ENOTSUP
Unsupported value.
Definition errno.h:114
state
Definition parser_state.h:29
#define bool
Definition stdbool.h:13
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
Runtime device structure (in ROM) per driver instance.
Definition device.h:412
struct pm_device_base * pm_base
Definition device.h:440
Event Structure.
Definition kernel.h:2307
Kernel Spin Lock.
Definition spinlock.h:45
A structure used to submit work after a delay.
Definition kernel.h:3991
Device PM info.
Definition device.h:139
uint32_t usage
Device usage count.
Definition device.h:148
pm_device_action_cb_t action_cb
Device PM action callback.
Definition device.h:145
enum pm_device_state state
Device power state.
Definition device.h:143
atomic_t flags
Device PM status flags.
Definition device.h:141
Runtime PM info for device with synchronous PM.
Definition device.h:185
struct k_spinlock lock
Lock to synchronize the synchronous get/put operations.
Definition device.h:190
struct pm_device_base base
Base info.
Definition device.h:187
Runtime PM info for device with generic PM.
Definition device.h:163
struct k_work_delayable work
Work object for asynchronous calls.
Definition device.h:174
struct k_event event
Event var to listen to the sync request events.
Definition device.h:172
struct k_sem lock
Lock to synchronize the get/put operations.
Definition device.h:170
const struct device * dev
Pointer to the device.
Definition device.h:168
struct pm_device_base base
Base info.
Definition device.h:165