Skip to content

docs: split a733 and t527 command in Allwinner NPU docs #1016

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Oct 20, 2025
Merged

docs: split a733 and t527 command in Allwinner NPU docs #1016

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 26 additions & 8 deletions docs/common/ai/_cubie_acuity_usage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 脚本 */}
Expand Down Expand Up @@ -49,18 +50,35 @@ git clone https://github.com/ZIFENG278/ai-sdk.git

配置模型编译脚本

<NewCodeBlock tip="X86 Linux PC" type="PC">
<Tabs>
<TabItem value="A733">

```bash
cd ai-sdk/models
source env.sh v3 # NPU_VERSION
cp ../scripts/* .
```
<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
cd ai-sdk/models
source env.sh v3 # NPU_VERSION
cp ../scripts/* .
```
</NewCodeBlock>

</NewCodeBlock>
</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
cd ai-sdk/models
source env.sh v2 # NPU_VERSION
cp ../scripts/* .
```
</NewCodeBlock>

</TabItem>

</Tabs>

:::tip
指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v1.13`。 信息对照请参考 [NPU 版本对照表](#npu-版本对照表)
指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [NPU 版本对照表](#npu-版本对照表)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's an inconsistency between the NPU version table and the tip section. In the table, T527 is listed with NPU software version v1.13, but in the tip section it says to specify v2 for T527. These should be consistent to avoid confusion for users.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NPU_SW_VERSION is difference with NPU_VERSION

:::

## 模型解析
Expand Down
93 changes: 73 additions & 20 deletions docs/common/ai/_cubie_lenet.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,18 +33,36 @@ LeNet 示例所使用的文件已经包含在[ai-sdk 示例仓库](https://githu

配置环境变量

<NewCodeBlock tip="X86 Linux PC" type="PC">
<Tabs>

```bash
cd ai-sdk/models
source env.sh v3 #NPU_VERSION
```
<TabItem value="A733">

</NewCodeBlock>
<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
cd ai-sdk/models
source env.sh v3 # NPU_VERSION
cp ../scripts/* .
```
</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
cd ai-sdk/models
source env.sh v2 # NPU_VERSION
cp ../scripts/* .
```
</NewCodeBlock>

</TabItem>

</Tabs>

A733 选择 `v3`, T527 选择 `v2`
:::tip
NPU 版本选择请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表)
指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [**NPU 版本对照表**](cubie_acuity_usage#npu-版本对照表)
:::

- 进入 lenet 模型目录
Expand Down Expand Up @@ -218,14 +236,32 @@ cd ai-sdk/examples/lenet

### 编译示例

<NewCodeBlock tip="Device" type="device">
<Tabs>
<TabItem value="A733">

```bash
make AI_SDK_PLATFORM=a733
make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./
```
<NewCodeBlock tip="Device" type="device">

</NewCodeBlock>
```bash
make AI_SDK_PLATFORM=a733
make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./
```

</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="Device" type="device">
```bash
make AI_SDK_PLATFORM=t527
make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./
```
</NewCodeBlock>

</TabItem>

</Tabs>

参数解析：

Expand All @@ -237,13 +273,30 @@ make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./

导入环境变量

<NewCodeBlock tip="Device" type="device">
<Tabs>
<TabItem value="A733">

```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION
```
<NewCodeBlock tip="Device" type="device">

</NewCodeBlock>
```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION
```

</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="Device" type="device">
```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION
```
</NewCodeBlock>

</TabItem>

</Tabs>

:::tip
指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表)
Expand All @@ -254,7 +307,7 @@ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch
<NewCodeBlock tip="Device" type="device">

```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
```
Expand Down
93 changes: 73 additions & 20 deletions docs/common/ai/_cubie_resnet50.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,18 +31,36 @@ Radxa 已提供预转换好的 `resnet50.nb` 模型，用户可直接参考 [**

配置环境变量

<NewCodeBlock tip="X86 Linux PC" type="PC">
<Tabs>

```bash
cd ai-sdk/models
source env.sh v3 #NPU_VERSION
```
<TabItem value="A733">

<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
cd ai-sdk/models
source env.sh v3 # NPU_VERSION
cp ../scripts/* .
```
</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
cd ai-sdk/models
source env.sh v2 # NPU_VERSION
cp ../scripts/* .
```
</NewCodeBlock>

</TabItem>

</NewCodeBlock>
</Tabs>

A733 选择 `v3`, T527 选择 `v2`
:::tip
NPU 版本选择请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表)
指定 NPU_VERSION， A733 指定 `v3`, T527 指定 `v2`。 信息对照请参考 [**NPU 版本对照表**](cubie_acuity_usage#npu-版本对照表)
:::

- 下载 resnet50 onnx 模型
Expand Down Expand Up @@ -263,14 +281,32 @@ cd ai-sdk/examples/resnet50

### 编译示例

<NewCodeBlock tip="Device" type="device">
<Tabs>
<TabItem value="A733">

```bash
make AI_SDK_PLATFORM=a733
make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./
```
<NewCodeBlock tip="Device" type="device">

</NewCodeBlock>
```bash
make AI_SDK_PLATFORM=a733
make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./
```

</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="Device" type="device">
```bash
make AI_SDK_PLATFORM=t527
make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./
```
</NewCodeBlock>

</TabItem>

</Tabs>

参数解析：

Expand All @@ -282,13 +318,30 @@ make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./

导入环境变量

<NewCodeBlock tip="Device" type="device">
<Tabs>
<TabItem value="A733">

```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/NPU_VERSION # NPU_SW_VERSION
```
<NewCodeBlock tip="Device" type="device">

</NewCodeBlock>
```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v2.0 # NPU_SW_VERSION
```

</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="Device" type="device">
```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION
```
</NewCodeBlock>

</TabItem>

</Tabs>

:::tip
指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表)
Comment on lines +327 to 347
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's an inconsistency in the NPU version information. In the A733 tab (line 327), the export command shows v2.0 as the NPU_SW_VERSION, but the tip below (line 347) also mentions v2.0 for A733. This matches, but it's inconsistent with the earlier section where A733 uses v3 for NPU_VERSION (line 41). Please verify if these should be the same version or if NPU_VERSION and NPU_SW_VERSION are intentionally different.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NPU_SW_VERSION is difference with NPU_VERSION

Expand All @@ -299,7 +352,7 @@ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch
<NewCodeBlock tip="Device" type="device">

```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
```
Expand Down
61 changes: 48 additions & 13 deletions docs/common/ai/_cubie_vpm_run.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,14 +32,32 @@ cd ai-sdk/examples/vpm_run

### 编译示例

<NewCodeBlock tip="Device" type="device">
<Tabs>
<TabItem value="A733">

```bash
make AI_SDK_PLATFORM=a733
make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./
```
<NewCodeBlock tip="Device" type="device">

</NewCodeBlock>
```bash
make AI_SDK_PLATFORM=a733
make install AI_SDK_PLATFORM=a733 INSTALL_PREFIX=./
```

</NewCodeBlock>

</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="Device" type="device">
```bash
make AI_SDK_PLATFORM=t527
make install AI_SDK_PLATFORM=t527 INSTALL_PREFIX=./
```
</NewCodeBlock>

</TabItem>

</Tabs>

参数解析：

Expand Down Expand Up @@ -72,17 +90,34 @@ example: ./vpm_run -s sample.txt -l 10 -d 1 specify the NBG runs 10 times on dev

- 导入环境变量

<Tabs>
<TabItem value="A733">

<NewCodeBlock tip="Device" type="device">

```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
```

</NewCodeBlock>

:::tip
指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表)
:::
</TabItem>

<TabItem value="T527">

<NewCodeBlock tip="Device" type="device">
```bash
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rock/ai-sdk/viplite-tina/lib/aarch64-none-linux-gnu/v1.13 # NPU_SW_VERSION
```
</NewCodeBlock>

</TabItem>

</Tabs>

:::tip
指定 NPU_SW_VERSION， A733 选择 `v2.0`, T527 选择 `v1.13`, NPU 信息对照请参考 [NPU 版本对照表](./cubie_acuity_usage#npu-版本对照表)
:::

- 制作配置文件

Expand Down Expand Up @@ -120,7 +155,7 @@ example: ./vpm_run -s sample.txt -l 10 -d 1 specify the NBG runs 10 times on dev
<NewCodeBlock tip="Device" type="device">

```bash
cd INSTALL_PREFIX/etc/npu/vpm_ru
cd $INSTALL_PREFIX/etc/npu/vpm_run
./vpm_run -s sample.txt -l 1
```

Expand Down
Loading
Loading