平台触发(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;再检查规则与目标是否启用、参数是否有效、功能与资源是否就绪。下发回复、执行入队和协议确认分别表示不同阶段,输出或负载仍须现场验证。配置、协议实例或来源已变化时,旧命令不能改投新目标。

