29static const char*
const s_tag =
"ra8_io_stream_ram";
63 const uint32_t room = st->
cap - st->
len;
64 const bool fits = (len <= room);
65 const uint32_t accepted = fits ? len : room;
68 if (out_written !=
nullptr) {
69 *out_written = accepted;
101 *out_used = state->
len;
static const char * s_tag
Logging / check tag.
Annotation-attribute framework macros for ra8-firmware.
#define RA8_INTERNAL
Marker that a function is intended to be static (file-local).
Validation and Error-Checking Macros for ra8-firmware.
#define RA8_CHECK_NULL_PTR(ptr, tag, message)
Reject nullptr pointer, returning k_ra8_err_null_ptr.
Error Code Definitions for ra8-firmware.
@ k_ra8_err_no_mem
Static buffer exhausted (no dynamic memory on this project).
@ k_ra8_ok
Success – operation completed with all postconditions satisfied.
@ k_ra8_err_invalid_size
Invalid size parameter (too large, too small, or misaligned).
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
void * memcpy(void *dst, const void *src, size_t n)
Copy memory area between non-overlapping regions.
static const ra8_io_blockdev_iface_t s_ram_iface
RAM backend vtable.
struct ra8_io_stream_iface ra8_io_stream_iface_t
Public implementer contract for ra8_io byte-stream backends.
ra8_err_t ra8_io_stream_bind(ra8_io_stream_t *stream, const ra8_io_stream_iface_t *iface, void *context)
Bind a backend vtable and caller-owned state into a stream handle.
static ra8_err_t internal_ram_write(void *ctx, const uint8_t *buf, uint32_t len, uint32_t *out_written)
RAM sink: append bytes into the caller buffer.
ra8_err_t ra8_io_stream_ram_used(const ra8_io_stream_ram_state_t *state, uint32_t *out_used)
Report how many bytes have been captured into the RAM sink.
ra8_err_t ra8_io_stream_ram_init(ra8_io_stream_t *s, ra8_io_stream_ram_state_t *state, uint8_t *buf, uint32_t cap)
Bind a RAM stream sink into a caller-owned stream handle.
ra8_io byte-stream sink over a caller-owned RAM buffer.
static ra8_err_t internal_ram_write(void *context, const uint8_t *data, uint16_t length, uint16_t *written)
Append one complete transfer fragment to private RAM storage.
Caller-owned private state for a RAM stream sink.
uint32_t len
Bytes captured so far (private).
uint8_t * buf
Caller-owned capture buffer (private).
uint32_t cap
Buffer capacity in bytes (private).
Caller-allocated byte-stream handle binding a sink to its context.