快速开始

fastbee大约 8 分钟

快速开始

本文面向第一次使用 FastBee-Arduino 的用户,按最短路径完成从烧录固件到创建联动规则的完整流程。全程无需编程,仅需 5 步即可让 ESP32 变成可控的物联网终端。

环境准备

必需工具

VSCode + PlatformIO IDE 插件 (推荐),或 PlatformIO CLI
ESP32 系列开发板 (ESP32/ESP32-S3/ESP32-C3/ESP32-C6)
USB 数据线 (支持数据传输)

可选工具

DHT11 温湿度传感器
继电器模块
面包板和杜邦线

第一步: 烧录固件

1.1 选择固件版本

本项目基于 Arduino-ESP32 3.x（ESP-IDF 5.1+）构建，支持三个版本层级：

固件环境	版本层级	适用芯片	推荐用途
`esp32c3-F4R0`	Lite	ESP32-C3	低成本节点
`esp32c6-F4R0`	Lite	ESP32-C6	WiFi 6 低成本节点
`esp32-F4R0`	Standard	ESP32	4MB 默认量产版本
`esp32s3-F8R0`	Standard+OTA	ESP32-S3	标准版 + OTA
`esp32s3-F16R8`	Full	ESP32-S3	OTA + 多用户 + RuleScript + 多语言

建议: 首次使用优先选择 esp32-F4R0 标准版。低成本场景选择 esp32c3-F4R0。需要完整管理功能时选择带 PSRAM 的 esp32s3-F16R8。

注意: ESP32-C6 需使用 pioarduino 社区平台，详见版本对比指南。

1.2 一键构建并烧录

打开终端,进入项目目录:

cd D:\project\gitee\FastBee-Arduino

推荐使用项目提供的部署脚本。脚本会先上传与版本匹配的 LittleFS Web 文件系统,再烧录固件:

powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -Env esp32-F4R0 -Port COM6

ESP32-S3 标准版:

powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -Env esp32s3-F8R0 -Port COM6

ESP32-S3 全功能版:

powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -Env esp32s3-F16R8 -Port COM6

只编译不上传:

powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -Env esp32s3-F16R8 -BuildOnly

Web 文件系统和固件版本必须配套。不要把 esp32s3-F16R8 的 Web 文件系统和 esp32-F4R0 固件混合烧录。

默认外设和外设执行规则都是安全模板：烧录后不会自动驱动 GPIO、UART 或显示屏。首次接线请先确认引脚、供电和外设 ID，再在 Web 中启用对应外设和规则。

1.3 部署后检查

烧录完成并启动后,可以运行接口冒烟测试:

powershell -ExecutionPolicy Bypass -File scripts\smoke-test-device.ps1 -BaseUrl http://192.168.4.1 -Profile standard

如果设备已经连入局域网,把地址替换为实际 IP:

powershell -ExecutionPolicy Bypass -File scripts\smoke-test-device.ps1 -BaseUrl http://192.168.5.116 -Profile full

1.4 查看串口日志

pio device monitor -e esp32-F4R0 -b 115200

应看到芯片信息、内存状态和启动日志。

第二步: 初始配置

2.1 连接设备

设备首次启动或 WiFi 未配置时,自动进入 AP 模式
手机/电脑 WiFi 连接设备热点: FastBee-XXXX (无密码)
浏览器访问: http://192.168.4.1 或 http://fastbee.local
使用默认账号登录:
- 用户名: admin
- 密码: admin123

登录成功后应能看到仪表盘中的网络状态、IP 地址和资源使用信息。如果页面能打开但数据为空，先等待设备启动完成，或刷新页面重新登录。

2.2 配置网络

进入 网络配置 页面
选择联网方式:
- WiFi STA (所有版本): 填写您的 WiFi SSID 和密码
- 以太网 (标准版/全功能版): 确认 W5500 SPI 引脚
- 4G (标准版/全功能版): 填写 APN 和串口引脚
- LoRa (全功能版): 确认串口引脚和网关在线
点击保存,设备重启并连接网络
连接成功后,可通过路由器分配的 IP 或 http://fastbee.local 访问

网络页顶部会显示当前连接状态、SSID、IP 地址和信号强度；下方页签分别用于 STA 基础配置、AP 热点配置和静态 IP/mDNS 等高级配置。

Lite 默认只保留 WiFi/mDNS/MQTT 和基础外设能力。如需以太网、4G 或 Modbus，请选择 esp32-F4R0 或 esp32s3-F8R0 标准版。

第三步: 配置外设

3.1 添加 DHT11 温湿度传感器

进入 外设配置 页面
点击 添加外设
填写配置:
- 外设ID: dht_01
- 名称: DHT11温湿度
- 类型: SENSOR (type: 38)
- 引脚: 13 (根据实际接线修改)
- 启用: 先保持禁用,确认引脚后再启用
点击保存

