Zephyr Project API 4.4.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
ipc_service.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2021 Nordic Semiconductor ASA
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
7#ifndef ZEPHYR_INCLUDE_IPC_IPC_SERVICE_H_
8#define ZEPHYR_INCLUDE_IPC_IPC_SERVICE_H_
9
10#include <stdio.h>
11#include <zephyr/device.h>
12#include <zephyr/kernel.h>
13
14#ifdef __cplusplus
15extern "C" {
16#endif
17
25
34
41
137
141
154 void (*bound)(void *priv);
155
169 void (*unbound)(void *priv);
170
183 void (*received)(const void *data, size_t len, void *priv);
184
190 void (*error)(const char *message, void *priv);
191};
192
198struct ipc_ept {
199
201 const struct device *instance;
202
204 void *token;
205};
206
209
211 const char *name;
212
214 int prio;
215
218
220 void *priv;
221};
222
237int ipc_service_open_instance(const struct device *instance);
238
256int ipc_service_close_instance(const struct device *instance);
257
278int ipc_service_register_endpoint(const struct device *instance,
279 struct ipc_ept *ept,
280 const struct ipc_ept_cfg *cfg);
281
299
318int ipc_service_send(struct ipc_ept *ept, const void *data, size_t len);
319
348int ipc_service_send_critical(struct ipc_ept *ept, const void *data, size_t len);
349
367
415int ipc_service_get_tx_buffer(struct ipc_ept *ept, void **data, uint32_t *size, k_timeout_t wait);
416
437int ipc_service_drop_tx_buffer(struct ipc_ept *ept, const void *data);
438
471int ipc_service_send_nocopy(struct ipc_ept *ept, const void *data, size_t len);
472
496int ipc_service_hold_rx_buffer(struct ipc_ept *ept, void *data);
497
522int ipc_service_release_rx_buffer(struct ipc_ept *ept, void *data);
523
527
528#ifdef __cplusplus
529}
530#endif
531
532#endif /* ZEPHYR_INCLUDE_IPC_IPC_SERVICE_H_ */
int ipc_service_deregister_endpoint(struct ipc_ept *ept)
Deregister an IPC endpoint from its instance.
int ipc_service_drop_tx_buffer(struct ipc_ept *ept, const void *data)
Drop and release a TX buffer.
int ipc_service_get_tx_buffer_size(struct ipc_ept *ept)
Get the TX buffer size.
int ipc_service_send_nocopy(struct ipc_ept *ept, const void *data, size_t len)
Send data in a TX buffer reserved by ipc_service_get_tx_buffer using the given IPC endpoint.
int ipc_service_close_instance(const struct device *instance)
Close an instance.
int ipc_service_send_critical(struct ipc_ept *ept, const void *data, size_t len)
Send a high-priority message bypassing normal state checks.
int ipc_service_get_tx_buffer(struct ipc_ept *ept, void **data, uint32_t *size, k_timeout_t wait)
Get an empty TX buffer to be sent using ipc_service_send_nocopy.
int ipc_service_register_endpoint(const struct device *instance, struct ipc_ept *ept, const struct ipc_ept_cfg *cfg)
Register IPC endpoint onto an instance.
int ipc_service_send(struct ipc_ept *ept, const void *data, size_t len)
Send data using given IPC endpoint.
int ipc_service_hold_rx_buffer(struct ipc_ept *ept, void *data)
Holds the RX buffer for usage outside the receive callback.
int ipc_service_release_rx_buffer(struct ipc_ept *ept, void *data)
Release the RX buffer for future reuse.
int ipc_service_open_instance(const struct device *instance)
Open an instance.
Public kernel APIs.
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
Runtime device structure (in ROM) per driver instance.
Definition device.h:513
Endpoint configuration structure.
Definition ipc_service.h:208
struct ipc_service_cb cb
Event callback structure.
Definition ipc_service.h:217
void * priv
Private user data.
Definition ipc_service.h:220
const char * name
Name of the endpoint.
Definition ipc_service.h:211
int prio
Endpoint priority.
Definition ipc_service.h:214
Endpoint instance.
Definition ipc_service.h:198
void * token
Backend-specific token used to identify an endpoint in an instance.
Definition ipc_service.h:204
const struct device * instance
Instance this endpoint belongs to.
Definition ipc_service.h:201
Event callback structure.
Definition ipc_service.h:147
void(* bound)(void *priv)
Bind was successful.
Definition ipc_service.h:154
void(* received)(const void *data, size_t len, void *priv)
New packet arrived.
Definition ipc_service.h:183
void(* unbound)(void *priv)
The endpoint unbound by the remote.
Definition ipc_service.h:169
void(* error)(const char *message, void *priv)
An error occurred.
Definition ipc_service.h:190
Kernel timeout type.
Definition clock.h:65