Example 27: vibration 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.

示例27:震动传感器

实验概述

震动传感器（SW-420）检测到震动时输出数字信号，适用于防盗报警、碰撞检测等应用。传感器内部为弹簧式触点，震动时触点断开输出高电平。

硬件接线

开发板标识	GPIO引脚	连接设备
VIB	GPIO4	震动传感器数字输出（DO）

JSON 配置示例

{
  "peripherals": [
    {
      "id": "vibration_01",
      "name": "震动传感器",
      "type": 18,
      "enabled": false,
      "pins": [4],
      "params": {}
    }
  ]
}

外设执行联动

场景：震动报警（事件触发）

功能：检测到震动时触发蜂鸣器报警2秒

Web界面配置步骤

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

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

步骤2：创建规则

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

步骤3：配置触发器（事件触发）

1. 点击 添加触发 按钮

2. 填写触发器配置：

   字段	填写内容	说明
   触发类型	选择 事件触发	响应中断事件
   事件类型	100	GPIO中断事件
   事件来源	vibration_01	震动传感器外设ID

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

动作1：蜂鸣器响

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

动作2：延时2秒

1. 再次点击 添加动作 按钮
2. 填写：
   • 动作类型：选择 延时
   • 动作参数：2000

动作3：蜂鸣器停

1. 第三次点击 添加动作 按钮

2. 填写：

   • 动作类型：选择 低电平
   • 目标外设：选择 buzzer_gpio

3. 点击 保存 按钮

检测方式对比

方式	外设类型	优点	缺点
中断触发	type: 18	响应快、省电	可能多次触发
轮询检测	type: 11	简单可靠	占用CPU

注意事项

1. 灵敏度调节：部分模块带电位器可调节灵敏度
2. 误触发：高灵敏度时风吹、声音都可能触发
3. 中断方式推荐：使用上升沿中断（type: 18）避免轮询开销
4. 防抖：一次震动可能产生多次触发，建议设置 1-2 秒冷却期