Skip to main content

rs_rknn/
lib.rs

1//! Rust bindings for Rockchip RKNN Runtime API.
2//!
3//! API version is selected by Cargo features (default: **1.6** / `api-1_6`).
4//!
5//! # Features
6//!
7//! | Feature | Meaning |
8//! |---------|---------|
9//! | `api-1_6` (default) | rknn-toolkit2 **1.6** headers |
10//! | `link` (default) | Link `librknnrt` on Linux aarch64/arm |
11//! | `libloading` | Load `librknnrt` at runtime (`RKNN_LIB` / `RKNN_LIB_DIR`) |
12//! | `bindgen` | Regenerate FFI at build time (needs libclang) |
13//!
14//! # Linking
15//!
16//! Set `RKNN_LIB_DIR` when linking. With `libloading`, set `RKNN_LIB` to the `.so` path.
17
18#![allow(clippy::missing_safety_doc)]
19
20pub mod context;
21pub mod error;
22pub mod ffi;
23pub mod mem;
24pub mod sys;
25pub mod types;
26
27#[cfg(feature = "libloading")]
28pub mod dynlib;
29
30pub use context::{IoCache, RknnContext};
31pub use error::{Error, Result};
32pub use mem::{TensorMem, ZeroCopyBuffers};
33pub use types::{
34    rknn_core_mask, rknn_input_output_num, rknn_tensor_format, rknn_tensor_type, InitFlags,
35    InputBuffer, InputDynamicRange, MemSize, RunOptions, SdkVersion, TensorAttr,
36    RKNN_FLAG_ASYNC_MASK, RKNN_FLAG_PRIOR_HIGH, RKNN_NPU_CORE_0, RKNN_NPU_CORE_0_1,
37    RKNN_NPU_CORE_0_1_2, RKNN_NPU_CORE_1, RKNN_NPU_CORE_2, RKNN_NPU_CORE_AUTO, RKNN_TENSOR_FLOAT32,
38    RKNN_TENSOR_NCHW, RKNN_TENSOR_NHWC,
39};
40
41/// Selected RKNN API version string (matches the enabled `api-*` feature).
42#[cfg(feature = "api-1_6")]
43pub const RKNN_API_VERSION: &str = "1.6";