docs.rs failed to build cann-0.1.1
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Visit the last successful build: cann-0.0.0

cann-rs

Huawei Ascend CANN NPU SDK 的 Rust 绑定与安全封装。

项目结构

cann-rs/
├── cann-sys/    # 原始 FFI 绑定（零外部依赖，链接 libascendcl.so）
└── cann/        # 安全 Rust 封装（类型安全、错误处理）

环境要求

Linux（aarch64 / x86_64）
CANN SDK 8.x 或 9.x（通过 ASCEND_TOOLKIT_HOME 环境变量指定安装路径）
NPU 驱动（版本查询功能需要）

安装

# Cargo.toml
[dependencies]
cann = "0.1"

或仅使用 FFI 绑定层：

cann-sys = { version = "0.1", features = ["ffi"] }

快速开始

use cann::version::Version;

fn main() {
    match Version::str() {
        Ok(v) => println!("CANN 版本: {}", v),
        Err(e) => println!("CANN 版本: 未检测到 ({})", e),
    }
    match Version::num() {
        Ok(n) => println!("CANN 版本号: {}", n),
        Err(e) => println!("CANN 版本号: 未检测到 ({})", e),
    }
}

API

`cann` crate

类型	说明
`Version::str() -> Result<String, Error>`	查询 CANN 版本字符串（如 `"9.0.0"`）
`Version::num() -> Result<i32, Error>`	查询 CANN 版本号（如 `90_000_000`）
`Error { code, message }`	CANN 操作错误

`cann-sys` crate

项目	说明
`aclError`	ACL 返回码类型
`ACL_SUCCESS` / `ACL_ERROR_*`	错误码常量
`aclsysGetVersionStr`	FFI：查询版本字符串
`aclsysGetVersionNum`	FFI：查询版本号（整数）
`aclrtGetVersion`	FFI：查询运行时组件版本

特性

`ffi` 特性

cann-sys 的 ffi 特性控制是否链接 libascendcl.so 并暴露 FFI 函数声明。

启用：链接原生库，可调用版本查询等 FFI 函数
关闭（默认）：仅提供类型和常量定义，无需 NPU 驱动即可编译

注意事项

版本查询（aclsysGetVersionStr / aclsysGetVersionNum）需要 NPU 驱动支持
无驱动时返回 Err(Error)，Error.message 包含中文描述
无 CANN SDK 时编译失败，build.rs 会打印搜索路径和提示

SDK 路径检测顺序

ASCEND_TOOLKIT_HOME 环境变量
ASCEND_HOME_PATH 环境变量
ASCEND_HOME 环境变量
$HOME/Ascend/cann
/usr/local/Ascend

License

MIT OR Apache-2.0

cann 0.1.1