开发前提

在进行以下操作之前，请先根据 Ubuntu 安装教程 或 WSL 安装教程 安装好 Linux 开发环境（虚拟机或 WSL 均可）。

方式一：使用 Ai-Thinker Skills 让 AI 自动安装 SDK（推荐）

Ai-Thinker Skills 是安信可整理的 AI 编程辅助能力，安装后可以让 AI 自动完成 SDK 的克隆、环境配置与编译验证，无需手动逐条执行命令。完全没接触过终端的用户建议直接用这种方式。

1

安装 Ai-Thinker Skills

推荐单独安装 Ai-M6x 开发技能 coder-ai-m62-m61，也可以一键安装全部 Skills。

npx skills add Ai-Thinker-Open/skills --skill coder-ai-m62-m61
# 或一键安装全部 Skills：
npx skills add Ai-Thinker-Open/skills

2

向 AI 描述需求

在支持 Skills 的 AI 编程工具（如 Codex、Claude Code）中开启新会话，直接让 AI 帮你完成 SDK 安装与环境搭建，例如：

“请使用 coder-ai-m62-m61 技能，帮我搭建 Ai-M6x 的 Linux 开发环境：安装依赖、克隆博流官方 SDK，并编译 Hello world 例程。”

3

等待 AI 自动完成

AI 会根据技能指南自动完成依赖安装、SDK 克隆、工具链配置与编译验证，完成后即可进入烧录与调试环节。

技能说明

coder-ai-m62-m61 是基于 bouffalo_sdk 的 BL616/BL618 系列模组开发指南，涵盖 GPIO、UART、SPI、I2C、DMA 等外设编程。 安装与使用说明：Ai-Thinker Skills ｜ GitHub 仓库

方式二：手动搭建开发环境

手动搭建看起来命令很多，其实只做四件事：装好编译工具 → 下载 SDK → 编译第一个程序 → 烧录到开发板。下面每一步都解释了命令的含义和可能遇到的问题，照着做就行，没接触过终端也不用担心。

1

打开终端并安装基础依赖

在 Ubuntu 桌面按 Ctrl+Alt+T 打开终端（WSL 则打开 Windows Terminal 或 Ubuntu 应用），执行下面命令安装基础工具：

• git：用来下载代码，后面下载工具链和 SDK 都要靠它
• make：编译工具，负责把源码变成固件
• ninja：可选安装，能让编译速度更快
• vim：文本编辑器，方便以后查看和修改代码

如果终端提示输入密码，直接输入你的登录密码再按回车即可（输入时屏幕不会显示任何字符，这是正常现象）。

sudo apt-get install git vim make ninja-build -y

2

下载 RISC-V 交叉编译工具链

工具链负责把代码“翻译”成 BL616 / BL618 芯片能运行的机器码（它的命令以 riscv64-unknown-elf- 开头）。先从国内平台 gitee 把它下载到主目录（~ 就是你的主目录，相当于 Windows 的“用户文件夹”）：

1. cd ~ —— 回到主目录，下载的文件都会放在这里
2. git clone https://gitee.com/bouffalolab/toolchain_gcc_t-head_linux.git —— 下载工具链，完成后主目录会出现 toolchain_gcc_t-head_linux 文件夹

下载时间取决于网速，请耐心等待。如果第二条命令提示 fatal: unable to access，说明网络连不上 gitee，检查网络后重试即可。

cd ~
git clone https://gitee.com/bouffalolab/toolchain_gcc_t-head_linux.git

3

把工具链安装到系统

下载完成后，把工具链复制到系统目录，再把它写入环境变量，这样终端在任何位置都能直接调用它：

1. sudo cp -rf toolchain_gcc_t-head_linux/ /usr/bin —— 复制到 /usr/bin（需要管理员权限，会提示输入密码；注意命令末尾的斜杠不能省略）
2. echo "export PATH=\"$PATH:/usr/bin/toolchain_gcc_t-head_linux/bin\"" >> ~/.bashrc —— 把工具链的 bin 目录追加到系统配置里（这条命令比较长，建议用代码框右上角的复制按钮粘贴，避免手打出错）
3. source ~/.bashrc —— 让刚才的配置立即生效；如果之后仍提示找不到命令，重新打开一个终端窗口即可

