228 uint32_t frame_bytes);
258 const uint8_t** out_ptr);
Error Code Definitions for ra8-firmware.
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
ra8_err_t ra8_vsource_xip_ptr(const ra8_vsource_t *vs, uint32_t object_id, uint64_t offset, uint32_t len, const uint8_t **out_ptr)
Get a direct pointer into an XIP object (no copy, no cache).
ra8_err_t ra8_vsource_loader(void *ctx, uint32_t object_id, uint64_t offset, uint8_t *frame, uint32_t frame_bytes)
Fill a page frame from an object – the ra8_vmem_loader_fn adapter.
ra8_err_t ra8_vsource_add_paged(ra8_vsource_t *vs, ra8_vsource_read_fn read, void *ctx, uint64_t base, uint64_t size, uint32_t *out_id)
Register a storage-paged object; returns its object_id.
ra8_err_t(* ra8_vsource_read_fn)(void *ctx, uint64_t offset, uint8_t *buf, uint32_t len)
Read len bytes at offset from a paged object's backing.
ra8_err_t ra8_vsource_add_xip(ra8_vsource_t *vs, const uint8_t *xip_base, uint64_t size, uint32_t *out_id)
Register an execute-in-place (memory-mapped) object; returns its id.
ra8_err_t ra8_vsource_init(ra8_vsource_t *vs, ra8_vsource_obj_t *objs, uint32_t cap)
Initialise an empty source registry over a caller-owned object array.
One registered object's backing (paged or XIP).
ra8_vsource_read_fn read
Paged read callback (NULL for an XIP object).
void * ctx
Context passed to read.
uint64_t size
Object length in bytes.
uint64_t base
Paged: absolute base offset of the object.
const uint8_t * xip
XIP base pointer (NULL for a paged object).
Object-source registry (caller-owned; treat as private).
uint32_t count
Registered objects (next id == count).
uint32_t cap
Slot capacity.
ra8_vsource_obj_t * objs
cap object slots (caller-owned).