Zephyr API Documentation 4.2.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
timeaware_gpio.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2023 Intel Corporation.
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
12#ifndef ZEPHYR_DRIVERS_MISC_TIMEAWARE_GPIO_TIMEAWARE_GPIO
13#define ZEPHYR_DRIVERS_MISC_TIMEAWARE_GPIO_TIMEAWARE_GPIO
14
23
24#include <zephyr/sys/__assert.h>
25#include <zephyr/sys/slist.h>
26
27#include <zephyr/types.h>
28#include <stddef.h>
29#include <zephyr/device.h>
31
32#ifdef __cplusplus
33extern "C" {
34#endif
35
44
52
53__subsystem struct tgpio_driver_api {
54 int (*pin_disable)(const struct device *dev, uint32_t pin);
55 int (*get_time)(const struct device *dev, uint64_t *current_time);
56 int (*cyc_per_sec)(const struct device *dev, uint32_t *cycles);
57 int (*set_perout)(const struct device *dev, uint32_t pin, uint64_t start_time,
58 uint64_t repeat_interval, bool periodic_enable);
59 int (*config_ext_ts)(const struct device *dev, uint32_t pin, uint32_t event_polarity);
60 int (*read_ts_ec)(const struct device *dev, uint32_t pin, uint64_t *timestamp,
61 uint64_t *event_count);
62};
63
67
77__syscall int tgpio_port_get_time(const struct device *dev, uint64_t *current_time);
78
79static inline int z_impl_tgpio_port_get_time(const struct device *dev, uint64_t *current_time)
80{
81 const struct tgpio_driver_api *api = (const struct tgpio_driver_api *)dev->api;
82
83 return api->get_time(dev, current_time);
84}
85
94__syscall int tgpio_port_get_cycles_per_second(const struct device *dev, uint32_t *cycles);
95
96static inline int z_impl_tgpio_port_get_cycles_per_second(const struct device *dev,
97 uint32_t *cycles)
98{
99 const struct tgpio_driver_api *api = (const struct tgpio_driver_api *)dev->api;
100
101 return api->cyc_per_sec(dev, cycles);
102}
103
112__syscall int tgpio_pin_disable(const struct device *dev, uint32_t pin);
113
114static inline int z_impl_tgpio_pin_disable(const struct device *dev, uint32_t pin)
115{
116 const struct tgpio_driver_api *api = (const struct tgpio_driver_api *)dev->api;
117
118 return api->pin_disable(dev, pin);
119}
120
130__syscall int tgpio_pin_config_ext_timestamp(const struct device *dev, uint32_t pin,
131 uint32_t event_polarity);
132
133static inline int z_impl_tgpio_pin_config_ext_timestamp(const struct device *dev, uint32_t pin,
134 uint32_t event_polarity)
135{
136 const struct tgpio_driver_api *api = (const struct tgpio_driver_api *)dev->api;
137
138 return api->config_ext_ts(dev, pin, event_polarity);
139}
140
152__syscall int tgpio_pin_periodic_output(const struct device *dev, uint32_t pin,
153 uint64_t start_time, uint64_t repeat_interval,
154 bool periodic_enable);
155
156static inline int z_impl_tgpio_pin_periodic_output(const struct device *dev, uint32_t pin,
157 uint64_t start_time, uint64_t repeat_interval,
158 bool periodic_enable)
159{
160 const struct tgpio_driver_api *api = (const struct tgpio_driver_api *)dev->api;
161
162 return api->set_perout(dev, pin, start_time, repeat_interval, periodic_enable);
163}
164
175__syscall int tgpio_pin_read_ts_ec(const struct device *dev, uint32_t pin, uint64_t *timestamp,
176 uint64_t *event_count);
177
178static inline int z_impl_tgpio_pin_read_ts_ec(const struct device *dev, uint32_t pin,
179 uint64_t *timestamp, uint64_t *event_count)
180{
181 const struct tgpio_driver_api *api = (const struct tgpio_driver_api *)dev->api;
182
183 return api->read_ts_ec(dev, pin, timestamp, event_count);
184}
185
189
190#ifdef __cplusplus
191}
192#endif
193
194#include <zephyr/syscalls/timeaware_gpio.h>
195
196#endif /* ZEPHYR_DRIVERS_MISC_TIMEAWARE_GPIO_TIMEAWARE_GPIO */
int tgpio_pin_read_ts_ec(const struct device *dev, uint32_t pin, uint64_t *timestamp, uint64_t *event_count)
Read timestamp and event counter from TGPIO.
int tgpio_pin_config_ext_timestamp(const struct device *dev, uint32_t pin, uint32_t event_polarity)
Enable/Continue operation on pin.
int tgpio_pin_disable(const struct device *dev, uint32_t pin)
Disable operation on pin.
int tgpio_port_get_time(const struct device *dev, uint64_t *current_time)
Get time from ART timer.
int tgpio_port_get_cycles_per_second(const struct device *dev, uint32_t *cycles)
Get current running rate.
tgpio_pin_polarity
Event polarity.
Definition timeaware_gpio.h:39
int tgpio_pin_periodic_output(const struct device *dev, uint32_t pin, uint64_t start_time, uint64_t repeat_interval, bool periodic_enable)
Enable periodic pulse generation on a pin.
@ TGPIO_TOGGLE_EDGE
Definition timeaware_gpio.h:42
@ TGPIO_RISING_EDGE
Definition timeaware_gpio.h:40
@ TGPIO_FALLING_EDGE
Definition timeaware_gpio.h:41
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
__UINT64_TYPE__ uint64_t
Definition stdint.h:91
Runtime device structure (in ROM) per driver instance.
Definition device.h:510
const void * api
Address of the API structure exposed by the device instance.
Definition device.h:516