Skip to content

docs: add allwinner model zoo docs for cubie series #1641

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
Milir-Radxa merged 5 commits into from
Apr 10, 2026
Merged

docs: add allwinner model zoo docs for cubie series #1641

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
95a0e76
docs: add allwinner model zoo docs for cubie series
Ronin-1124 Apr 9, 2026
d09f126
docs: fix deploy issues and sidebar order for cubie npu docs
Ronin-1124 Apr 10, 2026
422ae03
docs: add allwinner model zoo docs for cubie a5e
Ronin-1124 Apr 10, 2026
832eb8d
docs: fix github checks issues
Ronin-1124 Apr 10, 2026
39fb431
docs: correct model zoo download link from dl.radxa
Ronin-1124 Apr 10, 2026
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
148 changes: 65 additions & 83 deletions docs/common/ai/_cubie_acuity_env.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,11 @@ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyring
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
```

Expand All @@ -54,108 +55,89 @@ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin
由于SDK版本兼容问题，需要根据NPU进行不同的选择
:::

<Tabs>

<TabItem value="A733">

### 获取 ACUITY 下载包

在 [全志网盘](https://netstorage.allwinnertech.com:5001/sharing/Mh23BhPHq) 下载 ACUITY docker 压缩包并解压
<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
unzip docker_images_v2.0.x.zip
```
</NewCodeBlock>
### 载入镜像

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

```bash
cd docker_images_v2.0.x
unzip ubuntu-npu_v2.0.10.tar.zip
sudo docker load -i ubuntu-npu_v2.0.10.tar
```

</NewCodeBlock>

当 docker 镜像载入完成后可以在 `docker images` 中看到此镜像， 名字为 `ubuntu‑npu:v2.0.10`

### 创建 docker 容器

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

```bash
mkdir docker_data && cd docker_data
sudo docker run --ipc=host -itd -v ${PWD}:/workspace --name allwinner_v2.0.10 ubuntu-npu:v2.0.10 /bin/bash
```

</NewCodeBlock>
### 获取 ACUITY 下载包

当 docker 容器创建完成后可以在 `docker ps -a` 中看到此容器， 名字为 `allwinner_v2.0.10`
在 [全志网盘](https://netstorage.allwinnertech.com:5001/sharing/Mh23BhPHq) 下载 ACUITY docker 压缩包并解压

### 进入 docker 容器

请使用 `docker ps -a` 查看 `allwinner_v2.0.10` 容器 ID
<Tabs groupId="npu-type">
<TabItem value="A733">
<NewCodeBlock tip="X86 Linux PC" type="PC">

<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
unzip docker_images_v2.0.x.zip
```

```bash
sudo docker exec -it 容器ID /bin/bash
```
</NewCodeBlock>
</TabItem>
<TabItem value="T527">
<NewCodeBlock tip="X86 Linux PC" type="PC">

</NewCodeBlock>
```bash
unzip docker_images_v1.8.x.zip
```

</TabItem>
</NewCodeBlock>
</TabItem>
</Tabs>

<TabItem value="T527">
### 载入镜像

### 获取 ACUITY 下载包
<Tabs groupId="npu-type">
<TabItem value="A733">
<NewCodeBlock tip="X86 Linux PC" type="PC">

在 [全志网盘](https://netstorage.allwinnertech.com:5001/sharing/N6TVlZQVZ) 下载 ACUITY docker 压缩包并解压
<NewCodeBlock tip="X86 Linux PC" type="PC">
```bash
unzip docker_images_v1.8.x.zip
```
</NewCodeBlock>
### 载入镜像
```bash
cd docker_images_v2.0.x unzip ubuntu-npu_v2.0.10.1.tar.zip sudo docker load -i ubuntu-npu_v2.0.10.1.tar
```

<NewCodeBlock tip="X86 Linux PC" type="PC">
</NewCodeBlock>
</TabItem>
<TabItem value="T527">
<NewCodeBlock tip="X86 Linux PC" type="PC">

```bash
cd docker_images_v1.8.x
unzip ubuntu-npu_v1.8.11.tar.zip
sudo docker load -i ubuntu-npu_v1.8.11.tar
```
```bash
cd docker_images_v1.8.x unzip ubuntu-npu_v1.8.11.tar.zip sudo docker load -i ubuntu-npu_v1.8.11.tar
```

</NewCodeBlock>
</NewCodeBlock>
</TabItem>
</Tabs>

当 docker 镜像载入完成后可以在 `docker images` 中看到此镜像， 名字为 `ubuntu-npu:v1.8.11`
当 docker 镜像载入完成后可以在 `docker images` 中看到此镜像， 名字为 `ubuntu‑npu:v2.0.10.1` (A733) 或 `ubuntu-npu:v1.8.11` (T527)

### 创建 docker 容器
### 创建 docker 容器

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

```bash
mkdir docker_data && cd docker_data
sudo docker run --ipc=host -itd -v ${PWD}:/workspace --name allwinner_v1.8.11 ubuntu-npu:v1.8.11 /bin/bash
```
```bash
mkdir docker_data && cd docker_data sudo docker run --ipc=host -itd -v ${PWD}:/workspace --name allwinner_v2.0.10.1 ubuntu-npu:v2.0.10.1 /bin/bash
```

</NewCodeBlock>
</NewCodeBlock>
</TabItem>
<TabItem value="T527">
<NewCodeBlock tip="X86 Linux PC" type="PC">

当 docker 容器创建完成后可以在 `docker ps -a` 中看到此容器， 名字为 `allwinner_v1.8.11`
```bash
mkdir docker_data && cd docker_data sudo docker run --ipc=host -itd -v ${PWD}:/workspace --name allwinner_v1.8.11 ubuntu-npu:v1.8.11 /bin/bash
```

### 进入 docker 容器
</NewCodeBlock>
</TabItem>
</Tabs>

请使用 `docker ps -a` 查看 `allwinner_v1.8.11` 容器 ID
当 docker 容器创建完成后可以在 `docker ps -a` 中看到此容器， 名字为 `allwinner_v2.0.10.1` (A733) 或 `allwinner_v1.8.11` (T527)

<NewCodeBlock tip="X86 Linux PC" type="PC">
### 进入 docker 容器

```bash
sudo docker exec -it 容器ID /bin/bash
```
请使用 `docker ps -a` 查看容器 ID

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

</TabItem>
```bash
sudo docker exec -it 容器ID /bin/bash
```

</Tabs>
</NewCodeBlock>
Loading
Loading