ra8-firmware/ra8__npu__loader_8h_source.html

#pragma once


#include <stdint.h>


#include "ra8_device.h"

#include "ra8_err.h"


#ifndef RA8_HAS_NPU

#error "ra8_npu_loader.h included on a device without an NPU (RA8P1-only)."

#endif


#include "ra8_npu.h"


#ifdef __cplusplus

extern "C" {

#endif


typedef struct {

  uint8_t* base;

  uint32_t bytes;

} ra8_npu_arena_t;


[[nodiscard]] ra8_err_t ra8_npu_load(const void*            blob,

                                     uint32_t               blob_bytes,

                                     const ra8_npu_arena_t* arena,

                                     ra8_npu_job_t*         out_job);


#ifdef __cplusplus

}

#endif

ra8_device.h
Compile-time device selection for the RA8 multi-chip build (RA8D2 / RA8P1).

ra8_err.h
Error Code Definitions for ra8-firmware.

ra8_err_t
ra8_err_codes_t ra8_err_t
Canonical error-return type used by every ra8-firmware API.
Definition ra8_err.h:546

ra8_npu.h
Arm Ethos-U55 NPU command/queue driver foundation (RA8P1-only).

ra8_npu_load
ra8_err_t ra8_npu_load(const void *blob, uint32_t blob_bytes, const ra8_npu_arena_t *arena, ra8_npu_job_t *out_job)
Validate a .npub blob and map it into an ra8_npu_job_t.

ra8_npu_arena_t
Caller-provided runtime arena for a model's RUNTIME regions.
Definition ra8_npu_loader.h:78

ra8_npu_arena_t::bytes
uint32_t bytes
Runtime arena capacity in bytes (0 if no runtime rgn).
Definition ra8_npu_loader.h:80

ra8_npu_arena_t::base
uint8_t * base
Runtime arena base in NPU-visible SRAM (writable).
Definition ra8_npu_loader.h:79

ra8_npu_job_t
One Ethos-U55 inference job: a command stream plus its tensor arenas.
Definition ra8_npu.h:87