必威是什么必威是什么

MQTT加湿器

这mqtt加湿器平台使您可以控制启用MQTT的加湿器。

配置

在理想的情况下，MQTT设备将具有state_topic发布状态更改。如果这些消息是用保持标志，MQTT加湿器将在订阅后获得即时状态更新，并从正确的状态开始。否则，加湿器的初始状态将是未知。MQTT设备可以将当前状态重置为未知用一个没有任何有效载荷。

当一个state_topic不可用，加湿器将以乐观的方式工作。在此模式下，加湿器将在每个命令后立即更改状态。否则，加湿器将等待设备的状态确认（来自state_topic）。初始状态设置为错误的/离开在乐观的模式下。

即使一个state_topic可用。如果您经历了不正确的加湿器操作，请尝试启用它。

要在安装中启用MQTT加湿器，请在您的安装中添加以下内容configuration.yaml文件：

＃示例Configuration.yaml条目mqtt：加湿器：-command_topic：“卧室_HUMIDIFIER/ON/SET”target_humity_command_topic：“卧室_HUMIDIFIER/湿度/集合”

以前的配置格式

配置变量

寻找您的配置文件？
可用性 列表 （（可选的）

MQTT主题列表订阅以接收可用性（在线/离线）更新。不得一起使用availability_topic。
payload_available 细绳 （（可选的，默认：在线）

代表可用状态的有效载荷。
payload_not_available 细绳 （（可选的，默认：离线）

代表不可用状态的有效载荷。
话题 细绳 必需的

MQTT主题订阅以接收可用性（在线/离线）更新。
value_template 模板 （（可选的）

定义a模板从中提取设备的可用性话题。为了确定设备的可用性结果，将与payload_available和payload_not_available。
availability_mode 细绳 （（可选的，默认：最新）

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

定义a模板从中提取设备的可用性availability_topic。为了确定设备的可用性结果，将与payload_available和payload_not_available。
availability_topic 细绳 （（可选的）

MQTT主题订阅以接收可用性（在线/离线）更新。不得一起使用可用性。
command_template 模板 （（可选的）

定义a模板生成有效载荷以发送到command_topic。
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 细绳 （（可选的）

该设备与家庭助理之间路由消息的设备的标识符。必威是什么此类设备的示例是枢纽或子设备的父设备。这用于在家庭助理中显示设备拓扑。必威是什么
device_class 细绳 （（可选的，默认：加湿器）

MQTT设备的设备类。必须是加湿器或者除湿机。
enabled_by_default 布尔 （（可选的，默认：正确）

标志，该标志首先添加时定义是否应启用实体。
编码 细绳 （（可选的，默认：UTF-8）

收到和已发布消息的有效载荷的编码。调成“”禁用传入有效载荷的解码。
Entity_Category 细绳 （（可选的，默认：无）

这类别实体。
图标 图标 （（可选的）

图标对于实体。
JSON_ATTRIBUTES_TEMPLATE 模板 （（可选的）

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

MQTT主题订阅以接收JSON字典有效载荷，然后将其设置为传感器属性。使用示例可以在MQTT传感器文档。
max_humity 整数 （（可选的，默认：100）

可以设置的最小目标湿度百分比。
min_humity 整数 （（可选的，默认：0）

可以设置的最大目标湿度百分比。
姓名 细绳 （（可选的，默认：MQTT加湿器）

加湿器的名称。
object_id 细绳 （（可选的）

代替姓名用于自动生成ENTITY_ID
乐观的 布尔 （（可选的）

定义加湿器是否在乐观模式下工作的标志
默认：

真的如果没有定义状态主题，否则错误的。

payload_available 细绳 （（可选的，默认：在线）

代表可用状态的有效载荷。
payload_not_available 细绳 （（可选的，默认：离线）

代表不可用状态的有效载荷。
payload_off 细绳 （（可选的，默认：关闭）

代表停止状态的有效载荷。
payload_on 细绳 （（可选的，默认：ON）

代表运行状态的有效载荷。
payload_reset_humity 细绳 （（可选的，默认：无）

一个特殊的有效载荷重置target_humity状态属性为没有任何当收到target_humity_state_topic。
payload_reset_mode 细绳 （（可选的，默认：无）

一个特殊的有效载荷重置模式状态属性为没有任何当收到mode_state_topic。
target_humity_command_template 模板 （（可选的）

定义a模板生成有效载荷以发送到target_humity_command_topic。
target_humity_command_topic 细绳 必需的

MQTT主题发布命令以根据百分比更改加湿器目标湿度状态。
target_humity_state_topic 细绳 （（可选的）

MQTT主题订阅以接收加湿器目标湿度。
target_humity_state_template 细绳 （（可选的）

定义a模板提取加湿器的值target_humity状态。
mode_command_template 模板 （（可选的）

定义a模板生成有效载荷以发送到mode_command_topic。
mode_command_topic 细绳 （（可选的）

MQTT主题发布命令以更改模式在加湿器上。此属性UST与模式属性。
mode_state_topic 细绳 （（可选的）

MQTT主题订阅以接收加湿器模式。
mode_state_template 细绳 （（可选的）

定义a模板提取加湿器的值模式状态。
模式 列表 （（可选的， 默认： []）

可用模式的列表此加湿器能够运行。常见的例子包括普通的，，，，生态，，，，离开，，，，促进，，，，舒适，，，，家，，，，睡觉，，，，汽车和婴儿。这些示例提供了内置的翻译，但也允许其他自定义模式。此属性UST与mode_command_topic属性。
QoS 整数 （（可选的，默认：0）

国家主题的最大QoS级别。
保持 布尔 （（可选的，默认：正确）

是否已发表的消息应在是否有保留标志。
state_topic 细绳 （（可选的）

MQTT主题订阅以接收状态更新。
state_value_template 细绳 （（可选的）

定义a模板从国家提取值。
唯一身份 细绳 （（可选的）

一个独特地标识此加湿器的ID。如果两个加湿器具有相同的独特身份证，则家庭助理将引起例外。必威是什么

确保您的主题完全匹配。一些主题/和一些主题是不同的主题。

例子

在本节中，您可以找到一些现实生活中的示例，说明如何使用此加湿器。

完整配置

下面的示例显示了包括模式的MQTT加湿器的完整配置。

＃示例configuration.yamlmqtt：加湿器：-姓名：“卧室加湿器”device_class：“加湿器”state_topic：“卧室_HUMIDIFIER/ON/State”command_topic：“卧室_HUMIDIFIER/ON/SET”target_humity_command_topic：“卧室_HUMIDIFIER/湿度/集合”target_humity_state_topic：“卧室_HUMIDIFIER/湿度/状态”mode_state_topic：“卧室_HUMIDIFIER/模式/状态”mode_command_topic：“卧室_HUMIDIFIER/PRESET/PRESET_MODE”模式：-“普通的”-“生态”-“离开”-“促进”-“舒适”-“家”-“睡觉”-“汽车”-“婴儿”QoS：0payload_on：“真的”payload_off：“错误的”min_humity：30max_humity：80