原创【上海海思基于越影（视觉类）芯片】测评 (一)：开发环境搭建

版块：

开发板测评与实战

简介：本文记录 Sunniwell CV610 开发套件的开箱组装、Ubuntu 下 Docker 开发环境搭建、源码编译及烧录过程，并分享官方 Dockerfile 的 PATH 配置问题及解决方法，以及

发布时间：昨天 11:17

一、开箱与组装

这次拿到的是 Sunniwell CV610 开发套件。先简单开个箱，看看里面都有哪些东西。

包装采用泡棉分隔，各个模块和配件都有独立的位置，除了开发板本体，还附带了连接线、螺丝等配件。

把主要模块取出来，可以看到套件包含开发板、显示屏、摄像头模组以及其他板卡。各部分是分开的，需要自己动手组装。

组装倒是不复杂，主要就是将几块板卡通过铜柱固定，再装上显示屏。完成后是一个多层堆叠的结构，整体比较紧凑，摄像头则可以单独连接使用。

硬件部分就先介绍到这里。接下来开始搭建开发环境，编译官方提供的示例工程，并尝试烧录运行。

二、环境搭建

海思官方文档站提供了一份"软件指南"，按"开发板选型 → 开发板组装（Sunniwell CV610）→ 构建首个项目（first-project）"的顺序展开。

地址是https://docs.hisilicon.com/projects/hi_aiot_solution/master/overview/index.html，文档写得比较详细，基本照着做就能跑通。

这里我的开发环境是 Ubuntu 26。

Docker 镜像有两种获取方式：直接拉取预编译镜像，或者本地构建。一般选方式一就够了，只有需要裁剪镜像时才用方式二。

接下来创建容器。官方流程最后是在 Windows 下烧录，而我的主机本身就是 Ubuntu，可以直接在 Linux 下完成全部步骤：

mkdir -p ~/hi_aiot
docker run -d --name wukun1 --privileged --network host -v /dev:/dev -v ~/hi_aiot:/root/hi_aiot -w /root/hi_aiot wukun:1.1.0

进入容器，拉取代码：

docker exec -it wukun1 bash

进入后默认就在 /root/hi_aiot 目录下，执行：

repo init -u https://gitcode.com/HiSpark/hi_aiot_solution_manifest.git -b main && repo sync && repo start master --all

然后就显示

结果报错，提示找不到 python。

不应该啊，官方镜像里理应自带完整的工具链，不该缺 python。排查后发现，容器内 /root/.bashrc 末尾有这样两行：

. "\$HOME/.cargo/env"
export PATH=~/bin:\$PATH

原因在于我前面用的是方式二本地构建镜像，而官方 Dockerfile 在向 .bashrc 写入这两行时，对 $ 多转义了一次，写进去的是字面量 $PATH，而不是展开后的路径。于是每次启动 bash，PATH 都会被改成 ~/bin:$PATH 这串字符，/usr/bin、/bin 全部丢失。

这么明显的问题不应该会留下来啊。我去查了一下提交记录，这个 Dockerfile 是 2026 年 9 月 5 日提交的，距今不到两个月；加上大多数人应该都是直接拉预编译镜像，所以一直没人发现。

修复

修复方法很简单，去掉这两行里多余的反斜杠：

-. "\$HOME/.cargo/env"
-export PATH=~/bin:\$PATH
+. "$HOME/.cargo/env"
+export PATH=~/bin:$PATH

这个问题我已经在 GitCode 上提交了 issue

接下来，现在开着的那个 shell 还是旧的 PATH，先 exit 退出，再重新进去：

exit
docker exec -it wukun1 bash

然后在里面重新拉代码：

repo init -u https://gitcode.com/HiSpark/hi_aiot_solution_manifest.git -b main && repo sync && repo start master --all

看到 repo sync has finished successfully，说明代码拉取成功。

然后开始编译

cd hi_aiot_solution
bash scripts/build.sh build --target cv610_ev_board samples framework_media

最后输出"构建成功！"，编译完成

烧录也在容器里做，不用 sudo，容器里本来就是 root：

bash tools/burn/burn.sh

然后又缺依赖

root@l:~/hi_aiot/hi_aiot_solution# bash tools/burn/burn.sh
[依赖] 缺少 python3 模块 'serial'，正在安装 python3-serial ...
E: Unable to locate package python3-serial
[错误] python3-serial 安装失败，请手动执行: apt-get install python3-serial
root@l:~/hi_aiot/hi_aiot_solution# apt-get update
apt-get install -y python3-serial
Get:1 http://mirrors.huaweicloud.com/ubuntu jammy InRelease [270 kB]
Get:2 http://mirrors.huaweicloud.com/ubuntu jammy-updates InRelease [128 kB]

这个只需要

apt-get update
apt-get install -y python3-serial

然后再次烧录，这次需要一个ip

root@l:~/hi_aiot/hi_aiot_solution# bash tools/burn/burn.sh
════════════════════════════════════════
  Hi3516CV610 烧录工具 —— 交互式配置
════════════════════════════════════════
  （直接回车使用 [默认值]，留空项会提示重新输入）

宿主机 (WSL) IP: 
  [错误] 宿主机IP不能为空，请重新输入
宿主机 (WSL) IP:

填入就能烧录了