Zephyr API Documentation  3.5.0
A Scalable Open Source RTOS
3.5.0
All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
ipm.h
Go to the documentation of this file.
1
7/*
8 * Copyright (c) 2015 Intel Corporation
9 *
10 * SPDX-License-Identifier: Apache-2.0
11 */
12
13#ifndef ZEPHYR_INCLUDE_DRIVERS_IPM_H_
14#define ZEPHYR_INCLUDE_DRIVERS_IPM_H_
15
23#include <zephyr/kernel.h>
24#include <zephyr/device.h>
25
26#ifdef __cplusplus
27extern "C" {
28#endif
29
45typedef void (*ipm_callback_t)(const struct device *ipmdev, void *user_data,
46 uint32_t id, volatile void *data);
47
54typedef int (*ipm_send_t)(const struct device *ipmdev, int wait, uint32_t id,
55 const void *data, int size);
62typedef int (*ipm_max_data_size_get_t)(const struct device *ipmdev);
63
70typedef uint32_t (*ipm_max_id_val_get_t)(const struct device *ipmdev);
71
78typedef void (*ipm_register_callback_t)(const struct device *port,
80 void *user_data);
81
88typedef int (*ipm_set_enabled_t)(const struct device *ipmdev, int enable);
89
96typedef void (*ipm_complete_t)(const struct device *ipmdev);
97
98__subsystem struct ipm_driver_api {
104#ifdef CONFIG_IPM_CALLBACK_ASYNC
105 ipm_complete_t complete;
106#endif
107};
108
144__syscall int ipm_send(const struct device *ipmdev, int wait, uint32_t id,
145 const void *data, int size);
146
147static inline int z_impl_ipm_send(const struct device *ipmdev, int wait,
148 uint32_t id,
149 const void *data, int size)
150{
151 const struct ipm_driver_api *api =
152 (const struct ipm_driver_api *)ipmdev->api;
153
154 return api->send(ipmdev, wait, id, data, size);
155}
156
165static inline void ipm_register_callback(const struct device *ipmdev,
166 ipm_callback_t cb, void *user_data)
167{
168 const struct ipm_driver_api *api =
169 (const struct ipm_driver_api *)ipmdev->api;
170
171 api->register_callback(ipmdev, cb, user_data);
172}
173
184__syscall int ipm_max_data_size_get(const struct device *ipmdev);
185
186static inline int z_impl_ipm_max_data_size_get(const struct device *ipmdev)
187{
188 const struct ipm_driver_api *api =
189 (const struct ipm_driver_api *)ipmdev->api;
190
191 return api->max_data_size_get(ipmdev);
192}
193
194
205__syscall uint32_t ipm_max_id_val_get(const struct device *ipmdev);
206
207static inline uint32_t z_impl_ipm_max_id_val_get(const struct device *ipmdev)
208{
209 const struct ipm_driver_api *api =
210 (const struct ipm_driver_api *)ipmdev->api;
211
212 return api->max_id_val_get(ipmdev);
213}
214
224__syscall int ipm_set_enabled(const struct device *ipmdev, int enable);
225
226static inline int z_impl_ipm_set_enabled(const struct device *ipmdev,
227 int enable)
228{
229 const struct ipm_driver_api *api =
230 (const struct ipm_driver_api *)ipmdev->api;
231
232 return api->set_enabled(ipmdev, enable);
233}
234
249__syscall void ipm_complete(const struct device *ipmdev);
250
251static inline void z_impl_ipm_complete(const struct device *ipmdev)
252{
253#ifdef CONFIG_IPM_CALLBACK_ASYNC
254 const struct ipm_driver_api *api =
255 (const struct ipm_driver_api *)ipmdev->api;
256
257 if (api->complete != NULL) {
258 api->complete(ipmdev);
259 }
260#endif
261}
262
263#ifdef __cplusplus
264}
265#endif
266
271#include <syscalls/ipm.h>
272
273#endif /* ZEPHYR_INCLUDE_DRIVERS_IPM_H_ */
int ipm_max_data_size_get(const struct device *ipmdev)
Return the maximum number of bytes possible in an outbound message.
uint32_t ipm_max_id_val_get(const struct device *ipmdev)
Return the maximum id value possible in an outbound message.
void(* ipm_register_callback_t)(const struct device *port, ipm_callback_t cb, void *user_data)
Callback API upon registration.
Definition: ipm.h:78
int(* ipm_set_enabled_t)(const struct device *ipmdev, int enable)
Callback API upon enablement of interrupts.
Definition: ipm.h:88
void ipm_complete(const struct device *ipmdev)
Signal asynchronous command completion.
static void ipm_register_callback(const struct device *ipmdev, ipm_callback_t cb, void *user_data)
Register a callback function for incoming messages.
Definition: ipm.h:165
int ipm_set_enabled(const struct device *ipmdev, int enable)
Enable interrupts and callbacks for inbound channels.
int(* ipm_max_data_size_get_t)(const struct device *ipmdev)
Callback API to get maximum data size.
Definition: ipm.h:62
int(* ipm_send_t)(const struct device *ipmdev, int wait, uint32_t id, const void *data, int size)
Callback API to send IPM messages.
Definition: ipm.h:54
void(* ipm_complete_t)(const struct device *ipmdev)
Callback API upon command completion.
Definition: ipm.h:96
int ipm_send(const struct device *ipmdev, int wait, uint32_t id, const void *data, int size)
Try to send a message over the IPM device.
uint32_t(* ipm_max_id_val_get_t)(const struct device *ipmdev)
Callback API to get the ID's maximum value.
Definition: ipm.h:70
void(* ipm_callback_t)(const struct device *ipmdev, void *user_data, uint32_t id, volatile void *data)
Callback API for incoming IPM messages.
Definition: ipm.h:45
Public kernel APIs.
__UINT32_TYPE__ uint32_t
Definition: stdint.h:90
Runtime device structure (in ROM) per driver instance.
Definition: device.h:381
void * data
Address of the device instance private data.
Definition: device.h:391
const void * api
Address of the API structure exposed by the device instance.
Definition: device.h:387
Definition: ipm.h:98
ipm_register_callback_t register_callback
Definition: ipm.h:100
ipm_max_data_size_get_t max_data_size_get
Definition: ipm.h:101
ipm_max_id_val_get_t max_id_val_get
Definition: ipm.h:102
ipm_set_enabled_t set_enabled
Definition: ipm.h:103
ipm_send_t send
Definition: ipm.h:99