Mirrors_Framework/open-amp
1
0
Fork 0
mirror of https://github.com/OpenAMP/open-amp.git synced 2026-09-26 12:28:32 +08:00
Code Issues Packages Projects Releases Wiki Activity

rpmsg: Add rpmsg_release_tx_buffer API

Browse Source 
Add an API to be able to release unused TX buffer that will not be
sent.
For instance this API can be called in case of error between the
buffer reservation and the send to the remote side.

Signed-off-by: Arnaud Pouliquen <arnaud.pouliquen@foss.st.com>
This commit is contained in:
Arnaud Pouliquen
2022-10-18 10:31:19 +02:00
committed by Arnaud Pouliquen
parent 988da0074d
commit 4e1fa03814
3 changed files with 46 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/include/openamp/rpmsg.h
+25
View File
@@ -42,6 +42,7 @@ extern "C" {
#define RPMSG_ERR_BUFF_SIZE (RPMSG_ERROR_BASE - 5)
#define RPMSG_ERR_INIT (RPMSG_ERROR_BASE - 6)
#define RPMSG_ERR_ADDR (RPMSG_ERROR_BASE - 7)
#define RPMSG_ERR_PERM (RPMSG_ERROR_BASE - 8)
struct rpmsg_endpoint;
struct rpmsg_device;
@@ -87,6 +88,7 @@ struct rpmsg_endpoint {
* @release_rx_buffer: release RPMsg RX buffer
* @get_tx_payload_buffer: get RPMsg TX buffer
* @send_offchannel_nocopy: send RPMsg data without copy
* @release_tx_buffer: release RPMsg TX buffer
*/
struct rpmsg_device_ops {
int (*send_offchannel_raw)(struct rpmsg_device *rdev,
@@ -99,6 +101,7 @@ struct rpmsg_device_ops {
int (*send_offchannel_nocopy)(struct rpmsg_device *rdev,
uint32_t src, uint32_t dst,
const void *data, int len);
int (*release_tx_buffer)(struct rpmsg_device *rdev, void *txbuf);
};
/**
@@ -346,6 +349,28 @@ void rpmsg_release_rx_buffer(struct rpmsg_endpoint *ept, void *rxbuf);
void *rpmsg_get_tx_payload_buffer(struct rpmsg_endpoint *ept,
uint32_t *len, int wait);
/**
* @brief Releases unused buffer.
*
* This API can be called when the Tx buffer reserved by rpmsg_get_tx_payload_buffer
* needs to be released without having been sent to the remote side.
*
* Note that the rpmsg virtio is not able to detect if a buffer has already been released.
* The user must prevent a double release (e.g. by resetting its buffer pointer to zero after
* the release).
*
* @ept: the rpmsg endpoint
* @txbuf: tx buffer with message payload
*
* @return:
* - RPMSG_SUCCESS on success
* - RPMSG_ERR_PARAM on invalid parameter
* - RPMSG_ERR_PERM if service not implemented
*
* @see rpmsg_get_tx_payload_buffer
*/
int rpmsg_release_tx_buffer(struct rpmsg_endpoint *ept, void *txbuf);
/**
* rpmsg_send_offchannel_nocopy() - send a message in tx buffer reserved by
* rpmsg_get_tx_payload_buffer() across to the remote processor.