sudo cp -rf toolchain_gcc_t-head_linux/ /usr/bin
echo "export PATH=\"$PATH:/usr/bin/toolchain_gcc_t-head_linux/bin\"" >> ~/.bashrc
source ~/.bashrc

4

验证工具链是否装好

执行下面两条命令，确认工具是否都安装成功：

• make -v：正常会显示 GNU Make 和版本号
• riscv64-unknown-elf-gcc -v：正常会显示 gcc version 10.2.0 (Xuantie-900 ...)

如果提示 command not found，说明工具链还没有生效：重新执行一次 source ~/.bashrc，或者关掉终端重新打开再试。

make -v
riscv64-unknown-elf-gcc -v

5

下载 Bouffalo SDK 源码

SDK 是博流官方提供的开发套件，里面包含芯片驱动、Wi-Fi/BLE 协议栈和大量例程。把它下载到主目录并进入文件夹：

1. git clone https://github.com/bouffalolab/bouffalo_sdk.git —— 从 GitHub 下载官方 SDK（注意：gitee 上的 SDK 镜像已长期未更新，请务必使用 GitHub 仓库）
2. cd bouffalo_sdk —— 进入 SDK 目录，后面的编译都在这里进行

cd ~
git clone https://github.com/bouffalolab/bouffalo_sdk.git
cd bouffalo_sdk

6

编译 Hello world 例程

先编译 SDK 自带的 helloworld 例程，验证整个环境是否正常。进入例程目录后执行编译命令：

• CHIP=bl616 是芯片型号：Ai-M62（BL616）和 Ai-M61（BL618）同属一个系列，统一填写引脚最少的 bl616 即可
• BOARD=bl616dk 是开发板类型

第一次编译需要下载依赖并生成工程，请耐心等待。编译完成后，固件文件生成在 build/build_out/ 目录下。

cd examples/helloworld
make CHIP=bl616 BOARD=bl616dk

7

烧录固件到开发板

先用 USB 线把开发板连到电脑，然后按顺序操作：

1. 给当前用户添加串口权限：sudo usermod -a -G dialout $USER（重启或重新登录后生效；如果不想重启，可以在烧录命令前加 sudo）
2. 查看串口号：ls /dev/ttyUSB0，能看到输出就说明开发板已被电脑识别
3. 按住开发板 BOOT 键（Ai-M61-32S-Kit 为 IO2）不放，短按一下 EN/RST 再松开，最后松开 BOOT，进入下载模式
4. 执行烧录（CHIP 与编译时保持一致）：make flash CHIP=bl616 COMX=/dev/ttyUSB0，进度条走完即烧录成功

如果你用的是 WSL，USB 串口默认无法直连，建议改用 Windows 下的烧录工具烧录。

sudo usermod -a -G dialout $USER
ls /dev/ttyUSB0
make flash CHIP=bl616 COMX=/dev/ttyUSB0

8

查看日志输出

烧录完成后按一下开发板复位键，程序就开始运行。终端默认看不到模组日志，需要先安装串口工具 picocom 再连接串口（波特率 2000000）：

1. sudo apt-get install picocom —— 安装串口工具
2. picocom /dev/ttyUSB0 -b 2000000 —— 连接串口，能看到程序打印的日志就说明跑起来了
3. 关闭 picocom：先按 Ctrl+A，再按 Q

sudo apt-get install picocom
picocom /dev/ttyUSB0 -b 2000000

常见问题

克隆 SDK 太慢

GitHub 下载慢时可使用代理加速，请勿使用 gitee 镜像（上面的 SDK 已长期未更新）。

烧录提示异常/失败

通常是没有进入下载模式，重新按住 BOOT/IO2 键再短按 EN/RST。

串口无权限

执行 sudo chmod 777 /dev/ttyUSB0 或使用 sudo 烧录，并将用户加入 dialout 组。

终端技巧

按 Tab 键可自动补全命令；粘贴内容用 Ctrl+Shift+V（或鼠标中键）。

遇到问题？

如有其他问题，请到统一的提问与讨论区：Ai-Thinker Discussions