这mqtt
气候平台使您可以控制启用的MQTT HVAC设备。
配置
要在安装中启用此气候平台,请首先将以下内容添加到您的configuration.yaml
文件:
#示例Configuration.yaml条目气候:-平台:mqtt
配置变量
Action_Template
模板
((选修的)
MQTT主题要订阅当前动作的更改。如果设置了此设置,则气候图将接收到的值用作数据源。有效值:离开
,,,,加热
,,,,冷却
,,,,烘干
,,,,闲
,,,,扇子
。
aux_command_topic
细绳
((选修的)
AUX_STATE_TEMPLATE
模板
((选修的)
一个模板来渲染在AUX_STATE_TOPIC
和。
AUX_STATE_TOPIC
细绳
((选修的)
MQTT主题要订阅辅助热模式的更改。如果未设置此设置,则辅助加热模式在乐观的模式下起作用(见下文)。
MQTT主题列表订阅以接收可用性(在线/离线)更新。不得一起使用availability_topic
。
payload_available
细绳
((选修的,默认:在线)
payload_not_available
细绳
((选修的,默认:离线)
定义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
细绳
((选修的)
configuration_url
细绳
((选修的)
可以管理此设备配置的网页的链接。可以是HTTP或HTTPS链接。
该设备与外界的连接列表作为元组列表[Connection_Type,Connection_Identifier]
。例如,网络接口的MAC地址:“连接”:[[“ Mac”,“ 02:5b:26:A8:DC:12”]]
。
该设备与家庭助理之间路由消息的设备的标识符。必威是什么此类设备的示例是枢纽或子设备的父设备。这用于在家庭助理中显示设备拓扑。必威是什么
enabled_by_default
布尔
((选修的,默认:正确)
收到和已发布消息的有效载荷的编码。调成“”
禁用传入有效载荷的解码。
Entity_Category
细绳
((选修的,默认:无)
fan_mode_command_template
模板
((选修的)
一个模板,以渲染发送给的值fan_mode_command_topic
和。
fan_mode_command_topic
细绳
((选修的)
fan_mode_state_template
模板
((选修的)
一个模板来渲染在fan_mode_state_topic
和。
fan_mode_state_topic
细绳
((选修的)
MQTT主题要订阅HVAC风扇模式的更改。如果未设置此设置,则风扇模式在乐观的模式下工作(请参见下文)。
JSON_ATTRIBUTES_TEMPLATE
模板
((选修的)
定义a模板从收到的消息中提取JSON字典JSON_ATTRIBUTES_TOPIC
。使用示例可以在MQTT传感器文档。
JSON_ATTRIBUTES_TOPIC
细绳
((选修的)
MQTT主题订阅以接收JSON字典有效载荷,然后将其设置为传感器属性。使用示例可以在MQTT传感器文档。
mode_command_template
模板
((选修的)
一个模板,以渲染发送给的值mode_command_topic
和。
mode_command_topic
细绳
((选修的)
mode_state_template
模板
((选修的)
一个模板来渲染在mode_state_topic
和。
mode_state_topic
细绳
((选修的)
MQTT主题要订阅HVAC操作模式的更改。如果未设置此操作,则操作模式在乐观的模式下工作(请参见下文)。
支持模式的列表。需要是默认值的子集。
默认:
[“自动”,“关闭”,“酷”,“热”,“干”,“ fan_only”]
名称
细绳
((选修的,默认:MQTT HVAC)
payload_available
细绳
((选修的,默认:在线)
payload_not_available
细绳
((选修的,默认:离线)
payload_off
细绳
((选修的,默认:关闭)
payload_on
细绳
((选修的,默认:ON)
power_command_topic
细绳
((选修的)
MQTT主题发布命令以更改功率状态。如果您的设备除了模式外具有单独的电源切换,这很有用。
该设备的所需精度。可用于匹配实际恒温器的精度。支持的值是0.1
,,,,0.5
和1.0
。
preset_mode_command_template
模板
((选修的)
定义a模板生成有效载荷以发送到PRESET_MODE_COMMAND_TOPIC
。
PRESET_MODE_COMMAND_TOPIC
细绳
((选修的)
PRESET_MODE_STATE_TOPIC
细绳
((选修的)
MQTT主题订阅以基于预设的气候速度。当预设“无”收到或没有任何
这PRESET_MODE
将重置。
PRESET_MODE_VALUE_TEMPLATE
细绳
((选修的)
定义a模板提取PRESET_MODE
从接收到的有效载荷的价值PRESET_MODE_STATE_TOPIC
。
PRESET_MODES
列表
((选修的, 默认: [])
这种气候支持的预设模式列表。常见的例子包括生态
,,,,离开
,,,,促进
,,,,舒适
,,,,家
,,,,睡觉
和活动
。
swing_mode_command_template
模板
((选修的)
一个模板,以渲染发送给的值swing_mode_command_topic
和。
swing_mode_command_topic
细绳
((选修的)
swing_mode_state_template
模板
((选修的)
一个模板来渲染在swing_mode_state_topic
和。
swing_mode_state_topic
细绳
((选修的)
MQTT主题要订阅HVAC摆动模式的更改。如果未设置此设置,则摆动模式在乐观的模式下工作(请参见下文)。
swing_modes
列表
((选修的,默认:[“ on”,“ off”])
温度_command_template
模板
((选修的)
一个模板,以渲染发送给的值温度_command_topic
和。
温度_command_topic
细绳
((选修的)
温度_high_command_template
模板
((选修的)
一个模板,以渲染发送给的值温度_high_command_topic
和。
温度_high_command_topic
细绳
((选修的)
温度_high_state_template
模板
((选修的)
一个模板来渲染在温度_high_state_topic
和。
温度_high_state_topic
细绳
((选修的)
MQTT主题要订阅目标高温的变化。如果未设置此设置,则目标高温在乐观的模式下起作用(请参见下文)。
温度_low_command_template
模板
((选修的)
一个模板,以渲染发送给的值温度_low_command_topic
和。
温度_low_command_topic
细绳
((选修的)
温度_low_state_template
模板
((选修的)
一个模板来渲染在温度_low_state_topic
和。
温度_low_state_topic
细绳
((选修的)
MQTT主题要订阅目标低温的变化。如果未设置此目标,则目标低温在乐观的模式下起作用(请参见下文)。
温度_STATE_TEMPLATE
模板
((选修的)
MQTT主题要订阅目标温度的变化。如果未设置此目标,则目标温度在乐观的模式下起作用(请参见下文)。
定义设备的温度单位,C
或者F
。如果未设置此设置,则温度单位设置为系统温度单位。
唯一标识此HVAC设备的ID。如果两个HVAC设备具有相同的独特ID,则家庭助理将引起例外。必威是什么
默认模板以渲染有效载荷全部*_STATE_TOPIC
与。
乐观的模式
如果财产在乐观的模式(当未设置相应的状态主题时),家庭助理将假设发布给命令主题的任何状态更改确实有效,并在发布到命令主必威是什么题后立即更改实体的内部状态。如果它在乐观模式下不起作用,则仅在设备通过状态主题确认请求的更新时,才会更新实体的内部状态。
使用模板
对所有人*_STATE_TOPIC
S,可以指定一个模板,该模板将用于在这些主题上渲染传入的有效载荷。另外,适用于所有状态主题的默认模板可以指定为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_topic
S,可以指定模板以在这些主题上渲染传出有效载荷。
例子
完整的配置示例看起来像下面的一个。
#完整示例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