Zephyr Project API 4.1.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
policy.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2018 Intel Corporation.
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
7#ifndef ZEPHYR_INCLUDE_PM_POLICY_H_
8#define ZEPHYR_INCLUDE_PM_POLICY_H_
9
10#include <stdbool.h>
11#include <stdint.h>
12
13#include <zephyr/device.h>
14#include <zephyr/pm/state.h>
15#include <zephyr/sys/slist.h>
16#include <zephyr/toolchain.h>
17
18#ifdef __cplusplus
19extern "C" {
20#endif
21
36typedef void (*pm_policy_latency_changed_cb_t)(int32_t latency);
37
49
57 sys_snode_t node;
58 uint32_t value_us;
60};
61
69 sys_snode_t node;
70 int64_t uptime_ticks;
72};
73
89const struct pm_state_info *pm_policy_next_state(uint8_t cpu, int32_t ticks);
90
94#define PM_ALL_SUBSTATES (UINT8_MAX)
95
96#if defined(CONFIG_PM) || defined(__DOXYGEN__)
116
127
139
153
164
183void pm_policy_event_register(struct pm_policy_event *evt, int64_t uptime_ticks);
184
196void pm_policy_event_update(struct pm_policy_event *evt, int64_t uptime_ticks);
197
206
221
233
234#else
236{
237 ARG_UNUSED(state);
238 ARG_UNUSED(substate_id);
239}
240
242{
243 ARG_UNUSED(state);
244 ARG_UNUSED(substate_id);
245}
246
248{
249 ARG_UNUSED(state);
250 ARG_UNUSED(substate_id);
251
252 return false;
253}
254
255static inline void pm_policy_event_register(struct pm_policy_event *evt, uint32_t cycle)
256{
257 ARG_UNUSED(evt);
258 ARG_UNUSED(cycle);
259}
260
261static inline void pm_policy_event_update(struct pm_policy_event *evt, uint32_t cycle)
262{
263 ARG_UNUSED(evt);
264 ARG_UNUSED(cycle);
265}
266
267static inline void pm_policy_event_unregister(struct pm_policy_event *evt)
268{
269 ARG_UNUSED(evt);
270}
271
272static inline int64_t pm_policy_next_event_ticks(void)
273{
274 return -1;
275}
276
277#endif /* CONFIG_PM */
278
279#if defined(CONFIG_PM_POLICY_DEVICE_CONSTRAINTS) || defined(__DOXYGEN__)
292
305
306#else
307
308static inline void pm_policy_device_power_lock_get(const struct device *dev)
309{
310 ARG_UNUSED(dev);
311}
312
313static inline void pm_policy_device_power_lock_put(const struct device *dev)
314{
315 ARG_UNUSED(dev);
316}
317#endif /* CONFIG_PM_POLICY_DEVICE_CONSTRAINTS */
318
319#if defined(CONFIG_PM) || defined(CONFIG_PM_POLICY_LATENCY_STANDALONE) || defined(__DOXYGEN__)
330 uint32_t value_us);
331
339 uint32_t value_us);
340
347
356
363#else
364static inline void pm_policy_latency_request_add(
365 struct pm_policy_latency_request *req, uint32_t value_us)
366{
367 ARG_UNUSED(req);
368 ARG_UNUSED(value_us);
369}
370
371static inline void pm_policy_latency_request_update(
372 struct pm_policy_latency_request *req, uint32_t value_us)
373{
374 ARG_UNUSED(req);
375 ARG_UNUSED(value_us);
376}
377
378static inline void pm_policy_latency_request_remove(
379 struct pm_policy_latency_request *req)
380{
381 ARG_UNUSED(req);
382}
383#endif /* CONFIG_PM CONFIG_PM_POLICY_LATENCY_STANDALONE */
384
389#ifdef __cplusplus
390}
391#endif
392
393#endif /* ZEPHYR_INCLUDE_PM_POLICY_H_ */
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:39
pm_state
Power management state.
Definition state.h:27
void pm_policy_event_update(struct pm_policy_event *evt, int64_t uptime_ticks)
Update an event.
bool pm_policy_state_any_active(void)
Check if any power state can be used.
void pm_policy_state_lock_put(enum pm_state state, uint8_t substate_id)
Decrease a power state lock counter.
bool pm_policy_state_is_available(enum pm_state state, uint8_t substate_id)
Check if a power state is available.
bool pm_policy_state_lock_is_active(enum pm_state state, uint8_t substate_id)
Check if a power state lock is active (not allowed).
bool pm_policy_device_is_disabling_state(const struct device *dev, enum pm_state state, uint8_t substate_id)
Check if a state will disable a device.
void pm_policy_event_register(struct pm_policy_event *evt, int64_t uptime_ticks)
Register an event.
void pm_policy_latency_request_update(struct pm_policy_latency_request *req, uint32_t value_us)
Update a latency requirement.
void pm_policy_device_power_lock_get(const struct device *dev)
Increase power state locks.
void pm_policy_latency_request_add(struct pm_policy_latency_request *req, uint32_t value_us)
Add a new latency requirement.
void pm_policy_latency_changed_unsubscribe(struct pm_policy_latency_subscription *req)
Unsubscribe to maximum latency changes.
void pm_policy_event_unregister(struct pm_policy_event *evt)
Unregister an event.
void pm_policy_latency_request_remove(struct pm_policy_latency_request *req)
Remove a latency requirement.
void(* pm_policy_latency_changed_cb_t)(int32_t latency)
Callback to notify when maximum latency changes.
Definition policy.h:36
void pm_policy_state_lock_get(enum pm_state state, uint8_t substate_id)
Increase a power state lock counter.
void pm_policy_latency_changed_subscribe(struct pm_policy_latency_subscription *req, pm_policy_latency_changed_cb_t cb)
Subscribe to maximum latency changes.
int64_t pm_policy_next_event_ticks(void)
Returns the ticks until the next event.
void pm_policy_device_power_lock_put(const struct device *dev)
Decrease power state locks.
state
Definition parser_state.h:29
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
__INT32_TYPE__ int32_t
Definition stdint.h:74
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
__INT64_TYPE__ int64_t
Definition stdint.h:75
Runtime device structure (in ROM) per driver instance.
Definition device.h:510
Event.
Definition policy.h:67
Latency request.
Definition policy.h:55
Latency change subscription.
Definition policy.h:43
Information about a power management state.
Definition state.h:114
uint8_t substate_id
Some platforms have multiple states that map to one Zephyr power state.
Definition state.h:142
Macros to abstract toolchain specific capabilities.