Zephyr API Documentation 4.3.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
gpio_utils.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2016 Intel Corporation.
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
12
13#ifndef ZEPHYR_INCLUDE_DRIVERS_GPIO_GPIO_UTILS_H_
14#define ZEPHYR_INCLUDE_DRIVERS_GPIO_GPIO_UTILS_H_
15
20
21#include <stdbool.h>
22#include <stdint.h>
23#include <errno.h>
24
25#include <zephyr/devicetree.h>
26#include <zephyr/drivers/gpio.h>
27#include <zephyr/sys/__assert.h>
28#include <zephyr/sys/slist.h>
30
31#ifdef __cplusplus
32extern "C" {
33#endif
34
41#define GPIO_PORT_PIN_MASK_FROM_NGPIOS(ngpios) \
42 ((gpio_port_pins_t)(((uint64_t)1 << (ngpios)) - 1U))
43
52#define GPIO_PORT_PIN_MASK_FROM_DT_NODE(node_id) \
53 GPIO_DT_PORT_PIN_MASK_NGPIOS_EXC(node_id, DT_PROP(node_id, ngpios))
54
63#define GPIO_PORT_PIN_MASK_FROM_DT_INST(inst) \
64 GPIO_PORT_PIN_MASK_FROM_DT_NODE(DT_DRV_INST(inst))
65
66
73#define GPIO_COMMON_CONFIG_FROM_DT_NODE(node_id) \
74 { \
75 .port_pin_mask = GPIO_PORT_PIN_MASK_FROM_DT_NODE(node_id), \
76 }
77
84#define GPIO_COMMON_CONFIG_FROM_DT_INST(inst) \
85 GPIO_COMMON_CONFIG_FROM_DT_NODE(DT_DRV_INST(inst))
86
96static inline int gpio_manage_callback(sys_slist_t *callbacks,
97 struct gpio_callback *callback,
98 bool set)
99{
100 __ASSERT(callback, "No callback!");
101 __ASSERT(callback->handler, "No callback handler!");
102
103 if (!sys_slist_is_empty(callbacks)) {
104 if (!sys_slist_find_and_remove(callbacks, &callback->node)) {
105 if (!set) {
106 return -EINVAL;
107 }
108 }
109 } else if (!set) {
110 return -EINVAL;
111 }
112
113 if (set) {
114 sys_slist_prepend(callbacks, &callback->node);
115 }
116
117 return 0;
118}
119
127static inline void gpio_fire_callbacks(sys_slist_t *list,
128 const struct device *port,
129 uint32_t pins)
130{
131 struct gpio_callback *cb, *tmp;
132
134
136 if (cb->pin_mask & pins) {
137 __ASSERT(cb->handler, "No callback handler!");
138
139 cb->handler(port, cb, cb->pin_mask & pins);
141 }
142 }
143}
144
145#ifdef __cplusplus
146}
147#endif
148
152
153#endif /* ZEPHYR_INCLUDE_DRIVERS_GPIO_GPIO_UTILS_H_ */
Devicetree main header.
Main header file for GPIO driver API.
System error numbers.
static void gpio_fire_callbacks(sys_slist_t *list, const struct device *port, uint32_t pins)
Generic function to go through and fire callback from a callback list.
Definition gpio_utils.h:127
static int gpio_manage_callback(sys_slist_t *callbacks, struct gpio_callback *callback, bool set)
Generic function to insert or remove a callback from a callback list.
Definition gpio_utils.h:96
static bool sys_slist_find_and_remove(sys_slist_t *list, sys_snode_t *node)
Find and remove a node from a list.
Definition slist.h:448
struct _slist sys_slist_t
Single-linked list structure.
Definition slist.h:49
static void sys_slist_prepend(sys_slist_t *list, sys_snode_t *node)
Prepend a node to the given list.
Definition slist.h:305
#define SYS_SLIST_FOR_EACH_CONTAINER_SAFE(__sl, __cn, __cns, __n)
Provide the primitive to safely iterate on a list under a container Note: __cn can be detached,...
Definition slist.h:183
static bool sys_slist_is_empty(const sys_slist_t *list)
Test if the given list is empty.
Definition slist.h:268
#define sys_port_trace_gpio_fire_callbacks_enter(list, port, pins)
Definition tracing.h:2673
#define sys_port_trace_gpio_fire_callback(port, callback)
Definition tracing.h:2680
#define EINVAL
Invalid argument.
Definition errno.h:60
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
Runtime device structure (in ROM) per driver instance.
Definition device.h:513
GPIO callback structure.
Definition gpio.h:748
sys_snode_t node
This is meant to be used in the driver and the user should not mess with it (see drivers/gpio/gpio_ut...
Definition gpio.h:752
gpio_port_pins_t pin_mask
A mask of pins the callback is interested in, if 0 the callback will never be called.
Definition gpio.h:763
gpio_callback_handler_t handler
Actual callback function being called when relevant.
Definition gpio.h:755
Main header file for tracing subsystem API.