Example 2: LED blinking

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

• Overview
• Wiring
• JSON Configuration Example
• PeriphExec Linkage
• Notes

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

示例2:LED闪烁

实验概述

通过定时切换 GPIO 输出状态实现 LED 闪烁效果。在 FastBee 中，可以使用外设执行的定时触发器配合 GPIO 切换动作来实现，无需编写代码。

硬件接线

开发板标识	GPIO引脚	连接设备
D1	GPIO15	LED（低电平点亮）

使用任意一个 LED 即可，本例使用 D1（GPIO15）。

JSON 配置示例

{
  "peripherals": [
    {
      "id": "led_blink",
      "name": "LED闪烁灯",
      "type": 12,
      "enabled": false,
      "pins": [15],
      "params": {
        "initialState": 1
      }
    }
  ]
}

外设执行联动

场景：定时闪烁LED（定时触发）

功能：每500ms自动切换LED状态，实现闪烁效果

Web界面配置步骤

步骤1：创建规则

1. 点击左侧菜单 外设配置 → 切换到 外设执行管理 标签
2. 点击 新增规则 按钮
3. 填写基础配置：
   • 规则名称：LED定时闪烁
   • 上报数据：❌ 禁用
   • 启用：✅ 启用

步骤2：配置触发器

1. 点击 添加触发 按钮

2. 填写触发器配置：

   字段	填写内容	说明
   触发类型	选择 定时触发	按时间间隔执行
   定时模式	选择 间隔定时	每隔X秒执行
   间隔秒数	0.5	每0.5秒（500ms）执行一次

步骤3：配置动作

1. 点击 添加动作 按钮

2. 填写动作配置：

   字段	填写内容	说明
   动作类型	选择 切换电平	翻转GPIO状态
   目标外设	选择 led_blink	要控制的LED

3. 点击 保存 按钮

执行流程：

每500ms
  ↓
读取 led_blink 当前状态
  ↓
取反：HIGH→LOW 或 LOW→HIGH
  ↓
LED亮灭切换

可调节闪烁频率

修改 间隔秒数 即可改变闪烁速度：

| 间隔值 | 闪烁效果 | 适用场景 | |--------|---------|---------|| | 0.1 | 快闪（100ms） | 紧急报警 | | 0.5 | 正常闪烁（500ms） | 状态指示 | | 1.0 | 慢闪（1秒） | 低功耗提示 |

注意事项

1. 定时器精度：ESP32 定时器精度约 1ms，低于 10ms 的间隔可能不稳定
2. 多LED闪烁：可在同一规则中添加多个 gpio_toggle 动作
3. 停止闪烁：禁用该外设执行规则即可停止
4. gpio_toggle：自动读取当前引脚状态并取反，无需记录状态