版本：2.8.1

基础

SDK介绍

ZHIHE COMPUTING Linux SDK （以下简称“SDK”）是一套适配知合计算芯片的软件开发工具包。通过 SDK，开发者可直接调用预适配的驱动和工具链，缩短评估时间，专注于上层应用开发。

获取预编译镜像

用户可直接烧录提供的预编译镜像，达到快速开发和评估的目的。

下载镜像

开发板	系统类型	镜像下载地址
a200-evb	Buildroot	br2image-v2.8.1-a200_evb.tar.gz
	Ubuntu	diskimage_v2.8.1_a200-evb-release_desktop_ubuntu_public.tar.gz
a210-evb	Buildroot	br2image-v2.8.1-a210_evb.tar.gz
	Debian	diskimage_v2.8.1_a210-evb-release_desktop_debian_public.tar.gz

说明： 若使用预编译镜像，可在下载镜像后直接跳转到烧录镜像章节。

文件介绍

文件名	说明
emmc-gpt_primary.img	系统默认分区表
emmc-uboot_env.img	u-boot 的环境变量
emmc_boot-loader.img	eMMC 物理引导分区镜像
emmc-boot_a.img	ext4 格式启动分区，包含U-Boot、OpenSBI、Image 等系统固件的FIT包
emmc-system_a.img	只读 Rootfs 镜像
emmc-app_a.img	Overlay 方式扩展 Rootfs，使根文件系统可写，无数据仅做格式化
emmc-home.img	预留用户数据分区，无数据仅做格式化
fastboot_images.bat	Windows 系统下的烧录脚本
fastboot_images.sh	Linux 系统下的烧录脚本
spl-with-fit-rvbl.bin	用于Fastboot启动的U-Boot镜像
bootzero-rvbl.bin	用于Fastboot启动，用来初始化CPU，A200不包含该文件
output.yml	系统信息

编译镜像

搭建环境

因定制化或兼容性需求不使用预编译镜像时，用户需搭建开发环境并编译镜像。

环境要求

开发环境	要求
处理器	8 核处理器，Intel Core i5 及以上
硬盘空间	≥ 16 GB
内存	≥ 4 GB
系统版本	推荐 Ubuntu 22.04 及以上

Docker环境搭建

用户可使用提供的 Docker 镜像缩短编译环境构建时间，实现高效开发。

使用官方 convenience 脚本安装 Docker Engine 。更多信息请参考 Docker 官方教程 Docker官方文档。

# Docker 官方命令
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 或使用国内代理
curl -fsSL https://get.docker.com | sudo bash -s docker --mirror Aliyun

添加 Docker 用户组。

# 创建 docker 用户组
sudo groupadd docker

# 将当前用户加入组
sudo gpasswd -a $USER docker

# 生效组变更或注销重新登录
newgrp docker

启动 Docker 服务。
```
sudo systemctl start docker
```

安装 Python 环境。

sudo apt install python3-pip
sudo apt install python$(python3 -V | cut -d' ' -f2 | cut -d'.' -f1-2)-venv

下载配置工具。

cd <yourworkspace>

wget http://developer.zhcomputing.com/downloads/release/zhihesdk/v2.8.1/build.sh -O build.sh && chmod +x ./build.sh

安装 Docker 运行环境，示例命令和返回结果如下所示。

./build.sh -i zdocker

Successfully installed certifi-2025.8.3 charset-normalizer-3.4.3 docker-7.1.0 idna-3.10 psutil-7.0.0 pyserial-3.5 requests-2.32.4 six-1.17.0 tqdm-4.67.1 urllib3-2.2.3 zdocker-1.0.16
>>> Create zdocker environment success.
To enter the zdocker environment, execute the following command:
    source ~/zdocker_env/bin/activate
    zdocker

进入 Docker。

说明： 第一次执行 zdocker 需要下载 Docker Image，镜像较大请耐心等待，下载完成后进入系统。
```
source ~/zdocker_env/bin/activate
zdocker
```

交叉编译

注意： 请确保在 zdocker 环境中执行后续操作。

下载 SDK 资源。
```
./build.sh -s buildroot
```

开始编译。

# 查看支持列表
./build.sh -b buildroot

# 列表返回信息
Defconfig list
    a200
    a210

# 根据配置指定编译命令
./build.sh -b buildroot a200
./build.sh -b buildroot a210

说明： 更多开发信息，请查看 Buildroot 开发指南。

完成编译。

输出如下提示信息，编译完成。

>>> Prepare Image package files: ..done
>>> Create Image package: .done
>>> Prepare OTA package files: ..done
>>> Create OTA package: ..done

输出镜像。

buildroot/output/images/Release/
├── emmc-app_a.img
├── emmc-boot_a.img
├── emmc_boot-loader.img
├── emmc-gpt_primary.img
├── emmc-home.img
├── emmc-system_a.img
├── emmc-uboot_env.img
├── fastboot_images.bat
├── fastboot_images.sh
└── output.yml

烧录镜像

关于 A210 烧录镜像的说明，请查看 A210 镜像烧录指南。

SDK介绍​

获取预编译镜像​

下载镜像​

文件介绍​

编译镜像​

搭建环境​

环境要求​

Docker环境搭建​

交叉编译​

烧录镜像​