Enum Error 

pub enum Error {
    LibraryNotFound(String),
    SymbolNotFound(String),
    InitFailed(i32),
    QueryFailed(i32),
    InferenceFailed(i32),
    MemAllocFailed,
    MemSyncFailed(i32),
    SetIoMemFailed(i32),
    InvalidModel,
    InvalidIndex {
        requested: usize,
        available: usize,
    },
    InvalidFormat {
        expected: &'static str,
        got: String,
    },
    IoError(Error),
}

Everything that can go wrong when using RKNN.

Most variants carry the RKNN error code (a negative i32). The RKNN SDK doesn’t document specific codes, but common ones are:

• -1 - generic failure
• -2 - invalid parameter
• -3 - device not found

Example

use rknn_runtime::{RknnModel, Error};

match RknnModel::load("model.rknn") {
    Ok(model) => println!("Loaded!"),
    Err(Error::LibraryNotFound(path)) => {
        eprintln!("RKNN library not found at: {}", path);
        eprintln!("Make sure librknnmrt.so is installed on the device.");
    }
    Err(e) => eprintln!("Error: {}", e),
}

Variants

LibraryNotFound(String)

librknnmrt.so could not be loaded. Contains the attempted path.

SymbolNotFound(String)

A required function was not found in the loaded library.

InitFailed(i32)

rknn_init() failed. The model file may be corrupt or incompatible.

QueryFailed(i32)

rknn_query() failed when reading tensor metadata.

InferenceFailed(i32)

rknn_run() failed during inference.

MemAllocFailed

NPU memory allocation returned null.

MemSyncFailed(i32)

rknn_mem_sync() failed. Cache sync between NPU and CPU did not complete.

SetIoMemFailed(i32)

rknn_set_io_mem() failed when binding a memory buffer to a tensor.

InvalidModel

The model data is empty or invalid.

InvalidIndex

Output index is out of range.

Fields

requested: usize

The index that was requested.

available: usize

How many outputs the model actually has.

InvalidFormat

Tensor format or shape does not match what was expected.

Fields

expected: &'static str

What was expected (e.g. “NC1HWC2”).

got: String

What was actually found.

IoError(Error)

File I/O error (e.g. model file not found).

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

Just display the error message.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

Allow chaining

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for Error

Convert std::io::Error into crate’s Error type.

fn from(e: Error) -> Self

Converts to this type from the input type.