¶ Arcs-Mini 开发环境搭建指南
¶ 概述
本指南旨在帮助开发者快速搭建 Arcs 开发环境，主要内容包括：
- 在 Ubuntu/Windows 系统上配置 Arcs 开发环境
- 获取 Arcs SDK 开发套件
- 完成示例项目的编译与烧录流程
- 查看设备运行日志
¶ 一、环境搭建
选择你正在使用的操作系统。
- 提供两种 Windows 下的开发环境搭建方式：
- Windows + WSL2 （推荐，安装步骤比虚拟机更少）
- Windows + 虚拟机
微软官方参考: WSL安装指南
- 系统要求：
- Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11
- 需保证 C 盘至少有 20GB 的存储空间
1.安装 Ubuntu 环境
推荐使用微软官方维护的 Ubuntu 发行版（建议 Ubuntu 20.04 或更高版本）。
执行以下命令，跟随指引安装 Ubuntu 发布版本。
wsl --install Ubuntu-20.04
2.设置用户名以及密码
3.启动wsl
打开终端，执行以下命令wsl，启动 WSL
4.后续搭建步骤与 Ubuntu 原生环境相同
通常，为了保证软件源的时效性，推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
4.1. 安装必要依赖包
执行以下命令安装基础依赖：
sudo apt install -y \
vim \
openssh-client \
git \
git-lfs \
wget \
cmake \
curl \
tar \
zlib1g-dev \
bzip2
4.2. 获取 SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
请注意：
SDK 请不要克隆到挂载的 windows 硬盘的路径(如：/nmt/d/)，会导致编译速度较慢。
推荐克隆到 WSL 系统内的路径（如：/home/workspace/)
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
4.3. 编译工具链
克隆结束后，执行以下命令获取编译工具链：
cd arcs_mini &&
./arcs-sdk/prepare_listenai_tools.sh &&
./arcs-sdk/prepare_toolchain.sh
¶
至此，Arcs开发环境搭建完成。
1.下载 Ubuntu 镜像
下载链接：Ubuntu 官网(本文使用的版本为 24.04.3 LTS)
2.在虚拟机安装镜像
下载链接：VMware 官网 (本文使用的版本为17.6.4)
3.开发环境搭建
虚拟机环境下推荐安装 open-vm-tools 工具，之后可以复制命令到虚拟机环境进行环境配置，通过以下命令安装：
sudo apt install -y open-vm-tools
在这之后，可以重启 VMware，就可以愉快地粘贴命令。
4.后续搭建步骤与 Ubuntu 原生环境相同
通常，为了保证软件源的时效性，推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
4.1. 安装必要依赖包
执行以下命令安装基础依赖：
sudo apt install -y \
vim \
openssh-client \
git \
git-lfs \
wget \
cmake \
curl \
tar \
zlib1g-dev \
bzip2
4.2. 获取 SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
4.3. 编译工具链
克隆结束后，执行以下命令获取编译工具链：
cd arcs_mini && \
./arcs-sdk/prepare_listenai_tools.sh && \
./arcs-sdk/prepare_toolchain.sh
¶
至此，Arcs开发环境搭建完成。
¶ 操作系统版本要求
支持 Ubuntu 18.04 LTS 及更新的版本。
通常，为了保证软件源的时效性，推荐你在进入下一步之前先执行以下命令
sudo apt update
sudo apt upgrade
¶ 1. 安装必要依赖包
执行以下命令安装基础依赖：
sudo apt install -y \
vim \
openssh-client \
git \
git-lfs \
wget \
cmake \
curl \
tar \
zlib1g-dev \
bzip2
¶ 2. 获取 SDK
执行以下命令克隆仓库
git clone https://cloud.listenai.com/CSKG836746/arcs-sdk/public/arcs_mini.git
如果执行命令后要求输入账户以及密码，请根据文档《LSCloud使用帮助》创建仓库访问令牌
登录账号为您的聆思账户，登录密码为访问令牌
¶ 3. 编译工具链
克隆结束后，执行以下命令获取编译工具链：
cd arcs_mini &&
./arcs-sdk/prepare_listenai_tools.sh &&
./arcs-sdk/prepare_toolchain.sh
export NUCLEI_TOOLCHAIN_PATH=$HOME/nuclei/gcc
export LISTENAI_TOOLS_PATH=$HOME/listenai-tools
注意：
将 NUCLEI_TOOLCHAIN_PATH 指向解压后的工具链（步骤1下载的工具）的路径(也就是修改$HOME/nuclei/gcc为下载文件的路径)
将 LISTENAI_TOOLS_PATH 指向解压后的 ListenAI 工具包（步骤2下载的工具）路径(也就是修改$HOME/listenai-tools为下载文件的路径)
建议将上述环境变量配置添加到 .bashrc 或其他启动配置文件中，以确保终端环境变量持久有效。
可以通过以下命令检查是否设置成功：
echo $NUCLEI_TOOLCHAIN_PATH
echo $LISTENAI_TOOLS_PATH
能够正确打印出工具链的路径就可以了
¶
至此，Arcs开发环境搭建完成。
¶ 二、项目编译
注意，目前仅支持在 linux 环境下进行编译。
Windows 系统用户请先进入 WSL 环境（在终端执行命令wsl） 或 进入 VMware 虚拟机环境中。
执行构建脚本脚本,在 arcs_mini 项目根目录执行以下命令：
./build.sh
构建成功页面
可以在build文件夹找到编译好的业务固件aiui.bin
¶ 三、烧录固件
固件版本号从 1.6.1 升级到 1.7.0 时，需要烧录更多资源文件，请按照文档《恢复出厂固件 & 升级固件教程》 升级，升级后二次开发时只烧录
aiui.bin即可
通常情况下，对项目进行二次开发时，只需烧录编译代码后生成的
aiui.bin文件到地址0x600000即可。
选择你正在使用的操作系统。
请选择您当前的环境：
¶ 1. 安装 cskburn desktop
下载链接：cskburn-desktop_windows-x86_64-setup.exe
¶ 2. 安装 ADB 工具
- 下载 ADB 工具：platform-tools-latest-windows.zip
- 解压后，以管理员身份执行
install.bat脚本自动配置环境变量
- 测试是否安装成功
- 打开一个新的终端，然后执行命令：
adb --version
- 打开一个新的终端，然后执行命令：
- 如果脚本无法成功执行，可以按照下图，手动配置环境变量：
¶ 3. 开始烧录
双击
图标运行软件：
-
点击串口下拉框，选择ADB设备；
-
点击 "进入 Recovery 模式";
如果未进入 Recovery 模式，可以尝试更换 USB 线 或更换 USB 口后再次尝试。
-
将编译好的
aiui.bin文件（在build目录下）拖拽进烧录区域； -
修改烧录地址为
0x600000 -
点击开始烧录，等待烧录完成。
提示：烧录地址填写错误会导致 Arcs-mini 无法正常启动，可以参考文档 《恢复出厂固件 & 升级固件教程》 的串口烧录教程进行恢复
注意：
无法使用 WSL2 内的 ADB 工具烧录固件，因此本小节将演示使用 windows 下的 ADB 烧录存放在 WSL2 的固件
¶ 1. 安装烧录工具 (Windows环境)
- 下载 ADB 工具：platform-tools-latest-windows.zip
- 解压后，以管理员身份执行
install.bat脚本自动配置环境变量
- 测试是否安装成功
- 打开一个新的终端，然后执行命令：
adb --version
- 打开一个新的终端，然后执行命令：
- 如果脚本无法成功执行，可以按照下图，手动配置环境变量：
¶ 2. 下载自动烧录脚本 (WSL环境)
-
下载连接：download.sh，下载完成后请放在
arcs_mini项目根目录 -
（推荐）使用
wget下载：arcs_mini目录下执行以下命令：wget -O download.sh https://docs2.listenai.com/zz/11325.sh?shortId=wgjKAyNwz && chmod +x download.sh
¶ 3. 执行自动烧录脚本 (WSL环境)
执行以下命令：
./download.sh
执行成功结果：
如果自动化脚本异常，在 Windows 系统终端下按照以下步骤手动烧录
- 进入恢复模式:
adb shell recovery- 烧录固件和资源（需根据
arcs_mini项目的存放位置修改命令）:adb push .\build\aiui.bin /RAW/NAND/600000- 重启开发板:
adb shell reboot hard
¶ 1. 确保虚拟机已经识别 Arcs-mini
虚拟机通过 USB 直通访问 Windows 下的设备 STMicroelectronics VoiceAssistant
¶ 2. 安装烧录工具
该项目将 ADB 作为烧录工具
-
执行以下命令安装 ADB
sudo apt install -y adb -
执行以下命令配置 USB 设备规则，并重启 ADB ：
echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="0483", MODE="0666"' | \ sudo tee /etc/udev/rules.d/51-android.rules && \ sudo udevadm control --reload-rules && \ sudo udevadm trigger && \ adb kill-server && \ adb start-server -
检查配置是否生效
- 执行命令
adb devices 
- 执行命令
¶ 2. 下载自动烧录脚本
-
下载连接：download.sh，下载完成后请放在
arcs_mini项目根目录 -
（推荐）使用
wget下载：arcs_mini目录下执行以下命令：wget -O download.sh https://docs2.listenai.com/zz/11325.sh?shortId=wgjKAyNwz && \ chmod +x download.sh
¶ 3. 执行自动烧录脚本
执行以下命令：
./download.sh
执行成功结果：
如果自动化脚本异常，在终端下按照以下步骤手动烧录
- 进入恢复模式:
adb shell recovery- 烧录固件和资源（需根据
arcs_mini项目的存放位置修改命令）:adb push .\build\aiui.bin /RAW/NAND/600000- 重启开发板:
adb shell reboot hard
¶ 1. 安装烧录工具
-
执行以下命令安装 ADB
sudo apt install -y adb -
执行以下命令配置 USB 设备规则，并重启 ADB ：
echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="0483", MODE="0666"' | \ sudo tee /etc/udev/rules.d/51-android.rules && \ sudo udevadm control --reload-rules && \ sudo udevadm trigger && \ adb kill-server && \ adb start-server -
检查配置是否生效
- 执行命令
adb devices
- 执行命令
¶ 2. 下载自动烧录脚本
-
下载连接：download.sh，下载完成后请放在
arcs_mini项目根目录 -
（推荐）使用
wget下载：arcs_mini目录下执行以下命令：wget -O download.sh https://docs2.listenai.com/zz/11325.sh?shortId=wgjKAyNwz && chmod +x download.sh
¶ 3. 执行自动烧录脚本
执行以下命令：
./download.sh
执行成功结果：
如果自动化脚本异常，在终端下按照以下步骤手动烧录
- 进入恢复模式:
adb shell recovery- 烧录固件和资源（需根据
arcs_mini项目的存放位置修改命令）:adb push .\build\aiui.bin /RAW/NAND/600000- 重启开发板:
adb shell reboot hard
¶ 四、日志查看
基于 ADB 工具查看日志将无法查看刚上电时刻的日志
-
请务必按照上一章节安装 ADB 工具
-
打开终端执行命令
adb shell运行结果
- 打开 聆思在线串口终端 ，选择波特率为
921600
- 串口板连接 Arcs-mini
- 查看日志
