Device Event Virtual Peripheral

fastbeeAbout 3 min

Device Event Virtual Peripheral

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

Peripheral capability, supported device types, and wiring constraints.
Web console configuration fields and recommended parameter values.
PeriphExec integration, validation steps, and troubleshooting 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.

设备事件虚拟外设

功能说明

设备事件（DEVICE_EVENT）是一种虚拟外设，不对应物理硬件，仅作为事件发射源。通过外设执行规则中的 ACTION_TRIGGER_EVENT(21) 动作触发事件，事件可通过 MQTT DEVICE_EVENT 主题上报至平台，也可被其他规则订阅实现链式联动。

设备事件通常和外设执行规则配合使用：在外设配置中保留虚拟事件对象，在外设执行中通过“触发事件”动作或事件触发器串联规则。

支持的外设类型

类型	type值	说明
DEVICE_EVENT	60	设备事件虚拟外设

无需硬件

不使用 GPIO 引脚（pinCount = 0）
纯逻辑层面的事件源定义
通过规则引擎触发和响应

JSON 配置示例

设备故障事件

{
  "id": "evt_fault",
  "name": "设备故障事件",
  "type": 60,
  "enabled": false,
  "pins": [],
  "params": {}
}

自定义报警事件

{
  "id": "evt_alarm",
  "name": "自定义报警",
  "type": 60,
  "enabled": false,
  "pins": [],
  "params": {}
}

与外设执行联动

触发设备事件（ACTION_TRIGGER_EVENT = 21）

在规则动作中触发事件：

{
  "targetPeriphId": "evt_alarm",
  "actionType": 21,
  "actionValue": "温度超限",
  "useReceivedValue": false,
  "syncDelayMs": 0,
  "execMode": 0
}

触发后：

事件以规则 ID 为事件源分发给其他规则
若规则 reportAfterExec: true，通过 MQTT DEVICE_EVENT 主题上报

订阅事件（作为触发源）

其他规则可通过事件触发器订阅该事件：

{
  "triggerType": 4,
  "triggerPeriphId": "",
  "eventId": "exec_1234567"
}

eventId 为触发事件的规则 ID，实现规则间的链式联动。

完整链式联动示例

规则A：温度超限 → 触发报警事件

{
  "id": "exec_temp_check",
  "name": "温度超限检测",
  "enabled": false,
  "execMode": 0,
  "triggers": [
    {
      "triggerType": 0,
      "triggerPeriphId": "dht1",
      "operatorType": 2,
      "compareValue": "40",
      "timerMode": 0,
      "intervalSec": 60,
      "timePoint": "",
      "eventId": "",
      "pollResponseTimeout": 1000,
      "pollMaxRetries": 2,
      "pollInterPollDelay": 100
    }
  ],
  "actions": [
    {
      "targetPeriphId": "evt_alarm",
      "actionType": 21,
      "actionValue": "高温报警",
      "useReceivedValue": false,
      "syncDelayMs": 0,
      "execMode": 0
    }
  ],
  "protocolType": 0,
  "scriptContent": "",
  "reportAfterExec": true
}

规则B：响应报警事件 → 执行蜂鸣器

{
  "id": "exec_alarm_action",
  "name": "报警响应",
  "enabled": false,
  "execMode": 0,
  "triggers": [
    {
      "triggerType": 4,
      "triggerPeriphId": "",
      "operatorType": 0,
      "compareValue": "",
      "timerMode": 0,
      "intervalSec": 60,
      "timePoint": "",
      "eventId": "exec_temp_check",
      "pollResponseTimeout": 1000,
      "pollMaxRetries": 2,
      "pollInterPollDelay": 100
    }
  ],
  "actions": [
    {
      "targetPeriphId": "buzzer",
      "actionType": 2,
      "actionValue": "500",
      "useReceivedValue": false,
      "syncDelayMs": 0,
      "execMode": 0
    }
  ],
  "protocolType": 0,
  "scriptContent": "",
  "reportAfterExec": false
}

系统内置设备事件

系统预定义了以下设备事件 ID（无需手动配置 DEVICE_EVENT 外设）：

事件ID	EventType	说明
sys_breakdown	110	设备故障
sys_restart	111	设备重启
device_alarm	112	设备告警
low_power	113	低电量预警

注意事项

无物理操作：DEVICE_EVENT 不控制任何硬件，仅用于逻辑事件传递
链式限制：避免创建循环触发链（A触发B → B触发A），可能导致无限循环
MQTT 上报：事件通过 DEVICE_EVENT 主题上报时会携带事件名称和数据
去重保护：同一事件最小触发间隔 500ms，防止快速重复触发