Home Assistant允许您控制支持MQTT的风扇。
在理想情况下,MQTT设备将具有用于发布状态更改的状态主题。如果这些消息以RETAIN标志发布,MQTT风扇将在订阅后立即接收到状态更新,并将以正确的状态启动。否则,风扇的初始状态将为假/关闭。
当状态主题不可用时,风扇将以即时更新模式工作。在这种模式下,风扇将在每次命令后立即更改状态。否则,风扇将等待来自设备的状态确认(来自消息主题)。
即使状态主题可用,也可以强制启用即时更新模式。如果您遇到风扇操作不正确的情况,请尝试启用它。
要在您的安装中启用MQTT风扇,请在您的配置文件(configuration.yaml)中添加以下内容:
# 示例配置.yml 条目
fan:
- platform: mqtt
command_topic: "bedroom_fan/on/set"
配置变量:
- command_topic(必填):用于发布更改风扇状态的命令的MQTT主题。
- name(可选):风扇的名称,默认为“MQTT风扇”。
- state_topic(可选):用于接收状态更新的MQTT主题。
- payload_on(可选):表示运行状态的有效载荷,默认为“ON”。
- payload_off(可选):表示停止状态的有效载荷,默认为“OFF”。
- qos(可选):状态主题的最大QoS级别,默认为0,并将用于发布消息。
- optimistic(可选):定义风扇是否以即时更新模式工作的标志。如果未定义状态主题,则默认为true,否则为false。
- retain(可选):发布的消息是否应具有保留标志。
- oscillation_state_topic(可选):用于接收摆动状态更新的MQTT主题。
- oscillation_command_topic(可选):用于发布更改摆动状态的命令的MQTT主题。
- payload_oscillation_on(可选):表示摆动打开状态的有效载荷,默认为“oscillate_on”。
- payload_oscillation_off(可选):表示摆动关闭状态的有效载荷,默认为“oscillate_off”。
- speed_state_topic(可选):用于接收速度状态更新的MQTT主题。
- speed_command_topic(可选):用于发布更改速度状态的命令的MQTT主题。
- payload_low_speed(可选):表示风扇低速状态的有效载荷。
- payload_medium_speed(可选):表示风扇中速状态的有效载荷。
- payload_high_speed(可选):表示风扇高速状态的有效载荷。
- speeds(可选):速度选项的数组,有效值为“
off
”,“low
”,“medium
”,“high
”
"off" - "关闭"
"low" - "低速"
"medium" - "中速"
"high" - "高速"
请确保您的主题与配置的精确匹配。"some-topic/some-topic"是不同的主题。
在这里,您可以找到有关如何使用MQTT风扇的一些实际示例。以下是一个完整的MQTT风扇的配置示例:
# 示例配置.yml 条目
# 定义一个MQTT风扇,用于卧室
fan:
- platform: mqtt # 使用MQTT
name: "卧室风扇" # 风扇的名称
state_topic: "bedroom_fan/on/state" # 用于接收风扇状态的MQTT主题
command_topic: "bedroom_fan/on/set" # 用于发布控制风扇状态的MQTT主题
oscillation_state_topic: "bedroom_fan/oscillation/state" # 用于接收摆动状态的MQTT主题
oscillation_command_topic: "bedroom_fan/oscillation/set" # 用于发布控制摆动状态的MQTT主题
speed_state_topic: "bedroom_fan/speed/state" # 用于接收风扇速度状态的MQTT主题
speed_command_topic: "bedroom_fan/speed/set" # 用于发布控制风扇速度的MQTT主题
qos: 0 # 状态主题的最大QoS级别
payload_on: "true" # 表示风扇运行状态的有效载荷
payload_off: "false" # 表示风扇停止状态的有效载荷
payload_oscillation_on: "true" # 表示摆动打开状态的有效载荷
payload_oscillation_off: "false" # 表示摆动关闭状态的有效载荷
payload_low_speed: "low" # 表示风扇低速状态的有效载荷
payload_medium_speed: "medium" # 表示风扇中速状态的有效载荷
payload_high_speed: "high" # 表示风扇高速状态的有效载荷
speeds: # 风扇可用的速度选项
- low
- medium
- high