Test Manual
bouffalolab/bouffalo_sdk
使用 tools/CI/testmanual 查询、编译并运行 Bouffalo SDK 手工 Jenkins 测试；适用于单个 case、suite，以及配合 git bisect 验证指定 SDK 或 submodule 提交。
Bouffalo SDK开发指南，提供完整的Bouffalo芯片系列开发文档和参考资料。当需要使用bouffalosdk开发IoT/MCU应用、了解SDK架构、配置构建系统、使用外设驱动、开发无线功能、管理电源、调试固件时使用此skill。
Apache-2.0Auto-check passed
Install Bouffalo SDK
$ npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install bouffalolab/bouffalo_sdk bouffalo-sdk --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/bouffalolab/bouffalo_sdk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/bouffalo-sdk .claude/skills/bouffalo-sdk && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "bouffalo-sdk" agent skill from https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdk into .claude/skills/bouffalo-sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bouffalo-sdk", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdkType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install bouffalolab/bouffalo_sdk bouffalo-sdk --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bouffalolab/bouffalo_sdk.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/bouffalo-sdk .agents/skills/bouffalo-sdk && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bouffalo-sdk" agent skill from https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdk into .agents/skills/bouffalo-sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bouffalo-sdk", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install bouffalolab/bouffalo_sdk bouffalo-sdk --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bouffalolab/bouffalo_sdk.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/bouffalo-sdk .cursor/skills/bouffalo-sdk && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "bouffalo-sdk" agent skill from https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdk into .cursor/skills/bouffalo-sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bouffalo-sdk", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/bouffalolab/bouffalo_sdk.git --path .agents/skills/bouffalo-sdk--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install bouffalolab/bouffalo_sdk bouffalo-sdk --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bouffalolab/bouffalo_sdk.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/bouffalo-sdk .gemini/skills/bouffalo-sdk && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "bouffalo-sdk" agent skill from https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdk into .gemini/skills/bouffalo-sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bouffalo-sdk", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install bouffalolab/bouffalo_sdk bouffalo-sdkInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/bouffalolab/bouffalo_sdk.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/bouffalo-sdk .github/skills/bouffalo-sdk && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "bouffalo-sdk" agent skill from https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdk into .github/skills/bouffalo-sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bouffalo-sdk", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install bouffalolab/bouffalo_sdk bouffalo-sdk --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bouffalolab/bouffalo_sdk.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/bouffalo-sdk .opencode/skills/bouffalo-sdk && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "bouffalo-sdk" agent skill from https://github.com/bouffalolab/bouffalo_sdk/tree/master/.agents/skills/bouffalo-sdk into .opencode/skills/bouffalo-sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bouffalo-sdk", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
bouffalo-sdk- GitHub stars
- 500
- Token cost
- ~1.1k tokens
- SKILL.md length
- 207 words
- Files
- 14 (incl. references)
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Bouffalo SDK开发指南，提供完整的Bouffalo芯片系列开发文档和参考资料。当需要使用bouffalosdk开发IoT/MCU应用、了解SDK架构、配置构建系统、使用外设驱动、开发无线功能、管理电源、调试固件时使用此skill。
- Works in 6 steps: 新手入门：从01-overview.md开始，然后阅读13-examples.md… → 了解架构：阅读02-architecture.md理解SDK设计 → 开发应用：根据需求阅读对应的references（外设→08-peripheral… → …
- SKILL.md covers 项目概述, SDK架构, LHAL驱动 and 芯片差异, plus 12 more sections
- Calls make
What it does
Bouffalo SDK is an agent skill from bouffalolab/bouffalo_sdk. Bouffalo SDK开发指南，提供完整的Bouffalo芯片系列开发文档和参考资料。当需要使用bouffalosdk开发IoT/MCU应用、了解SDK架构、配置构建系统、使用外设驱动、开发无线功能、管理电源、调试固件时使用此skill。
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including reference files (for example `references/01-overview.md`, `references/02-architecture.md` and `references/03-lhal-drivers.md`).
The repository describes itself as: BouffaloSDK is the IOT and MCU software development kit provided by the Bouffalo Lab Team, supports all the series of Bouffalo chips. Also it is the combination of blmcusdk and…. The licence is Apache-2.0.
Example prompts
- “/bouffalo-sdk”
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- 新手入门：从01-overview.md开始，然后阅读13-examples.md，运行helloworld示例
- 了解架构：阅读02-architecture.md理解SDK设计
- 开发应用：根据需求阅读对应的references（外设→08-peripherals.md，无线→05-wireless.md等）
- 配置构建：阅读06-build-system.md和07-development-workflow.md
- 优化性能：阅读10-memory-management.md、11-security.md、12-power-management.md
- 故障排查：在对应的references中查找常见问题部分
What it can do on your machine
Read from SKILL.md and the folder at commit 8a3df34. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
make
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
bl-mcu-sdk.readthedocs.iobbs.bouffalolab.comgithub.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Bouffalo SDK loads about 1.1k tokens when it runs, and up to ~34k if it reads all its reference files. Until then it costs about 34 tokens; SKILL.md has 207 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from bouffalolab/bouffalo_sdk at commit 8a3df34, republished under its Apache-2.0 licence (© bouffalolab). 207 words, ~1,139 tokens.
Download SKILL.mdSave it as
.claude/skills/bouffalo-sdk/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.- name
- bouffalo-sdk
- description
- Bouffalo SDK开发指南，提供完整的Bouffalo芯片系列开发文档和参考资料。当需要使用bouffalo_sdk开发IoT/MCU应用、了解SDK架构、配置构建系统、使用外设驱动、开发无线功能、管理电源、调试固件时使用此skill。
Bouffalo SDK 开发指南
本skill提供Bouffalo SDK的完整开发指南，涵盖从基础配置到高级应用的所有方面。
项目概述
Bouffalo SDK是Bouffalo Lab提供的IoT和MCU软件开发套件，支持所有Bouffalo芯片系列，包括BL602/BL702/BL616等。
开始前，阅读01-overview.md了解：
- SDK简介和芯片系列
- 目录结构和核心设计原则
- 关键特性和依赖的第三方库
- 开发环境要求和常用资源
SDK架构
理解SDK架构是高效开发的基础。
阅读02-architecture.md了解：
- 整体架构和分层设计
- LHAL（低级别硬件抽象层）设计理念
- 组件化系统和板级抽象（BSP）
- 构建系统和配置系统
- 无线协议栈架构
- 多核架构（BL618DG）
- 内存管理、安全架构、电源管理架构
LHAL驱动
LHAL提供跨芯片的统一外设API。
阅读03-lhal-drivers.md了解：
- LHAL设计和API模式
- 核心外设驱动（GPIO、UART、SPI、I2C、I2S、ADC、DAC、DMA、定时器、PWM、RTC等）
- 中断管理
- 跨芯片兼容性（设备表机制）
- 性能优化（ROM API、DMA加速）
- 最佳实践
芯片差异
不同芯片系列在外设、无线协议、内存、功耗等方面有差异。
阅读04-chips-diff.md了解：
- 各芯片系列特性和应用场景
- 外设支持矩阵
- 核心差异（单核、双核、多核）
- 内存差异（Flash、SRAM、PSRAM）
- 电源管理差异
- 编译差异（CPU_ID参数）
- 选择建议和移植指南
无线开发
SDK支持多种无线协议：WiFi 4/6、BLE、Zigbee、Thread。
阅读05-wireless.md了解：
- 无线协议支持矩阵
- WiFi架构和使用（Station、AP模式、Socket通信）
- BLE架构和使用（Peripheral、Central、GATT）
- WiFi/BLE共存（Coex）
- 无线协议选择建议（功耗、吞吐量、连接数量对比）
- 调试和测试
- 常见问题
构建系统
Bouffalo SDK使用混合构建系统：Makefile（入口）+ CMake（构建引擎）+ Kconfig（配置系统）。
阅读06-build-system.md了解：
- 构建流程和Makefile详解
- CMakeLists.txt和Kconfig语法
- 配置系统（menuconfig使用）
- 工具链配置和编译器标志
- 组件构建
- 常见构建问题
- 最佳实践
开发工作流
从环境设置到编译、烧录、调试的完整开发流程。
阅读07-development-workflow.md了解：
- 工具链安装（Windows/Linux/macOS）
- 安装构建工具和Python依赖
- 配置串口访问（Linux）
- 项目创建（基于示例或从零创建）
- 编译流程（单核/多核芯片）
- 配置管理（menuconfig）
- 烧录固件（基本烧录、多核芯片、波特率设置）
- 调试（CKLink、Eclipse、GDB初始化脚本、崩溃分析）
- 日志和调试（printf、Shell、串口查看器）
- 常见开发任务（添加自定义组件、修改启动代码、添加自定义外设驱动）
- 性能分析（Puncover、Flash使用、内存使用）
- 常见问题排查
- 版本管理和最佳实践
外设使用
通过LHAL API使用各种外设。
阅读08-peripherals.md了解：
- GPIO（中断、常用应用）
- UART（轮询、中断、DMA模式）
- SPI（主机/从机模式）
- I2C（主机模式、常用应用）
- I2S（音频接口）
- ADC（模数转换）
- DAC（数模转换）
- 定时器（中断模式）
- PWM（PWM v1/v2）
- RTC（实时时钟、闹钟）
- DMA（直接内存访问）
- 外设最佳实践（初始化顺序、错误处理、资源释放、RTOS使用、低功耗）
组件系统
SDK提供丰富的软件组件：操作系统、网络协议栈、文件系统、加密库、图形库、多媒体组件等。
阅读09-components.md了解：
- 组件目录结构
- 操作系统组件（FreeRTOS、NuttX）
- 网络组件（LwIP、MQTT-C）
- 文件系统组件（FatFS、LittleFS、ROMFS）
- 加密组件（mbedTLS）
- 图形库组件（LVGL v8/v9）
- USB组件（CherryUSB）
- 工具库组件（cJSON、partition）
- 核间通信组件（OpenAMP + RPMsg）
- Shell组件（命令行界面）
- 组件依赖管理
- 自定义组件
- 组件最佳实践
内存管理
SDK提供多种内存管理方案。
- 内存层次（Flash、SRAM、PSRAM）
- 芯片内存配置
- 内存管理方案（TLSF、FreeRTOS Heap、NuttX MM）
- Flash管理（读/写/擦除、分区、加密）
- PSRAM管理（初始化、配置、使用、分配）
- 内存对齐
- 内存优化（减少堆使用、复用内存、使用const、编译器优化）
- 内存调试（内存泄漏检测、内存破坏检测、堆栈溢出检测）
- 低功耗内存管理
- 内存映射
- 最佳实践
安全特性
SDK提供多层安全机制。
阅读11-security.md了解：
- 安全架构和硬件安全引擎
- AES加密（ECB、CBC、CTR、GCM模式）
- SHA哈希（SHA-1、SHA-224、SHA-256）
- TRNG（真随机数生成）
- PKA（公钥算法）
- 安全启动
- 安全OTA（HTTPS FOTA）
- Flash加密
- 密钥管理（EFUSE、硬件密钥存储）
- 抗回滚保护
- mbedTLS集成
- 安全最佳实践
- 安全检查清单
电源管理
SDK提供完整的电源管理功能。
- 电源模式（运行、浅睡眠、深度睡眠、休眠、关机）
- 各模式特性和对比
- 运行模式、浅睡眠、深度睡眠、休眠模式的使用
- 唤醒机制（GPIO、定时器、RTC）
- 低功耗优化（动态频率调整、关闭未使用的外设、使用低功耗模式、WiFi/BLE低功耗）
- 电源管理配置（Kconfig、动态配置）
- 状态保存和恢复
- 低功耗测量
- 多核电源管理（BL616）
- 低功耗最佳实践
- 常见问题
示例代码
SDK提供丰富的示例代码，涵盖从基础功能到复杂应用。
阅读13-examples.md了解：
- 示例目录结构
- 基础示例（helloworld）
- 外设示例（UART、SPI、I2C、ADC、PWM等）
- WiFi示例（Station、AP、HTTP请求）
- BLE示例（Peripheral、Central）
- 文件系统示例（FatFS、LittleFS）
- FreeRTOS示例
- LVGL示例
- 电源管理示例
- 使用示例的步骤
- 基于示例创建项目
- 示例最佳实践
快速开始
编译示例
# 进入示例目录
cd examples/helloworld
# 编译BL616
make CHIP=bl616 BOARD=bl616dk烧录固件
# Linux
make flash CHIP=bl616 COMX=/dev/ttyUSB0
# Windows
make flash CHIP=bl616 COMX=COM5多核芯片编译
# BL618DG ap核心
make CHIP=bl618dg BOARD=bl618dgdk CPU_ID=ap常用资源
- 项目主页: https://github.com/bouffalolab/bouffalo_sdk
- 官方文档: https://bl-mcu-sdk.readthedocs.io/
- 开发者论坛: https://bbs.bouffalolab.com/
- 芯片手册: https://github.com/bouffalolab/bl_docs
使用建议
- 新手入门：从01-overview.md开始，然后阅读13-examples.md，运行helloworld示例
- 了解架构：阅读02-architecture.md理解SDK设计
- 开发应用：根据需求阅读对应的references（外设→08-peripherals.md，无线→05-wireless.md等）
- 配置构建：阅读06-build-system.md和07-development-workflow.md
- 优化性能：阅读10-memory-management.md、11-security.md、12-power-management.md
- 故障排查：在对应的references中查找常见问题部分
© bouffalolab, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 13 other files (references) in .agents/skills/bouffalo-sdk of bouffalolab/bouffalo_sdk.
- SKILL.md
- references/01-overview.md
- references/02-architecture.md
- references/03-lhal-drivers.md
- references/04-chips-diff.md
- references/05-wireless.md
- references/06-build-system.md
- references/07-development-workflow.md
- references/08-peripherals.md
- references/09-components.md
- references/10-memory-management.md
- references/11-security.md
- references/12-power-management.md
- references/13-examples.md
Open the folder on GitHubat commit 8a3df34
Similar skills
More from bouffalolab/bouffalo_sdk
All 3 skills in this repoSDK Changelog
bouffalolab/bouffalo_sdk
A skill your agent uses when generating a customer-facing CHANGELOG between two SDK release tags.
Questions about Bouffalo SDK
What does Bouffalo SDK do?
Bouffalo SDK开发指南，提供完整的Bouffalo芯片系列开发文档和参考资料。当需要使用bouffalosdk开发IoT/MCU应用、了解SDK架构、配置构建系统、使用外设驱动、开发无线功能、管理电源、调试固件时使用此skill。. Bouffalo SDK is an agent skill from bouffalolab/bouffalo_sdk.
How do I install Bouffalo SDK in Claude Code?
Run `npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a claude-code`. Or copy the skill folder (.agents/skills/bouffalo-sdk in bouffalolab/bouffalo_sdk) into .claude/skills/bouffalo-sdk in your project. Claude Code loads it when a task matches its description.
How do I install Bouffalo SDK in Codex?
Run `npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a codex`. Or copy the skill folder (.agents/skills/bouffalo-sdk in bouffalolab/bouffalo_sdk) into .agents/skills/bouffalo-sdk in your project. Codex loads it when a task matches its description.
Can I use Bouffalo SDK in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bouffalolab/bouffalo_sdk --skill bouffalo-sdk -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bouffalo-sdk, .gemini/skills/bouffalo-sdk, .github/skills/bouffalo-sdk and .opencode/skills/bouffalo-sdk in your project.
What does Bouffalo SDK need to run?
Going by SKILL.md and its folder, Bouffalo SDK needs the command-line tools its instructions call (make).
Does Bouffalo SDK access the network?
SKILL.md names 3 domains. As links in the text: bl-mcu-sdk.readthedocs.io, bbs.bouffalolab.com and github.com. This is read from the text; nothing was executed.
Is Bouffalo SDK safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Bouffalo SDK use?
Bouffalo SDK is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Bouffalo SDK use?
About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 33k tokens, read only when the agent opens those files.
What are the alternatives to Bouffalo SDK?
Skills that share tags, products or a category with Bouffalo SDK: Test Manual (bouffalolab/bouffalo_sdk, 500 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Bouffalo SDK?
bouffalolab (a GitHub organization) maintains it in bouffalolab/bouffalo_sdk, which has 500 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 3, 2026.
Source: bouffalolab/bouffalo_sdk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.