Zephyr Project API  3.1.0
A Scalable Open Source RTOS
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
13#ifdef __cplusplus
14extern "C" {
15#endif
16
129 void (*bound)(void *priv);
130
143 void (*received)(const void *data, size_t len, void *priv);
144
150 void (*error)(const char *message, void *priv);
151};
152
158struct ipc_ept {
159
161 const struct device *instance;
162
164 void *token;
165};
166
169
171 const char *name;
172
174 int prio;
175
178
180 void *priv;
181};
182
197int ipc_service_open_instance(const struct device *instance);
198
199
220int ipc_service_register_endpoint(const struct device *instance,
221 struct ipc_ept *ept,
222 const struct ipc_ept_cfg *cfg);
223
241int ipc_service_send(struct ipc_ept *ept, const void *data, size_t len);
242
259
306int ipc_service_get_tx_buffer(struct ipc_ept *ept, void **data, uint32_t *size, k_timeout_t wait);
307
327int ipc_service_drop_tx_buffer(struct ipc_ept *ept, const void *data);
328
360int ipc_service_send_nocopy(struct ipc_ept *ept, const void *data, size_t len);
361
385
410
415#ifdef __cplusplus
416}
417#endif
418
419#endif /* ZEPHYR_INCLUDE_IPC_IPC_SERVICE_H_ */
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_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.
__UINT32_TYPE__ uint32_t
Definition: stdint.h:90
Runtime device structure (in ROM) per driver instance.
Definition: device.h:456
Endpoint configuration structure.
Definition: ipc_service.h:168
struct ipc_service_cb cb
Definition: ipc_service.h:177
void * priv
Definition: ipc_service.h:180
const char * name
Definition: ipc_service.h:171
int prio
Definition: ipc_service.h:174
Endpoint instance.
Definition: ipc_service.h:158
void * token
Definition: ipc_service.h:164
const struct device * instance
Definition: ipc_service.h:161
Event callback structure.
Definition: ipc_service.h:122
void(* bound)(void *priv)
Bind was successful.
Definition: ipc_service.h:129
void(* received)(const void *data, size_t len, void *priv)
New packet arrived.
Definition: ipc_service.h:143
void(* error)(const char *message, void *priv)
An error occurred.
Definition: ipc_service.h:150
Kernel timeout type.
Definition: sys_clock.h:65
static fdata_t data[2]
Definition: test_fifo_contexts.c:15