ACUITY Toolkit Environment Configuration
ACUITY Toolkit is installed as a Docker image. Before installing ACUITY, install Docker on your X86 PC.
Install Docker
Install Docker on your X86 PC according to your platform. For more Docker installation instructions, refer to docker docs
Ubuntu is used as an example below.
Uninstall old versions of Docker
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done
Configure the Docker APT repository
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
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
sudo apt-get update
Install Docker
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Install ACUITY
Due to SDK version compatibility, you need to choose the appropriate package based on your NPU.
Get the ACUITY Package
- A733
- T527
Download the ACUITY Docker archive from Allwinner Netdisk and extract it.
unzip docker_images_v2.0.x.zip
Download the ACUITY Docker archive from Allwinner Netdisk and extract it.
unzip docker_images_v1.8.x.zip
Load the Image
- A733
- T527
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
cd docker_images_v1.8.x
unzip ubuntu-npu_v1.8.11.tar.zip
sudo docker load -i ubuntu-npu_v1.8.11.tar
After the Docker image is loaded, you can see it with docker images. The image name is ubuntu‑npu:v2.0.10.1 (A733) or ubuntu-npu:v1.8.11 (T527).
Create a Docker Container
- A733
- T527
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
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
After the Docker container is created, you can see it with docker ps -a. The container name is allwinner_v2.0.10.1 (A733) or allwinner_v1.8.11 (T527).
Enter the Docker Container
Use docker ps -a to find the container ID.
sudo docker exec -it <CONTAINER_ID> /bin/bash