Skip to content

平台触发(PLATFORM_TRIGGER) ​

平台触发(triggerType=0)处理 MQTT 平台下发的 id/value 数据。先完成网络、MQTT 和订阅主题配置,再创建规则;它不用于本地传感器采样告警。

字段与模式 ​

字段含义
triggerPeriphId必填,精确匹配下发数组中项目的 id;空串或 "null" 不匹配数据
operatorType=0匹配模式:value 转为字符串后与 compareValue 精确相等
operatorType=1设置模式:只匹配 ID,接受任意接收值,不执行“不等于”比较
operatorType=2..9大于、小于、大于等于、小于等于、区间内、区间外、包含、不包含
compareValue匹配或比较值;区间写为 "20,30"

设置模式适合接收 PWM、显示内容或协议参数。动作需要明确启用 useReceivedValue 或使用受支持的 $value 模板;每类动作仍会校验目标、范围、来源和运行状态。ID 匹配成功不代表任意字符串都可驱动输出。

示例:接收调光值 ​

先创建并启用 led_pwm PWM 外设,确认分辨率和安全输出范围。规则先保存为停用,确认配置后再启用:

json
{
  "id": "exec_platform_pwm",
  "name": "exec_platform_pwm",
  "enabled": false,
  "execMode": 0,
  "triggers": [
    {
      "triggerType": 0,
      "triggerPeriphId": "brightness",
      "operatorType": 1,
      "compareValue": ""
    }
  ],
  "actions": [
    {
      "targetPeriphId": "led_pwm",
      "actionType": 4,
      "actionValue": "",
      "useReceivedValue": true,
      "syncDelayMs": 0,
      "execMode": 0
    }
  ],
  "reportAfterExec": false,
  "allowPanelControl": false,
  "recordHistory": false
}

向实际配置的下发主题发送:

json
[
  {
    "id": "brightness",
    "value": "128"
  }
]

128 是原始 PWM 占空比计数,不是 128%。不要把下发 ID brightness 与本地输出 ID led_pwm 混为一项。

确认与排错 ​

核对 MQTT 的实际实例、订阅主题、完整 JSON 数组及 ID;再检查规则与目标是否启用、参数是否有效、功能与资源是否就绪。下发回复、执行入队和协议确认分别表示不同阶段,输出或负载仍须现场验证。配置、协议实例或来源已变化时,旧命令不能改投新目标。

本地阈值告警使用数据事件;动作参数及重试边界见动作检查。

蜂信物联 | fastbee.cn