From 21842729ae6d2dac4218cf35ed4f146ab09de1cc Mon Sep 17 00:00:00 2001 From: ZIFENG278 Date: Mon, 20 Oct 2025 15:24:25 +0800 Subject: [PATCH] docs: split a733 and t527 command in Allwinner NPU docs Signed-off-by: ZIFENG278 --- docs/common/ai/_cubie_acuity_usage.mdx | 34 ++++++--- docs/common/ai/_cubie_lenet.mdx | 93 +++++++++++++++++++------ docs/common/ai/_cubie_resnet50.mdx | 93 +++++++++++++++++++------ docs/common/ai/_cubie_vpm_run.mdx | 61 ++++++++++++---- docs/common/ai/_cubie_yolact.mdx | 61 ++++++++++++---- docs/common/ai/_cubie_yolov5.mdx | 96 ++++++++++++++++++++------ 6 files changed, 342 insertions(+), 96 deletions(-) diff --git a/docs/common/ai/_cubie_acuity_usage.mdx b/docs/common/ai/_cubie_acuity_usage.mdx index 85595b0db..8cc66d03b 100644 --- a/docs/common/ai/_cubie_acuity_usage.mdx +++ b/docs/common/ai/_cubie_acuity_usage.mdx @@ -6,6 +6,7 @@ | --------- | ------ | ---- | -------- | ------------ | | Radxa A5E | 2 Tops | T527 | v2 | v1.13 | | Radxa A7A | 3 Tops | A733 | v3 | v2.0 | +| Radxa A7Z | 3 Tops | A733 | v3 | v2.0 | {/* ## 配置环境变量 */} {/* - 初始化 ACUITY pegasus.py 脚本 */} @@ -49,18 +50,35 @@ git clone https://github.com/ZIFENG278/ai-sdk.git 配置模型编译脚本 - + + -```bash -cd ai-sdk/models -source env.sh v3 # NPU_VERSION -cp ../scripts/* . -``` + + ```bash + cd ai-sdk/models + source env.sh v3 # NPU_VERSION + cp ../scripts/* . + ``` + - + + + + + + ```bash + cd ai-sdk/models + source env.sh v2 # NPU_VERSION + cp ../scripts/* . + ``` + + + + + :::tip -指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v1.13`。 信息对照请参考 [NPU 版本对照表](#npu-版本对照表) +指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [NPU 版本对照表](#npu-版本对照表) ::: ## 模型解析 diff --git a/docs/common/ai/_cubie_lenet.mdx b/docs/common/ai/_cubie_lenet.mdx index f6e6f3381..e16c74424 100644 --- a/docs/common/ai/_cubie_lenet.mdx +++ b/docs/common/ai/_cubie_lenet.mdx @@ -33,18 +33,36 @@ LeNet 示例所使用的文件已经包含在[ai-sdk 示例仓库](https://githu 配置环境变量 - + - ```bash - cd ai-sdk/models - source env.sh v3 #NPU_VERSION - ``` + - + + ```bash + cd ai-sdk/models + source env.sh v3 # NPU_VERSION + cp ../scripts/* . + ``` + + + + + + + + ```bash + cd ai-sdk/models + source env.sh v2 # NPU_VERSION + cp ../scripts/* . + ``` + + + + + - A733 选择 `v3`, T527 选择 `v2` :::tip - NPU 版本选择请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) + 指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [**NPU 版本对照表**](cubie_acuity_usage#npu-版本对照表) ::: - 进入 lenet 模型目录 @@ -218,14 +236,32 @@ cd ai-sdk/examples/lenet ### 编译示例 - + + -```bash -make AI_SDK_PLATFORM=a733 -make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ -``` + - + ```bash + make AI_SDK_PLATFORM=a733 + make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ + ``` + + + + + + + + + ```bash + make AI_SDK_PLATFORM=t527 + make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./ + ``` + + + + + 参数解析： @@ -237,13 +273,30 @@ make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ 导入环境变量 - + + -```bash -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION -``` + - + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION + ``` + + + + + + + + + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION + ``` + + + + + :::tip 指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) @@ -254,7 +307,7 @@ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch ```bash -cd INSTALL_PREFIX/etc/npu/lenet +cd $INSTALL_PREFIX/etc/npu/lenet # ./lenet nbg_model input_picture ./lenet ./model/lenet.nb ./input_data/lenet.dat ``` diff --git a/docs/common/ai/_cubie_resnet50.mdx b/docs/common/ai/_cubie_resnet50.mdx index effb33156..6ed1c4a37 100644 --- a/docs/common/ai/_cubie_resnet50.mdx +++ b/docs/common/ai/_cubie_resnet50.mdx @@ -31,18 +31,36 @@ Radxa 已提供预转换好的 `resnet50.nb` 模型，用户可直接参考 [** 配置环境变量 - + - ```bash - cd ai-sdk/models - source env.sh v3 #NPU_VERSION - ``` + + + + ```bash + cd ai-sdk/models + source env.sh v3 # NPU_VERSION + cp ../scripts/* . + ``` + + + + + + + + ```bash + cd ai-sdk/models + source env.sh v2 # NPU_VERSION + cp ../scripts/* . + ``` + + + - + - A733 选择 `v3`, T527 选择 `v2` :::tip - NPU 版本选择请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) + 指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [**NPU 版本对照表**](cubie_acuity_usage#npu-版本对照表) ::: - 下载 resnet50 onnx 模型 @@ -263,14 +281,32 @@ cd ai-sdk/examples/resnet50 ### 编译示例 - + + -```bash -make AI_SDK_PLATFORM=a733 -make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ -``` + - + ```bash + make AI_SDK_PLATFORM=a733 + make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ + ``` + + + + + + + + + ```bash + make AI_SDK_PLATFORM=t527 + make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./ + ``` + + + + + 参数解析： @@ -282,13 +318,30 @@ make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ 导入环境变量 - + + -```bash -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION -``` + - + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION + ``` + + + + + + + + + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION + ``` + + + + + :::tip 指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) @@ -299,7 +352,7 @@ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch ```bash -cd INSTALL_PREFIX/etc/npu/resnet50 +cd $INSTALL_PREFIX/etc/npu/resnet50 # ./resnet50 nbg_model input_picture ./resnet50 model/resnet50.nb ./input_data/dog_224_224.jpg ``` diff --git a/docs/common/ai/_cubie_vpm_run.mdx b/docs/common/ai/_cubie_vpm_run.mdx index 073d4cedb..617c098d4 100644 --- a/docs/common/ai/_cubie_vpm_run.mdx +++ b/docs/common/ai/_cubie_vpm_run.mdx @@ -32,14 +32,32 @@ cd ai-sdk/examples/vpm_run ### 编译示例 - + + -```bash -make AI_SDK_PLATFORM=a733 -make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ -``` + - + ```bash + make AI_SDK_PLATFORM=a733 + make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ + ``` + + + + + + + + + ```bash + make AI_SDK_PLATFORM=t527 + make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./ + ``` + + + + + 参数解析： @@ -72,17 +90,34 @@ example: ./vpm_run -s sample.txt -l 10 -d 1 specify the NBG runs 10 times on dev - 导入环境变量 + + + - ```bash - export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION - ``` + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION + ``` - :::tip - 指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) - ::: + + + + + + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION + ``` + + + + + + +:::tip +指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) +::: - 制作配置文件 @@ -120,7 +155,7 @@ example: ./vpm_run -s sample.txt -l 10 -d 1 specify the NBG runs 10 times on dev ```bash - cd INSTALL_PREFIX/etc/npu/vpm_ru + cd $INSTALL_PREFIX/etc/npu/vpm_run ./vpm_run -s sample.txt -l 1 ``` diff --git a/docs/common/ai/_cubie_yolact.mdx b/docs/common/ai/_cubie_yolact.mdx index 3106b147a..d31bcc2e0 100644 --- a/docs/common/ai/_cubie_yolact.mdx +++ b/docs/common/ai/_cubie_yolact.mdx @@ -31,14 +31,32 @@ cd ai-sdk/examples/yolact ### 编译示例 - + + -```bash -make AI_SDK_PLATFORM=a733 -make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ -``` + - + ```bash + make AI_SDK_PLATFORM=a733 + make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ + ``` + + + + + + + + + ```bash + make AI_SDK_PLATFORM=t527 + make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./ + ``` + + + + + 参数解析： @@ -48,15 +66,32 @@ make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ ### 运行示例 -- 导入环境变量 +导入环境变量 - + + -```bash -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION -``` + - + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION + ``` + + + + + + + + + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION + ``` + + + + + :::tip 指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) @@ -67,7 +102,7 @@ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch ```bash -cd INSTALL_PREFIX/etc/npu/yolact +cd $INSTALL_PREFIX/etc/npu/yolact # ./yolact nbg_model input_picture ./yolact ./model/yolact.nb ./input_data/dog_550_550.jpg ``` diff --git a/docs/common/ai/_cubie_yolov5.mdx b/docs/common/ai/_cubie_yolov5.mdx index dbf900e21..9525bc8d0 100644 --- a/docs/common/ai/_cubie_yolov5.mdx +++ b/docs/common/ai/_cubie_yolov5.mdx @@ -35,18 +35,36 @@ yolov5 示例所使用的文件已经包含在[ai-sdk 示例仓库](https://gith 配置环境变量 - + - ```bash - cd ai-sdk/models - source env.sh v3 #NPU_VERSION - ``` + + + + ```bash + cd ai-sdk/models + source env.sh v3 # NPU_VERSION + cp ../scripts/* . + ``` + + + + + + + + ```bash + cd ai-sdk/models + source env.sh v2 # NPU_VERSION + cp ../scripts/* . + ``` + + + - + - A733 选择 `v3`, T527 选择 `v2` :::tip - NPU 版本选择请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) + 指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [**NPU 版本对照表**](cubie_acuity_usage#npu-版本对照表) ::: - 下载 yolov5s onnx 模型 @@ -252,14 +270,32 @@ cd ai-sdk/examples/yolov5 ### 编译示例 - + + -```bash -make AI_SDK_PLATFORM=a733 -make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ -``` + - + ```bash + make AI_SDK_PLATFORM=a733 + make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ + ``` + + + + + + + + + ```bash + make AI_SDK_PLATFORM=t527 + make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./ + ``` + + + + + 参数解析： @@ -271,16 +307,33 @@ make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./ 导入环境变量 - + + -```bash -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION -``` + - + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION + ``` + + + + + + + + + ```bash + export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION + ``` + + + + + :::tip -指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表) +指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [**NPU 版本对照表**](./cubie_acuity_usage#npu-版本对照表) ::: 进入示例安装目录 @@ -288,8 +341,7 @@ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch ```bash -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION -cd INSTALL_PREFIX/etc/npu/yolov5 +cd $INSTALL_PREFIX/etc/npu/yolov5 # ./yolov5 nbg_model input_picture ./yolov5 ./model/yolov5.nb ./input_data/dog.jpg ```