Zephyr Project API 4.4.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
pm.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2012-2014 Wind River Systems, Inc.
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
12
13#ifndef ZEPHYR_INCLUDE_PM_PM_H_
14#define ZEPHYR_INCLUDE_PM_PM_H_
15
16#include <zephyr/types.h>
17#include <zephyr/sys/slist.h>
18#include <zephyr/pm/state.h>
19#include <zephyr/toolchain.h>
20#include <errno.h>
21#include <stdbool.h>
22
23#ifdef __cplusplus
24extern "C" {
25#endif
26
35
43
63 sys_snode_t _node;
64 union {
65 struct {
70 void (*state_entry)(enum pm_state state);
75 void (*state_exit)(enum pm_state state);
76 };
77 struct {
82 void (*substate_entry)(enum pm_state state, uint8_t substate_id);
87 void (*substate_exit)(enum pm_state state, uint8_t substate_id);
88 };
89 };
90 bool report_substate; /* 0 is for backwards compatibility that didn't report substates */
91};
92
93#if defined(CONFIG_PM) || defined(__DOXYGEN__)
106bool pm_state_force(uint8_t cpu, const struct pm_state_info *info);
107
116void pm_notifier_register(struct pm_notifier *notifier);
117
129
141
160
164
171
194
217
221
222#else /* CONFIG_PM */
223
224static inline void pm_notifier_register(struct pm_notifier *notifier)
225{
226 ARG_UNUSED(notifier);
227}
228
229static inline int pm_notifier_unregister(struct pm_notifier *notifier)
230{
231 ARG_UNUSED(notifier);
232
233 return -ENOSYS;
234}
235
236static inline const struct pm_state_info *pm_state_next_get(uint8_t cpu)
237{
238 ARG_UNUSED(cpu);
239
240 return NULL;
241}
242
243static inline void pm_system_resume(void)
244{
245}
246
247#endif /* CONFIG_PM */
248
249#ifdef __cplusplus
250}
251#endif
252
253#endif /* ZEPHYR_INCLUDE_PM_PM_H_ */
System error numbers.
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:42
pm_state
Power management state.
Definition state.h:34
void pm_state_exit_post_ops(enum pm_state state, uint8_t substate_id)
Do any SoC or architecture specific post ops after sleep state exits.
void pm_state_set(enum pm_state state, uint8_t substate_id)
Put processor into a power state.
void pm_notifier_register(struct pm_notifier *notifier)
Register a power management notifier.
bool pm_state_force(uint8_t cpu, const struct pm_state_info *info)
Force usage of given power state.
const struct pm_state_info * pm_state_next_get(uint8_t cpu)
Gets the next power state that will be used.
void pm_system_resume(void)
Notify exit from kernel sleep.
int pm_notifier_unregister(struct pm_notifier *notifier)
Unregister a power management notifier.
#define ENOSYS
Function not implemented.
Definition errno.h:82
#define NULL
Definition iar_missing_defs.h:20
state
Definition parser_state.h:29
Header file for the single-linked list API.
Header file for System Power Management state definitions.
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
Power management notifier struct.
Definition pm.h:62
bool report_substate
Definition pm.h:90
void(* substate_entry)(enum pm_state state, uint8_t substate_id)
Application defined function for doing any target specific operations for power state entry.
Definition pm.h:82
void(* state_entry)(enum pm_state state)
Application defined function for doing any target specific operations for power state entry.
Definition pm.h:70
void(* substate_exit)(enum pm_state state, uint8_t substate_id)
Application defined function for doing any target specific operations for power state exit.
Definition pm.h:87
void(* state_exit)(enum pm_state state)
Application defined function for doing any target specific operations for power state exit.
Definition pm.h:75
Information about a power management state.
Definition state.h:121
uint8_t substate_id
Some platforms have multiple states that map to one Zephyr power state.
Definition state.h:149
Macros to abstract toolchain specific capabilities.