必威是什么必威是什么

MQTT HVAC

这mqtt气候平台使您可以控制启用的MQTT HVAC设备。

配置

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

＃示例Configuration.yaml条目气候：-平台：mqtt

配置变量

寻找您的配置文件？
Action_Template 模板 （（选修的）

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

MQTT主题要订阅当前动作的更改。如果设置了此设置，则气候图将接收到的值用作数据源。有效值：离开，，，，加热，，，，冷却，，，，烘干，，，，闲，，，，扇子。
aux_command_topic 细绳 （（选修的）

MQTT主题发布命令以切换辅助加热。
AUX_STATE_TEMPLATE 模板 （（选修的）

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

MQTT主题要订阅辅助热模式的更改。如果未设置此设置，则辅助加热模式在乐观的模式下起作用（见下文）。
可用性 列表 （（选修的）

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主题。
设备 地图 （（选修的）

有关该设备的信息此HVAC设备是将其绑定到的一部分设备注册表。只能通过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 细绳 （（选修的，默认：无）

这类别实体。
fan_mode_command_template 模板 （（选修的）

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

MQTT主题发布命令以更改风扇模式。
fan_mode_state_template 模板 （（选修的）

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

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

支持的风扇模式列表。
默认：

[“自动”，“低”，“中”，“高”]

最初的 整数 （（选修的，默认：21）

设置初始目标温度。
图标 图标 （（选修的）

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

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

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

可用的最大设定点。
min_temp 漂浮 （（选修的）

可用的最小设定点。
mode_command_template 模板 （（选修的）

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

MQTT主题发布命令以更改HVAC操作模式。
mode_state_template 模板 （（选修的）

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

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

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

[“自动”，“关闭”，“酷”，“热”，“干”，“ fan_only”]

名称 细绳 （（选修的，默认：MQTT HVAC）

HVAC的名称。
object_id 细绳 （（选修的）

代替名称用于自动生成ENTITY_ID
payload_available 细绳 （（选修的，默认：在线）

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

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

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

表示启用状态的有效载荷。
power_command_topic 细绳 （（选修的）

MQTT主题发布命令以更改功率状态。如果您的设备除了模式外具有单独的电源切换，这很有用。
精确 漂浮 （（选修的）

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

摄氏度为0.1，华氏度为1.0。

preset_mode_command_template 模板 （（选修的）

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

MQTT主题发布命令以更改预设模式。
PRESET_MODE_STATE_TOPIC 细绳 （（选修的）

MQTT主题订阅以基于预设的气候速度。当预设“无”收到或没有任何这PRESET_MODE将重置。
PRESET_MODE_VALUE_TEMPLATE 细绳 （（选修的）

定义a模板提取PRESET_MODE从接收到的有效载荷的价值PRESET_MODE_STATE_TOPIC。
PRESET_MODES 列表 （（选修的， 默认： []）

这种气候支持的预设模式列表。常见的例子包括生态，，，，离开，，，，促进，，，，舒适，，，，家，，，，睡觉和活动。
QoS 整数 （（选修的，默认：0）

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

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

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

MQTT主题发布命令以更改摆动模式。
swing_mode_state_template 模板 （（选修的）

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

MQTT主题要订阅HVAC摆动模式的更改。如果未设置此设置，则摆动模式在乐观的模式下工作（请参见下文）。
swing_modes 列表 （（选修的，默认：[“ on”，“ off”]）

支持的秋千模式列表。
温度_command_template 模板 （（选修的）

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

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

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

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

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

MQTT主题要订阅目标高温的变化。如果未设置此设置，则目标高温在乐观的模式下起作用（请参见下文）。
温度_low_command_template 模板 （（选修的）

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

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

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

MQTT主题要订阅目标低温的变化。如果未设置此目标，则目标低温在乐观的模式下起作用（请参见下文）。
温度_STATE_TEMPLATE 模板 （（选修的）

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

MQTT主题要订阅目标温度的变化。如果未设置此目标，则目标温度在乐观的模式下起作用（请参见下文）。
温度_unit 细绳 （（选修的）

定义设备的温度单位，C或者F。如果未设置此设置，则温度单位设置为系统温度单位。
temp_step 漂浮 （（选修的，默认：1）

温度设定点的步长。
唯一身份 细绳 （（选修的）

唯一标识此HVAC设备的ID。如果两个HVAC设备具有相同的独特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名称：学习模式：-“离开”-“凉爽的”-“仅限粉丝”swing_modes：-“在”-“离开”fan_modes：-“高的”-“中等的”-“低的”PRESET_MODES：-“生态”-“睡觉”-“活动”power_command_topic：“研究/交流/力量/集合”PRESET_MODE_COMMAND_TOPIC：“研究/ac/preset_mode/set”mode_command_topic：“研究/交流/模式/集合”温度_command_topic：“研究/交流/温度/集合”fan_mode_command_topic：“研究/交流/风扇/集swing_mode_command_topic：“研究/交流/秋千/集精确：1.0