Example 28: reed switch sensor

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.

示例28:干簧管传感器

实验概述

干簧管（磁控开关）在靠近磁铁时触点闭合导通，适用于门窗开关检测、水表脉冲计数等应用。无磁场时触点断开，有磁场时闭合。

硬件接线

开发板标识	GPIO引脚	连接设备
REED	GPIO4	干簧管模块（DO数字输出）

JSON 配置示例

{
  "peripherals": [
    {
      "id": "reed_01",
      "name": "干簧管传感器",
      "type": 13,
      "enabled": false,
      "pins": [4],
      "params": {}
    }
  ]
}

外设执行联动

场景：门窗开启报警（轮询触发）

功能：每200ms检测门窗状态，当门窗打开时触发蜂鸣器报警

Web界面配置步骤

步骤1：确保已配置蜂鸣器外设

• 外设ID：buzzer_gpio
• 类型：GPIO输出

步骤2：创建规则

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

步骤3：配置触发器（轮询触发）

1. 点击 添加触发 按钮

2. 填写触发器配置：

   字段	填写内容	说明
   触发类型	选择 轮询触发	定时检测条件
   目标外设	选择 reed_01	干簧管传感器
   轮询间隔	200	200ms
   条件表达式	value == 1	高电平=门窗打开

步骤4：配置动作（需要2个动作）

动作1：蜂鸣器报警

1. 点击 添加动作 按钮
2. 填写：
   • 动作类型：选择 高电平
   • 目标外设：选择 buzzer_gpio

动作2：发送报警事件

1. 再次点击 添加动作 按钮

2. 填写：

   • 动作类型：选择 发送事件
   • 事件类型：alarm
   • 事件消息：门窗已打开

3. 点击 保存 按钮

安装说明

组件	安装位置	说明
磁铁	门/窗扇上	随门窗移动
干簧管	门框/窗框上	固定不动
触发距离	10-20mm	典型距离

注意事项

1. 安装位置：磁铁贴在门/窗扇上，干簧管固定在门框/窗框上
2. 触发距离：典型触发距离 10-20mm
3. 计数应用：水表/气表脉冲计数可使用中断方式（type: 18）
4. 密封性：户外使用需防水密封