ax-samples

English | 简体中文

AX-Samples

Platform	Build Status
AX650/AX8850
AX637/AX8910
AX630C
AX620Q
AX615

简介

AX-Samples 由 爱芯元智 主导开发。该项目实现了常见的 深度学习开源算法 在 爱芯元智 的 AI SoC 上的示例代码，方便社区开发者进行快速评估和适配。

已支持芯片

终端计算芯片

• AX650A / AX650N
• AX637
• AX630C / AX620Q
• AX615

车载芯片

• M57

边缘计算芯片

• AX8850N/AX8850
• AX8860

已支持开发板

开发板	图片	芯片	厂商	链接
AXera-Pi Pro		AX8850	Sipeed	Wiki
AI Pyramid		AX8850	M5Stack	文档
LLM630 Compute Kit		AX630C	M5Stack	文档
Module LLM		AX630C	M5Stack	文档

目录结构

ax-samples
├── 3rdparty/              # 第三方依赖，编译前将预编译 OpenCV 解压到此处
├── benchmark/             # 各芯片常见模型推理耗时统计
├── cmake/                 # 各芯片的编译配置（axXXX.cmake）与编译检查脚本
├── docs/                  # 编译文档（compile_*.md）、示例结果图、开发板图片
│   ├── AGENTS.md          #   面向 AI Agent 的速查（英文）：编译命令、新增模型/芯片步骤、常见坑
│   └── AGENTS_ZH.md       #   AGENTS.md 中文版
├── examples/              # 示例源码
│   ├── base/              #   通用后处理：检测、关键点、topk、坐标变换等
│   ├── utilities/         #   通用工具：命令行解析、文件读取、计时器等
│   ├── ax650/             #   AX650 / AX8850 示例
│   ├── ax637/             #   AX637 示例
│   ├── ax620e/            #   AX630C / AX620Q 示例
│   ├── ax615/             #   AX615 示例
│   └── ax8860/            #   AX8860 示例
├── toolchains/            # 交叉编译工具链 cmake 文件
└── CMakeLists.txt         # 顶层 cmake，通过 AXERA_TARGET_CHIP 选择芯片

每个芯片目录的组织方式相同：

examples/axXXX/
├── ax_<模型>_steps.cc     # 每个模型一个示例：前处理 → NPU 推理 → 后处理 → 保存结果图
├── middleware/io.hpp      # 该芯片 NPU 引擎的输入输出内存申请与释放
├── CMakeLists.txt         # 列出该芯片编译的示例程序
└── README.md              # 示例列表、运行命令与输出日志

快速上手

使用流程分三步：

1. 编译：参考 快速编译，按芯片选择对应文档，基于 cmake 交叉编译出示例程序。
2. 准备模型：从下方网盘资源获取 axmodel 和测试图片，或使用 Pulsar2 自行转换。
3. 运行：将示例程序、模型、图片拷贝到开发板，命令及输出参考各芯片示例目录下的 README（如 examples/ax650）。

示例

• examples 提供常见分类、检测、分割、姿态等深度学习开源算法和传统 CV 操作用例，根据 issue 需求持续更新。

网盘资源

• 提供 ModelZoo, 预编译程序, 测试图片 等内容:
  • Huggingface
  • Modelscope

速度评估

• Benchmark 常见开源模型推理耗时统计，基于 AXera-Pi Pro 实测。

关联项目

• NPU工具链在线文档，其中提供了NPU工具链相关使用说明和获取方式（更新不及时）
  • Pulsar2在线文档(Support AX650A/AX650N/AX630C/AX620Q)
• 更推荐直接从下面获取最新 Pulsar2 工具链及文档
  • Pulsar2 下载

技术讨论

• Github issues
• QQ 群: 139953715