Zephyr API Documentation 4.4.0-rc1
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
ipm.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2015 Intel Corporation
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
12
13#ifndef ZEPHYR_INCLUDE_DRIVERS_IPM_H_
14#define ZEPHYR_INCLUDE_DRIVERS_IPM_H_
15
24
25#include <zephyr/kernel.h>
26#include <zephyr/device.h>
27
28#ifdef __cplusplus
29extern "C" {
30#endif
31
47typedef void (*ipm_callback_t)(const struct device *ipmdev, void *user_data,
48 uint32_t id, volatile void *data);
49
54
59typedef int (*ipm_send_t)(const struct device *ipmdev, int wait, uint32_t id,
60 const void *data, int size);
61
66typedef int (*ipm_max_data_size_get_t)(const struct device *ipmdev);
67
72typedef uint32_t (*ipm_max_id_val_get_t)(const struct device *ipmdev);
73
78typedef void (*ipm_register_callback_t)(const struct device *port,
80 void *user_data);
81
86typedef int (*ipm_set_enabled_t)(const struct device *ipmdev, int enable);
87
92typedef void (*ipm_complete_t)(const struct device *ipmdev);
93
126
129
166__syscall int ipm_send(const struct device *ipmdev, int wait, uint32_t id,
167 const void *data, int size);
168
169static inline int z_impl_ipm_send(const struct device *ipmdev, int wait,
170 uint32_t id,
171 const void *data, int size)
172{
173 const struct ipm_driver_api *api =
174 (const struct ipm_driver_api *)ipmdev->api;
175
176 return api->send(ipmdev, wait, id, data, size);
177}
178
187static inline void ipm_register_callback(const struct device *ipmdev,
188 ipm_callback_t cb, void *user_data)
189{
190 const struct ipm_driver_api *api =
191 (const struct ipm_driver_api *)ipmdev->api;
192
193 api->register_callback(ipmdev, cb, user_data);
194}
195
206__syscall int ipm_max_data_size_get(const struct device *ipmdev);
207
208static inline int z_impl_ipm_max_data_size_get(const struct device *ipmdev)
209{
210 const struct ipm_driver_api *api =
211 (const struct ipm_driver_api *)ipmdev->api;
212
213 return api->max_data_size_get(ipmdev);
214}
215
216
227__syscall uint32_t ipm_max_id_val_get(const struct device *ipmdev);
228
229static inline uint32_t z_impl_ipm_max_id_val_get(const struct device *ipmdev)
230{
231 const struct ipm_driver_api *api =
232 (const struct ipm_driver_api *)ipmdev->api;
233
234 return api->max_id_val_get(ipmdev);
235}
236
246__syscall int ipm_set_enabled(const struct device *ipmdev, int enable);
247
248static inline int z_impl_ipm_set_enabled(const struct device *ipmdev,
249 int enable)
250{
251 const struct ipm_driver_api *api =
252 (const struct ipm_driver_api *)ipmdev->api;
253
254 return api->set_enabled(ipmdev, enable);
255}
256
271__syscall void ipm_complete(const struct device *ipmdev);
272
273static inline void z_impl_ipm_complete(const struct device *ipmdev)
274{
275#ifdef CONFIG_IPM_CALLBACK_ASYNC
276 const struct ipm_driver_api *api =
277 (const struct ipm_driver_api *)ipmdev->api;
278
279 if (api->complete != NULL) {
280 api->complete(ipmdev);
281 }
282#endif
283}
284
285#ifdef __cplusplus
286}
287#endif
288
292
293#include <zephyr/syscalls/ipm.h>
294
295#endif /* ZEPHYR_INCLUDE_DRIVERS_IPM_H_ */
void(* ipm_complete_t)(const struct device *ipmdev)
Callback API to signal asynchronous command completion.
Definition ipm.h:92
int(* ipm_max_data_size_get_t)(const struct device *ipmdev)
Callback API to get maximum data size.
Definition ipm.h:66
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:59
void(* ipm_register_callback_t)(const struct device *port, ipm_callback_t cb, void *user_data)
Callback API to register a callback for incoming messages.
Definition ipm.h:78
uint32_t(* ipm_max_id_val_get_t)(const struct device *ipmdev)
Callback API to get the ID's maximum value.
Definition ipm.h:72
int(* ipm_set_enabled_t)(const struct device *ipmdev, int enable)
Callback API to enable or disable interrupts for inbound channels.
Definition ipm.h:86
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_callback_t)(const struct device *ipmdev, void *user_data, uint32_t id, volatile void *data)
Callback API for incoming IPM messages.
Definition ipm.h:47
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:187
int ipm_set_enabled(const struct device *ipmdev, int enable)
Enable interrupts and callbacks for inbound channels.
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.
#define NULL
Definition iar_missing_defs.h:20
Public kernel APIs.
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
Runtime device structure (in ROM) per driver instance.
Definition device.h:513
void * data
Address of the device instance private data.
Definition device.h:523
const void * api
Address of the API structure exposed by the device instance.
Definition device.h:519
<span class="mlabel">Driver Operations</span> IPM driver operations
Definition ipm.h:97
ipm_register_callback_t register_callback
<span class="op-badge op-req" title="This operation MUST be implemented by the driver....
Definition ipm.h:105
ipm_max_data_size_get_t max_data_size_get
<span class="op-badge op-req" title="This operation MUST be implemented by the driver....
Definition ipm.h:109
ipm_max_id_val_get_t max_id_val_get
<span class="op-badge op-req" title="This operation MUST be implemented by the driver....
Definition ipm.h:113
ipm_complete_t complete
<span class="op-badge op-opt" title="This operation MAY optionally be implemented by the driver....
Definition ipm.h:123
ipm_set_enabled_t set_enabled
<span class="op-badge op-req" title="This operation MUST be implemented by the driver....
Definition ipm.h:117
ipm_send_t send
<span class="op-badge op-req" title="This operation MUST be implemented by the driver....
Definition ipm.h:101