ESP32-C6 Blink 快速入门

实验概述

通过 nanoESP32-C6 开发板的板载 WS2812B 全彩 LED（GPIO8），体验 FastBee 从固件烧录 → 配网 → 外设控制 → 平台远程操作的完整流程。

硬件信息

nanoESP32-C6 基于乐鑫 ESP32-C6 模组，板载 USB 转串口、Type-C 接口和 WS2812B 全彩 LED。

项目	说明
模组	ESP32-C6（RISC-V，WiFi 6 + BLE 5）
板载 LED	WS2812B，连接 GPIO8
接口	Type-C（USB 转串口）+ 调试串口 + ESP32-C6 USB

实现流程

步骤1：烧录固件

方式A — 在线烧录（推荐）

1. 打开 在线烧录工具
2. 选择波特率 → 选择串口 → 选择固件文件 fastbee-esp32c6-F4R0.bin
3. 点击 烧录 按钮，等待完成

方式B — 源码烧录

powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -Env esp32c6-F4R0 -Port <serial-port>

详见 烧录与测试。

esp32c6-F4R0 是 4MB 单 app 环境，不支持 OTA，且不编译以太网和 4G；本例仅使用 WiFi。

步骤2：配置网络

1. 固件烧录后设备重启，电脑连接 WiFi 热点 fastbee-xxxx（密码：admin123）
2. 浏览器访问 http://192.168.4.1 或 http://fastbee.local，使用 admin / admin123 登录
3. 进入 网络配置，模式选择 客户端模式（STA），填写 WiFi 名称和密码，点击保存
4. 等待设备重启，电脑重新连接正常 WiFi，再通过核验后的STA地址访问设备；mDNS实际启用且解析成功时才使用fastbee.local

AP 仅用于首次配置和恢复。日常使用及脚本验证应切换到 STA，并使用路由器分配的设备地址；测试脚本会拒绝 192.168.4.1。

步骤3：外设配置

先在 功能配置 中启用 NeoPixel LED 并重启，再进入 外设配置 页面新建外设：

字段	填写内容
名称	自定义（如 板载彩灯）
引脚	8（对应 GPIO8）
外设类型	WS2812B

步骤4：外设执行配置

进入 外设执行管理 页面，新建执行规则：

本地定时触发（基础）

1. 触发类型选择 定时触发，设置间隔时间
2. 执行动作选择 灯效控制，从预设列表选择灯效（红色、绿色、蓝色、关闭、彩虹循环等）

平台远程触发（可选）

如需通过物联网平台远程控制，触发类型选择 平台触发（MQTT）。red是灯效值，平台物模型ID应匹配规则的triggerPeriphId（例如rgb_led）。动作参数设置为 $value-平台下发 。

步骤5：FastBee 平台配置（可选）

1. 平台端

在 FastBee 物联网平台 创建产品，获取以下信息：

信息	说明
产品 ID	产品唯一标识
MQTT 账号/密码	设备连接凭证
物模型 ID	需与外设执行中的触发外设 ID 一致（如 rgb_led）

2. 设备端

在设备 Web 页面配置：

• 设备配置 → 基本信息中填写 产品编号
• 通信协议 → 配置 MQTT 参数：

参数	值
服务器	iot.fastbee.cn（演示地址）
端口	1883（默认）
账号/密码	平台获取的凭证
客户端 ID	格式：S&设备编号&产品ID&1

步骤6：远程控制（可选）

MQTT 连接成功后，FastBee物联网平台会自动创建一个设备，可通过以下方式远程控制板载彩灯：

• Web 端：在物联网平台页面下发灯效指令
• 手机端：通过 FastBee App 远程控制

步骤7：验证

连接 STA 后，在源码仓库执行：

powershell -ExecutionPolicy Bypass -File scripts\smoke-test-device.ps1 -BaseUrl http://<device-sta-ip> -Profile unified -RequireNetworkConnected
powershell -ExecutionPolicy Bypass -File scripts\device-web-smoke.ps1 -BaseUrl http://<device-sta-ip> -Rounds 2 -DelayMs 1000 -TimeoutSec 15 -MaxElapsedMs 5000

导入前先备份现场身份、网络、认证及业务配置，并开启开发模式。下方外设与规则保持禁用，核验引脚和接线后按需启用；禁用配置不是已经完成硬件验证。

配置导入

该示例的外设配置和外设执行规则可以直接导入。打开 设备配置 → 高级配置 → 导入配置，导入后重启；真实 WiFi 和平台凭据应在本地填写，不要写入公开示例。

{
  "type": "fastbee-config-bundle",
  "version": 1,
  "scope": "selected",
  "exportedAt": "2026-06-30T03:44:13.185Z",
  "files": [
    {
      "name": "periph_exec.json",
      "content": "{\"rules\":[{\"id\":\"exec_001\",\"name\":\"定时变色灯\",\"enabled\":false,\"execMode\":0,\"triggers\":[{\"triggerType\":1,\"triggerPeriphId\":\"\",\"operatorType\":0,\"compareValue\":\"\",\"timerMode\":0,\"intervalSec\":5,\"timePoint\":\"08:00\",\"eventId\":\"\",\"pollResponseTimeout\":1000,\"pollMaxRetries\":2,\"pollInterPollDelay\":100}],\"actions\":[{\"targetPeriphId\":\"rgb_led\",\"actionType\":11,\"actionValue\":\"rainbow\",\"useReceivedValue\":false,\"syncDelayMs\":0,\"execMode\":0}],\"protocolType\":0,\"scriptContent\":\"\",\"reportAfterExec\":false},{\"id\":\"exec_145380\",\"name\":\"平台控制灯色\",\"enabled\":false,\"execMode\":0,\"triggers\":[{\"triggerType\":0,\"triggerPeriphId\":\"rgb_led\",\"operatorType\":1,\"compareValue\":\"\",\"timerMode\":0,\"intervalSec\":60,\"timePoint\":\"\",\"eventId\":\"\",\"pollResponseTimeout\":1000,\"pollMaxRetries\":2,\"pollInterPollDelay\":100}],\"actions\":[{\"targetPeriphId\":\"rgb_led\",\"actionType\":11,\"actionValue\":\"$value\",\"useReceivedValue\":false,\"syncDelayMs\":0,\"execMode\":0}],\"protocolType\":0,\"scriptContent\":\"\",\"reportAfterExec\":true}]}"
    },
    {
      "name": "peripherals.json",
      "content": "{\"peripherals\":[{\"id\":\"rgb_led\",\"name\":\"板载全彩LED\",\"type\":45,\"enabled\":false,\"pins\":[8],\"pinCount\":1,\"params\":{\"count\":1,\"brightness\":128}}]}"
    }
  ]
}

相关链接

资源	地址
FastBee 平台源码	gitee.com/beecue/fastbee
FastBee 移动端源码	gitee.com/beecue/fastbee-app
nanoESP32-C6 开发板	淘宝购买