MQTT警报控制面板


mqtt警报面板平台使可能控制MQTT有能力的警报面板。警报图标将在从中收到新状态后改变状态state_topic。如果这些消息与保持标志,MQTT警报面板将在订阅后接收即时状态更新,并以正确的状态开始。否则,初始状态将是未知

集成将接受警报面板中的以下状态(在较低情况下):

  • 解除武装
  • Armed_home
  • Armed_away
  • Armed_night
  • Armed_vacation
  • Armed_custom_bypass
  • 待办的
  • 触发
  • 武装
  • 解除武装

集成可以通过发布到command_topic当用户与家庭助理前端互动时。必威是什么

配置

要启用此平台,请在您的configuration.yaml

#示例Configuration.yaml条目mqttalarm_control_panel-state_topic主页/警报”command_topic主页/警报/设置”

以前的配置格式

配置变量

可用性 列表 ((可选的

MQTT主题列表订阅以接收可用性(在线/离线)更新。不得一起使用availability_topic

payload_available 细绳 ((可选的,默认:在线

代表可用状态的有效载荷。

payload_not_available 细绳 ((可选的,默认:离线

代表不可用状态的有效载荷。

话题 细绳 必需的

MQTT主题订阅以接收可用性(在线/离线)更新。

value_template 模板 ((可选的

定义a模板从中提取设备的可用性话题。为了确定设备的可用性结果,将与payload_availablepayload_not_available

availability_mode 细绳 ((可选的,默认:最新

什么时候可用性已配置,这控制了将实体设置为可用的。有效的条目是全部,,,,任何, 和最新的。如果设置为全部,,,,payload_available在实体被标记为在线之前,必须在所有配置的可用性主题上收到。如果设置为任何,,,,payload_available在实体被标记为在线之前,必须在至少一个配置的可用性主题上收到。如果设置为最新的, 最后payload_available或者payload_not_available在任何配置的可用性主题上都收到了可用性。

availability_template 模板 ((可选的

定义a模板从中提取设备的可用性availability_topic。为了确定设备的可用性结果,将与payload_availablepayload_not_available

availability_topic 细绳 ((可选的

MQTT主题订阅以接收可用性(在线/离线)更新。不得一起使用可用性

代码 细绳 ((可选的

如果定义,请指定代码以启用或禁用前端中的警报。请注意,该代码已在本地验证,并阻止将MQTT消息发送到远程设备。对于远程代码验证,可以将代码配置为特殊值之一远程_Code(数字代码)或远程_code_text(文本代码)。在这种情况下,本地代码验证将被绕过,但前端仍将显示数字代码对话框。利用command_template将代码发送到远程设备。远程代码验证的示例配置可以在这里找到

code_arm_required 布尔 ((可选的,默认:正确

如果是正确的,则需要代码来武装警报。如果错误,则未验证代码。

code_disarm_required 布尔 ((可选的,默认:正确

如果是正确的,则需要代码解除警报。如果错误,则未验证代码。

code_trigger_required 布尔 ((可选的,默认:正确

如果是正确的,则需要代码触发警报。如果错误,则未验证代码。

command_template 细绳 ((可选的,默认:操作

模板用于命令有效载荷。可用变量:行动代码

command_topic 细绳 必需的

MQTT主题发布命令以更改警报状态。

设备 地图 ((可选的

有关设备的信息此警报面板是将其绑在设备注册表。只能通过MQTT发现什么时候唯一身份设置。必须至少存在一个标识符或连接以识别设备。

configuration_url 细绳 ((可选的

可以管理此设备配置的网页的链接。可以是HTTP或HTTPS链接。

连接 列表 ((可选的

该设备与外界的连接列表作为元组列表[Connection_Type,Connection_Identifier]。例如,网络接口的MAC地址:“连接”:[[“ Mac”,“ 02:5b:26:A8:DC:12”]]

身份标识 列表|细绳 ((可选的

唯一标识设备的ID列表。例如序列号。

制造商 细绳 ((可选的

设备的制造商。

模型 细绳 ((可选的

设备的模型。

姓名 细绳 ((可选的

设备的名称。

建议_area 细绳 ((可选的

如果该设备还没有,则建议一个区域。

sw_version 细绳 ((可选的

设备的固件版本。

via_device 细绳 ((可选的

该设备与家庭助理之间路由消息的设备的标识符。必威是什么此类设备的示例是枢纽或子设备的父设备。这用于在家庭助理中显示设备拓扑。必威是什么

enabled_by_default 布尔 ((可选的,默认:正确

标志,该标志首先添加时定义是否应启用实体。

编码 细绳 ((可选的,默认:UTF-8

收到和已发布消息的有效载荷的编码。调成“”禁用传入有效载荷的解码。

Entity_Category 细绳 ((可选的,默认:无

类别实体。

图标 图标 ((可选的

图标对于实体。

JSON_ATTRIBUTES_TEMPLATE 模板 ((可选的

定义a模板从收到的消息中提取JSON字典JSON_ATTRIBUTES_TOPIC。使用示例可以在MQTT传感器文档。

JSON_ATTRIBUTES_TOPIC 细绳 ((可选的

MQTT主题订阅以接收JSON字典有效载荷,然后将其设置为传感器属性。使用示例可以在MQTT传感器文档。

姓名 细绳 ((可选的,默认:MQTT警报

警报的名称。

object_id 细绳 ((可选的

代替姓名用于自动生成ENTITY_ID

payload_arm_away 细绳 ((可选的,默认:ARM_AWAW

在警报面板上设置武装模式的有效载荷。

payload_arm_home 细绳 ((可选的,默认:ARM_HOME

有效载荷在警报面板上设置武装屋模式。

payload_arm_night 细绳 ((可选的,默认:arm_night

在警报面板上设置武装夜模式的有效载荷。

payload_arm_vacation 细绳 ((可选的,默认:ARM_VACATION

在警报面板上设置武装剥离模式的有效载荷。

PAYLOAD_ARM_CUSTOM_BYPASS 细绳 ((可选的,默认值:arm_custom_bypass

在警报面板上设置武装的武装 - bypass模式的有效载荷。

payload_available 细绳 ((可选的,默认:在线

代表可用状态的有效载荷。

payload_disarm 细绳 ((可选的,默认:解除武器

有效载荷解除警报面板。

payload_not_available 细绳 ((可选的,默认:离线

代表不可用状态的有效载荷。

payload_trigger 细绳 ((可选的,默认:触发器

有效载荷以触发警报面板上的警报。

QoS 整数 ((可选的,默认:0

国家主题的最大QoS级别。

保持 布尔 ((可选的,默认:false

是否已发表的消息应在是否有保留标志。

state_topic 细绳 必需的

MQTT主题订阅以接收状态更新。

唯一身份 细绳 ((可选的

唯一标识此警报面板的ID。如果两个警报面板具有相同的唯一ID,则家庭助理将引起例外。必威是什么

value_template 模板 ((可选的

定义a模板提取值。

例子

在本节中,您可以找到一些如何使用此警报控制面板的真实示例。

具有本地代码验证的配置

下面的示例显示了具有本地代码验证的完整配置。

#示例使用基于文本的代码和本地验证configuration.yamlmqttalarm_control_panel-姓名警报控制板数字键盘”state_topic警报模型/面板”value_template{{value_json.state}}”command_topicalarmdecoder/set set”代码mys3cretc0de

带有远程代码验证的配置

下面的示例显示了具有远程代码验证的完整配置,并且command_template

#示例使用文本代码和远程验证配置.yamlmqttalarm_control_panel-姓名警报控制板文本代码对话”state_topic警报模型/面板”value_template{{{value_json.state}}””command_topicalarmdecoder/set set”代码远程_code_textcommand_template>{“ action”:“ {{action}}”,“代码”:“ {{code}}”}
#使用远程验证configuration.yaml使用数字代码的示例mqttalarm_control_panel-姓名警报控制板数字键盘”state_topic警报模型/面板”value_template{{{value_json.state}}””command_topicalarmdecoder/set set”代码远程_Codecommand_template>{“ action”:“ {{action}}”,“代码”:“ {{code}}”}

当您的MQTT连接未安全时,这将通过网络不受保护发送您的秘密代码!