快速入门

本文档介绍如何快速开始使用 ARCS SDK 进行开发，包括环境搭建、编译示例和烧录运行。

Note

目前仅支持 Linux 平台，推荐使用 Ubuntu 18.04 以上版本。

环境搭建

安装系统依赖

sudo apt update
sudo apt install -y wget bzip2 python3 git

自动搭建（推荐）

在 SDK 根目录下执行：

source env.sh

该命令会自动完成以下操作：

检测工具链环境变量，已有有效配置则直接使用，不覆盖
工具链缺失时自动查找或下载安装
设置环境变量（NUCLEI_TOOLCHAIN_PATH、LISTENAI_TOOLS_PATH、PATH）
检测子模块状态，有异常时提示修复命令

已就绪的环境 source 后秒完成，可重复执行。

Tip

可使用子命令进行专项排查：

source env.sh check              # 仅检测环境状态
source env.sh setup              # 仅安装工具链
source env.sh submodule sync     # 仅同步子模块
source env.sh info               # 查看版本信息

手动搭建

如果自动搭建失败，可以手动搭建开发环境：

下载工具链

下载对应平台的工具链并解压（如果已存在工具链，可跳过此步骤）：
- Linux 工具链下载地址
也可使用 SDK 内置脚本：
```
bash tools/scripts/prepare_toolchain.sh
```
下载 ListenAI 开发工具包
- Linux 开发工具包下载地址
也可使用 SDK 内置脚本：
```
bash tools/scripts/prepare_listenai_tools.sh
```
设置环境变量
```
# 设置工具链路径
export NUCLEI_TOOLCHAIN_PATH=$HOME/.listenai/gcc

# 设置 ListenAI 工具包路径
export LISTENAI_TOOLS_PATH=$HOME/.listenai/listenai-tools
```
Warning

必须使用绝对路径！ 环境变量的路径必须是绝对路径（如 /home/user/.listenai/gcc），不能使用相对路径（如 ./toolchain 或 ../toolchain），否则会导致编译失败。 $HOME 会由 shell 自动展开为用户主目录的绝对路径；请勿在 IDE 配置等非 shell 环境中使用 ~，它不会被自动展开。

其中：
- NUCLEI_TOOLCHAIN_PATH 指向 $HOME/.listenai/gcc（工具链安装目录）
- LISTENAI_TOOLS_PATH 指向 $HOME/.listenai/listenai-tools（开发工具包安装目录）

快速开始

编译示例

以 helloworld 工程为例，演示如何编译项目：

编译命令

在 SDK 根目录下执行：
```
./build.sh -C -S samples/helloworld -DBOARD=arcs_evb
```
命令参数说明：
- -S: 指定项目源码路径
- -DBOARD: 指定目标板型(必需参数,如 arcs_mini、arcs_evb 等)
- -C: 清理构建目录(可选)
编译输出

编译成功后会在 build 目录下生成构建产物，包括：
- helloworld.bin: 烧录文件
- helloworld.elf: 调试文件
- 其他相关文件

烧录运行

准备工作

连接硬件

将串口板连接到开发板：
- 开发板 TX 脚 (默认引脚PA2，注意查看板型文件) 连接串口板 RX
- 开发板 RX 脚 (默认引脚PA3，注意查看板型文件) 连接串口板 TX
- 开发板 GND 连接串口板 GND
进入烧录模式

按住 BOOT 脚后复位开发板，进入烧录模式。

Note

每次重新烧录前，都需要执行按住 BOOT 脚后复位开发板的操作。

自动烧录（推荐）

如果希望实现自动烧录，可以连接控制引脚：

开发板 BOOT 脚连接串口板 RTS 脚
开发板 RESET 脚连接串口板 DTR 脚

这样 cskburn 工具可以自动控制进入烧录模式。

烧录命令

使用 cskburn 工具进行烧录：

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/helloworld.bin -C arcs

命令参数说明：

-s: 指定烧录设备（串口设备路径）
Note

请根据实际情况选择正确的串口设备：
- 使用 ls /dev/ttyUSB* 或 ls /dev/ttyACM* 查看可用设备
- 常见设备名：/dev/ttyUSB0、/dev/ttyUSB1、/dev/ttyACM0 等
- 插入串口板时可使用 dmesg | tail 查看系统分配的设备名
-b: 指定烧录波特率（推荐使用 3000000）
0x0: 烧录起始地址（基于 0x30000000 flash 起始地址的偏移）
build/helloworld.bin: 烧录文件路径
-C arcs: 指定芯片类型

验证运行

烧录完成后复位开发板，应该可以在串口控制台看到以下输出：

Running on hart-id: 1
Hello, world!

常见问题

权限问题

如果遇到串口权限问题，将当前用户添加到 dialout 组：
```
sudo usermod -a -G dialout $USER
```
然后重新登录。
串口设备问题

使用 dmesg 或 ls /dev/ttyUSB* 查看串口设备：
```
ls /dev/ttyUSB*
```
环境变量问题

确保已正确设置环境变量，可以使用以下命令检查：
```
source env.sh check
```