外设配置页会列出现有外设和启用状态。新增外设时，先填写外设 ID、名称、类型和引脚，确认接线后再启用。

JSON 配置示例:

{
  "id": "dht_01",
  "name": "DHT11温湿度",
  "type": 38,
  "enabled": false,
  "pinCount": 1,
  "pins": [13, 255, 255, 255, 255, 255, 255, 255],
  "params": {}
}

3.2 添加继电器

点击 添加外设
填写配置:
- 外设ID: relay_01
- 名称: 高温联动继电器
- 类型: GPIO_DIGITAL_OUTPUT (type: 12)
- 引脚: 25 (根据实际接线修改)
- 初始状态: 0 (低电平)
点击保存

JSON 配置示例:

{
  "id": "relay_01",
  "name": "高温联动继电器",
  "type": 12,
  "enabled": false,
  "pinCount": 1,
  "pins": [25, 255, 255, 255, 255, 255, 255, 255],
  "params": {
    "initialState": 0,
    "pwmChannel": 0,
    "pwmFrequency": 1000,
    "pwmResolution": 8,
    "defaultDuty": 0
  }
}

3.3 启用外设

确认引脚接线正确
在外设列表中勾选启用
点击 保存全部
串口日志应显示外设初始化成功

第四步: 创建联动规则

4.1 温度超限报警规则

进入 外设执行 页面
点击 添加规则
填写基本信息:
- 规则ID: exec_temp_relay
- 名称: 温度大于30度打开继电器
- 启用: 先保持禁用,测试后启用

4.2 配置触发器

添加触发器:
- 触发类型: 定时触发 (triggerType: 1)
- 触发外设: dht_01
- 时间模式: 周期触发
- 间隔秒数: 10 (每 10 秒读取一次)
点击 保存触发器

4.3 配置动作

动作1: 读取温度传感器

添加动作:

目标外设: dht_01
动作类型: 传感器读取 (actionType: 19)

动作参数:

{
  "periphId": "dht_01",
  "sensorCategory": "dht11",
  "dataField": "temperature",
  "sensorLabel": "温度",
  "unit": "°C",
  "decimalPlaces": 1
}

点击 保存动作

动作2: 打开继电器

添加动作:
- 目标外设: relay_01
- 动作类型: GPIO高电平 (actionType: 0)
- 同步延时: 100 毫秒
点击 保存动作

4.4 保存并启用规则

设置 执行后上报: true
点击 保存规则
测试规则逻辑正确后,勾选启用
点击 保存全部

外设执行页用于查看规则状态、触发方式、目标外设和动作。首次导入或创建规则建议保持禁用，先点“执行一次”或编辑检查参数，再启用。

规则编辑窗口会按触发器和动作类型展开不同字段，保存前重点核对目标外设、比较值、动作参数和“启用”状态。

外设执行规则表单安全检查

快速开始阶段建议只启用一条简单规则。确认继电器、传感器读取和日志都正常后，再继续扩展到平台触发、事件触发或多动作联动。

完整 JSON 配置:

{
  "id": "exec_temp_relay",
  "name": "温度大于30度打开继电器",
  "enabled": false,
  "execMode": 0,
  "triggers": [
    {
      "triggerType": 1,
      "triggerPeriphId": "dht_01",
      "timerMode": 0,
      "intervalSec": 10,
      "timePoint": "",
      "eventId": "",
      "operatorType": 0,
      "compareValue": "",
      "pollResponseTimeout": 1000,
      "pollMaxRetries": 2,
      "pollInterPollDelay": 100
    }
  ],
  "actions": [
    {
      "targetPeriphId": "dht_01",
      "actionType": 19,
      "actionValue": "{\"periphId\":\"dht_01\",\"sensorCategory\":\"dht11\",\"dataField\":\"temperature\",\"sensorLabel\":\"温度\",\"unit\":\"°C\",\"decimalPlaces\":1}",
      "useReceivedValue": false,
      "syncDelayMs": 0,
      "execMode": 0
    },
    {
      "targetPeriphId": "relay_01",
      "actionType": 0,
      "actionValue": "",
      "useReceivedValue": false,
      "syncDelayMs": 100,
      "execMode": 0
    }
  ],
  "protocolType": 0,
  "scriptContent": "",
  "reportAfterExec": true
}

第五步: 配置云端连接 (可选)

5.1 MQTT 配置

进入 通信协议 页面
选择 MQTT 标签页
填写配置:
- 服务器地址: mqtt.your-server.com
- 端口: 1883 (非加密) 或 8883 (TLS)
- 客户端ID: 自动生成或手动填写
- 用户名/密码: 根据服务器要求
- 主题前缀: fastbee/device01
点击 保存并连接
查看连接状态,确认成功