Home Assistant允许您控制支持MQTT的风扇。
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" - "高速"
command_topic（必
请确保您的主题与配置的精确匹配。"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
