MQTT二进制传感器


这个mqtt二进制传感器平台使用接收到的MQTT消息将二进制传感器的状态设置为在…上.

只有在上发布新邮件后,才会更新状态国家主题匹配有效载荷有效载荷。如果这些消息与保持设置标志后,二进制传感器将在订阅后接收即时状态更新,家庭助手将在启动时显示正确的状态。否则,家庭助手中显示的初始状态将为必威是什么未知的.

按钮、遥控器等无状态设备最好用MQTT设备触发器而不是通过二进制传感器。

配置

这个mqtt二进制传感器平台可选地支持可利用性从MQTT设备接收在线和离线消息(出生和LWT消息)的主题。在正常操作期间,如果MQTT传感器设备脱机(即发布有效载荷不可用可利用性主题),家庭助手必威是什么将显示二进制传感器不可用的。如果这些消息与保持设置标志后,二进制传感器将在订阅后接收即时更新,并且当Home Assistant启动时,Home Assistant将显示二进制传感器的正确可用状态。如果必威是什么保持未设置标志,家庭助理将显示二进制传必威是什么感器为不可用的当家庭助理必威是什么启动时。如果否可利用性主题定义,家庭助理将考虑MQTT设备必威是什么可获得的并将显示其状态。

要在安装中使用MQTT二进制传感器,请将以下内容添加到配置.yaml文件:

#示例configuration.yaml条目二进制传感器:-平台:mqtt状态主题:“家庭助理/窗口/联系人”

配置变量

可利用性 列表 (可选择的)

订阅以接收可用性(联机/脱机)更新的MQTT主题列表。不得与一起使用可用性主题.

有效载荷u可用 一串 (可选择的,默认值:在线)

表示可用状态的有效负载。

有效载荷不可用 一串 (可选择的,默认值:脱机)

表示不可用状态的有效负载。

话题 一串 要求的

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

可用性模式 一串 (可选择的,默认值:最新版本)

什么时候可利用性如果已配置,则控制将实体设置为所需的条件可获得的。有效的参赛作品包括全部的,任何最近的。如果设置为全部的,有效载荷u可用在实体标记为联机之前,必须在所有配置的可用性主题上接收。如果设置为任何,有效载荷u可用在实体标记为联机之前,必须至少收到一个配置的可用性主题。如果设置为最近的,最后一个有效载荷u可用有效载荷不可用在任何配置的可用性主题上接收控制可用性。

可用性主题 一串 (可选择的)

MQTT主题订阅从MQTT设备接收出生和LWT消息。如果可利用性如果未定义,将始终考虑二进制传感器可获得的它的状态将是在…上,未知的如果可利用性定义后,二进制传感器将被视为不可用的默认情况下,传感器的初始状态为不可用的。不得与一起使用可利用性.

装置 地图 (可选择的)

有关该二进制传感器所属设备的信息,以便将其连接到设备注册表. 只能通过MQTT发现什么时候唯一标识一切就绪。必须至少存在一个标识符或连接来标识设备。

配置url 一串 (可选择的)

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

连接 列表|地图 (可选择的)

作为元组列表的设备与外部世界的连接列表[连接类型,连接标识符]. 例如,网络接口的MAC地址:“连接”:[mac',02:5b:26:a8:dc:12'].

标识符 列表|字符串 (可选择的)

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

制造商 一串 (可选择的)

该设备的制造商。

模型 一串 (可选择的)

设备的型号。

名称 一串 (可选择的)

设备的名称。

建议面积 一串 (可选择的)

如果设备还不在一个区域内,建议一个区域。

sw_版本 一串 (可选择的)

设备的固件版本。

通过U设备 一串 (可选择的)

在该设备和Home Assistant之间路由消息的设备的标识符。此类设备的示例包括集线器或子设备的父设备。这用于在Home Assis必威是什么tant中显示设备拓扑。

设备类 一串 (可选择的)

设定设备的类别,更改显示在前端的设备状态和图标。

默认情况下已启用 布尔值 (可选择的,默认值:true)

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

实体类别 一串 (可选择的,默认值:无)

这个类别实体的名称。

过期 整数 (可选择的)

定义传感器状态过期(如果未更新)后的秒数。过期后,传感器状态变为不可用的.

警队更新 布尔值 (可选择的,默认值:false)

