必威是什么必威是什么

MQTT热水器

这mqtt热水器平台可让您控制启用的MQTT热水器设备。

配置

要在安装中启用此热水器平台，请首先将以下内容添加到您的configuration.yaml文件：

＃示例Configuration.yaml条目mqtt：热水器：-姓名：锅炉mode_command_topic：“地下室/锅炉/模式/设置”

配置变量

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

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主题订阅以接收可用性（在线/离线）更新。不得一起使用可用性。
current_temperature_template 模板 （（选修的）

收到的值收到的模板current_temperature_topic将被渲染。
current_temperature_topic 细绳 （（选修的）

聆听当前温度的MQTT主题。A“没有任何”接收的值将重置当前温度。空值（'''）将被忽略。
设备 地图 （（选修的）

有关设备的信息，此热水器设备是将其绑在设备注册表。只能通过MQTT发现什么时候唯一身份设置。必须至少存在一个标识符或连接以识别设备。
configuration_url 细绳 （（选修的）

可以管理此设备配置的网页的链接。可以是HTTP或HTTPS链接。
连接 列表 （（选修的）

设备与外界的连接列表，作为一个元组列表[Connection_Type，Connection_Identifier]。例如，网络接口的MAC地址：“连接”：[[“ Mac”，“ 02：5b：26：A8：DC：12”]]。
hw_version 细绳 （（选修的）

设备的硬件版本。
身份标识 列表|细绳 （（选修的）

唯一标识设备的ID列表。例如序列号。
制造商 细绳 （（选修的）

设备的制造商。
模型 细绳 （（选修的）

设备的模型。
姓名 细绳 （（选修的）

设备的名称。
建议_area 细绳 （（选修的）

如果该设备还没有，则建议一个区域。
sw_version 细绳 （（选修的）

设备的固件版本。
via_device 细绳 （（选修的）

设备和家庭助手之间将消息路由的设备的标识符。必威是什么此类设备的示例是枢纽或子设备的父设备。这用于在家庭助理中显示设备拓扑。必威是什么
enabled_by_default 布尔 （（选修的，默认：正确）

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

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

这类别实体。
最初的 整数 （（选修的）

设置初始目标温度。默认值取决于温度单位，为43.3°C或110°F。
图标 图标 （（选修的）

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

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

MQTT主题订阅以接收JSON字典有效载荷，然后将其设置为传感器属性。使用示例可以在MQTT传感器文档。
max_temp 漂浮 （（选修的）

可用的最大设定点。默认值取决于温度单位，为60°C或140°F。
min_temp 漂浮 （（选修的）

可用的最小设定点。默认值取决于温度单位，为43.3°C或110°F。
mode_command_template 模板 （（选修的）

一个模板，以渲染发送给的值mode_command_topic和。
mode_command_topic 细绳 （（选修的）

发布命令的MQTT主题更改热水器操作模式。与mode_command_template如果您只想发布电源状态。
mode_state_template 模板 （（选修的）

一个模板来渲染在mode_state_topic和。
mode_state_topic 细绳 （（选修的）

MQTT主题要订阅热水器操作模式的更改。如果未设置此操作，则操作模式在乐观的模式下工作（请参见下文）。
模式 列表 （（选修的）

支持模式的列表。需要是默认值的子集。
默认：

[“ OFF”，“ ECO”，“ Electric”，“ Gas”，“ Heat_pump”，“ High_demand”，“ performance'']

姓名 细绳 （（选修的，默认：MQTT热水器）

热水器的名称。
object_id 细绳 （（选修的）

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

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

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

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

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

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

代表残疾状态的有效载荷。
payload_on 细绳 （（选修的，默认：ON）

代表启用状态的有效载荷。
精确 漂浮 （（选修的）

该设备的所需精度。可用于匹配实际的热水器的精度。支持的值是0.1，，，，0.5和1.0。
默认：

摄氏0.1，华氏度为1.0。

QoS 整数 （（选修的，默认：0）

接收和发布消息时要使用的最大QoS级别。
保持 布尔 （（选修的，默认：false）

定义是否已发布消息应具有固定标志集。
温度_command_template 模板 （（选修的）

一个模板，以渲染发送给的值温度_command_topic和。
温度_command_topic 细绳 （（选修的）

发表命令的MQTT主题以更改目标温度。
温度_STATE_TEMPLATE 模板 （（选修的）

一个模板来渲染在温度_STATE_TOPIC和。
温度_STATE_TOPIC 细绳 （（选修的）

MQTT主题要订阅目标温度的变化。如果未设置此目标，则目标温度在乐观的模式下起作用（请参见下文）。A“没有任何”接收到的值将重置温度设定点。空值（'''）将被忽略。
温度_unit 细绳 （（选修的）

定义设备的温度单位，C或者F。如果未设置此设置，则温度单位设置为系统温度单位。
唯一身份 细绳 （（选修的）

一个独特地标识此热水器设备的ID。如果两个热水器设备具有相同的独特ID，则家庭助理将引起例外。必威是什么
value_template 模板 （（选修的）

默认模板以渲染有效载荷全部*_STATE_TOPIC与。

乐观的模式

如果财产在乐观的模式（当未设置相应的状态主题时），家庭助理将假定发布给命令主题的任何状态更改都可以正常工作，并在发布到必威是什么命令主题后立即更改实体的内部状态。如果它在乐观模式下不起作用，则仅在设备通过状态主题确认所请求的更新时，才会更新实体的内部状态。您可以通过设置乐观的选项真的。设置时，即使定义了状态主题，内部状态也将始终更新。

使用模板

对全部*_STATE_TOPICS，可以指定一个模板，该模板将用于在这些主题上渲染传入的有效载荷。另外，适用于所有状态主题的默认模板可以指定为value_template。如果您收到有效载荷，例如JSON格式，这将很有用。由于在JSON中，引用的字符串（例如，“ foo”）只是一个字符串，它也可以用于毫不夸张。

说您收到操作模式“离开”通过你的mode_state_topic，但是该模式实际上被称为离开，这就是您可以做的：

mqtt：热水器：-姓名：锅炉模式：-“离开”-“生态”-“表现”mode_command_topic：“地下室/锅炉/模式/设置”mode_state_topic：“地下室/锅炉/模式/状态”mode_state_template：“{{value_json}}””

这将解析进来“离开”作为JSON，导致离开。显然，在这种情况下，您也可以设置value_template：“ {{value_json}}”。

类似地*_command_topicS，可以指定模板以在这些主题上渲染发出的有效载荷。

例子

完整的配置示例看起来像下面的示例。

＃完整示例configuration.yaml条目mqtt：热水器：-姓名：锅炉模式：-“离开”-“生态”-“表现”mode_state_topic：“地下室/锅炉/模式”mode_command_topic：“地下室/锅炉/模式/设置”mode_command_template：“{{价值如果value ==“ off” else“ on”}}“”温度_STATE_TOPIC：“地下室/锅炉/温度”温度_command_topic：“地下室/锅炉/温度/设置”current_temperature_topic：“地下室/锅炉/电流精确：1.0