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_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主题订阅以接收可用性(在线/离线)更新。不得一起使用可用性

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.51.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