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" - "高速"

请确保您的主题与配置的精确匹配。"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

打赏赞