发送更新事件(导致状态对象最后的改变)即使传感器的状态没有改变。如果您希望在历史记录中有有意义的值图,或者希望创建一个在每一个传入状态信息(不仅当传感器的新状态与当前状态不同时)。

偶像 偶像 (可选择的)

偶像对于实体。

json_属性_模板 样板 (可选择的)

定义一个样板从上接收的消息中提取JSON字典json_属性_主题。使用示例可在中找到MQTT传感器文档

json_属性_主题 一串 (可选择的)

MQTT主题订阅接收JSON字典负载,然后设置为传感器属性MQTT传感器文档

名称 一串 (可选择的,默认值:MQTT二进制传感器)

二进制传感器的名称。

关闭延迟 整数 (可选择的)

对于仅发送在…上状态更新(如PIR),此变量设置延迟(以秒为单位),之后传感器的状态将更新回.

有效载荷u可用 一串 (可选择的,默认值:在线)

表示在线 的状态

有效载荷不可用 一串 (可选择的,默认值:脱机)

表示离线状态

有效载荷 一串 (可选择的,默认值:关闭)

表示状态它将与中的消息进行比较国家主题(见价值模板(详情请参阅)

有效载荷 一串 (可选择的,默认值:ON)

表示在…上状态它将与中的消息进行比较国家主题(见价值模板(详情请参阅)

服务质量 整数 (可选择的,默认值:0)

接收消息时要使用的最大QoS级别。

国家主题 一串 要求的

MQTT主题订阅接收传感器的状态。

唯一标识 一串 (可选择的)

唯一标识此传感器的ID。如果两个传感器具有相同的唯一ID,家庭助理将引发异常。必威是什么

价值模板 一串 (可选择的)

定义一个样板返回要与之进行比较的字符串有效载荷/有效载荷或空字符串,在这种情况下,MQTT消息将被删除。可用变量:实体id。当“有效负载打开”和“有效负载关闭”足以匹配您的有效负载时(即不需要对原始消息进行预处理),请删除此选项。

例子

在本节中,您将找到一些如何使用此传感器的实际示例。

使用JSON数据的完整配置

这是从JSON格式的MQTT消息中提取状态的配置示例。要进行测试,可以使用命令行工具莫斯奎托酒店装运莫斯基托或者莫斯奎托客户用于发送MQTT消息的包。

要手动设置二进制传感器的状态,请执行以下操作:

mosquitto_酒吧-H127.0.0.1-t家庭助理/窗口/可用性-m“在线”mosquitto_酒吧-H127.0.0.1-t家庭助理/窗口/联系人-m'{“状态”:“开”}mosquitto_酒吧-H127.0.0.1-t家庭助理/窗口/联系人-m'{“状态”:“关”}

以下示例显示了二进制传感器的完整配置:

#示例configuration.yaml条目二进制传感器:-平台:mqtt名称:“窗口联系人传感器”状态主题:“家庭助理/窗口/联系人”有效负载打开:“打开”可用性:-主题:“家庭助理/窗口/可用性”有效负载可用性:“联机”有效负载不可用:“脱机”qos:0设备类:打开值模板:{{value\u json.state}”

每次收到关于状态主题的消息时切换二进制传感器

#示例configuration.yaml条目二进制\u传感器:-平台:mqtt状态\u主题:“lab\u按钮/cmnd/POWER”值\u模板:“{%if是\u状态(实体\u id,\'on\”)-%}关{%-else-%}开{%-endif%}”

使用ESPEasy获取设备的状态

假设您已使用埃斯皮斯. “配置”下是为您的设备设置的名称(“单元名称:”)(这里是“浴室”)。存在协议为“OpenHAB MQTT”的MQTT的“控制器”配置,并调整条目(“控制器订阅:”和“控制器发布:”)以满足您的需要。在本例中,主题的前缀为“home”。此外,在“设备”点击中添加一个“开关输入”,并将名称“开关”和“按钮”作为值。

一旦装置联机,您将获得连接按钮的状态。

家庭/浴室/状态已连接…家庭/浴室/开关/按钮1

配置将如下面的示例所示:

#示例configuration.yaml条目二进制传感器:-平台:mqtt名称:浴室状态主题:“主/浴室/开关/按钮”有效负载打开:“1”有效负载关闭:“0”
Baidu