开发前提

开始之前，请先安装好 Git（下载代码必需，https://git-scm.com/download/win），建议同时安装 VS Code 作为代码编辑器（https://code.visualstudio.com/）。

方式一：使用 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 的 Windows 开发环境：安装依赖、克隆博流官方 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

安装基础工具（Git 和 VS Code）

编译和下载代码需要 Git。打开浏览器访问 https://git-scm.com/download/win 下载安装包，一路点击“下一步”完成安装即可（下载慢可以到安信可官方 docs 下载：https://docs.ai-thinker.com/eyes）。

建议再安装 VS Code（https://code.visualstudio.com/）作为代码编辑器，后面编译要用到它的集成终端。安装完成后，在 VS Code 左侧扩展栏搜索 Chinese 安装中文语言包，重启后就是中文界面。

2

下载 Bouffalo SDK 源码

按 Win 键输入 PowerShell 回车打开终端（也可以在资源管理器地址栏输入 powershell 回车）。先切换到一个存放代码的目录（例如 D 盘根目录），再克隆博流官方 GitHub 仓库：

1. cd D:/ —— 切换到 D 盘根目录，下载的文件会放在这里
2. git clone https://github.com/bouffalolab/bouffalo_sdk.git —— 下载 SDK（注意：gitee 上的 SDK 镜像已长期未更新，请务必使用 GitHub 仓库）

下载时间取决于网速，请耐心等待。如果提示 fatal: unable to access，说明网络连不上 GitHub，检查网络或使用代理后重试。

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

3

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

工具链负责把代码“翻译”成 BL616 / BL618 芯片能运行的机器码。继续在 PowerShell 中执行，从博流官方仓库下载 Windows 版工具链：

1. cd D:/ —— 回到 D 盘根目录
2. git clone https://gitee.com/bouffalolab/toolchain_gcc_t-head_windows.git —— 下载工具链，完成后会生成 toolchain_gcc_t-head_windows 文件夹

cd D:/
git clone https://gitee.com/bouffalolab/toolchain_gcc_t-head_windows.git

4

配置环境变量

编译时系统需要能找到工具链、make 和 ninja。在开始菜单搜索“环境变量”，打开“编辑系统环境变量”，点击右下角“环境变量”，在“系统变量”中找到 Path 双击编辑，依次新建以下三个路径（把 D:/ 换成你实际存放的位置）：

1. D:\toolchain_gcc_t-head_windows\bin —— 工具链命令所在目录
2. D:\bouffalo_sdk\tools\make —— make 构建工具
3. D:\bouffalo_sdk\tools\ninja —— ninja 构建工具（加速编译）

建议用右侧“上移”把 make 路径移到列表最顶部，避免和系统中其他 make 冲突。

5

验证工具链是否装好

重新打开一个新的 PowerShell 窗口（或重启电脑），依次执行下面两条命令：

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

如果提示“无法将 make 识别为 cmdlet、函数、脚本文件或可运行程序的名称”，说明环境变量没有生效：检查第 4 步的路径是否正确，然后重新打开终端（或重启电脑）再试。

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

6

编译 Hello world 例程

打开 VS Code，选择“文件 → 打开文件夹”并选中 D:/bouffalo_sdk。在左侧文件树中找到 examples/helloworld，右键选择“在集成终端中打开”，然后执行编译命令：

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

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

make CHIP=bl616 BOARD=bl616dk

7

烧录固件到开发板

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

1. 查看串口号：右键“此电脑”选择“管理”，在“设备管理器 → 端口（COM 和 LPT）”下找到类似 COM3 的串口号并记下来
2. 按住开发板 BOOT 键（Ai-M61-32S-Kit 为 IO2）不放，短按一下 EN/RST 再松开，最后松开 BOOT，进入下载模式
3. 在 VS Code 终端（helloworld 目录）执行烧录，把 COM3 换成你自己的串口号，进度条走完即烧录成功

如果使用 CH340 等 USB 转串口模块，部分型号不支持 2M 波特率烧录，可以降低波特率（小于 500K）重试。

make flash CHIP=bl616 COMX=COM3

8

查看运行日志

烧录完成后按一下开发板复位键，程序就开始运行。用串口工具连接串口查看日志（波特率 2000000，即 2M），推荐使用 MobaXterm（免费）或微软商店中的“串口调试助手”。连接后能看到程序打印的日志，就说明程序跑起来了。

常见问题

提示“无法将 make 识别为……”/“不是内部或外部命令”

环境变量没配好，确认第 4 步的三个路径都加进了系统变量 Path，然后重新打开终端（或重启电脑）。

make 版本不对

系统里可能装了其他 make，把 D:\bouffalo_sdk\tools\make 用“上移”移到 Path 最顶部。

不知道串口号

右键“此电脑” → 管理 → 设备管理器 → 端口（COM 和 LPT）。

烧录失败

先确认是否进入下载模式（重新按住 BOOT 再短按 EN/RST）；使用 CH340 等模块时，把波特率降到 500K 以下重试。

克隆 SDK 太慢

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

VS Code 是英文界面

扩展商店搜索 Chinese 安装中文语言包，重启即可。

遇到问题？

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