MQTT中文站
  • 首页
  • MQTT 学习
    • MQTT 入门
    • MQTT 进阶
    • MQTT 编程
    • MQTT 实例
    • MQTT 要点
    • MQTT5 要点
    • MQTT 工具
    • MQTT 客户端库
    • MQTT 服务器
    • Zigbee2MQTT
    • Sparkplug
    • Home Assistant
    • Node-RED
      • Node-RED 安装部署
      • Node-RED 用户指南
      • Node-RED 创建节点
      • Node-RED 示例教程
      • Node-RED 开发流程
      • Node-RED 接口参考
      • Node-RED 配置模板
      • Node-RED 常见问题
  • MQTT 规范
    • MQTT 5 规范
    • MQTT 3.1.1 规范
    • MQTT 3.1 规范
    • MQTT-SN v1.2规范
    • Sparkplug® v3.0.0规范
  • 产品中心
  • 解决方案
    • 环境监测
    • 工业制造
    • 智慧水利
    • 水利管网
    • 积水监测
    • 综合管廊
    • 档案库房
    • 交通物流
    • 智慧城市
    • 智慧农业
    • 智慧养殖
    • 能源电力
    • 石油石化
    • 智能家居
    • 物联网
    • 汽车与出行
  • 使用文档
  • MQTT 云平台
  • 登录
  • 注册

Home Assistant中使用MQTT窗帘/卷帘的示例配置

2 年前 • Home Assistant

Home Assistant允许您控制 MQTT 窗帘/卷帘(如百叶窗、卷帘或车库门)。

在理想情况下,MQTT 设备将有一个状态主题,用于发布状态更改。如果这些消息以设置标志进行发布,遮盖将在订阅后立即接收到状态更新,并且在 Home Assistant 启动时会显示正确的状态。否则,在 Home Assistant 中显示的初始状态将是未知(unknown)。

窗帘/卷帘的相对位置存储在一个属性中,其中 0 表示设备关闭,所有其他中间位置表示设备处于打开状态。

如果没有定义状态主题,遮阳将在即时更新模式下工作。在此模式下,窗帘/卷帘将在 Home Assistant 发送的每个命令后立即更改状态(打开或关闭)。如果定义了状态主题,窗帘/卷帘将等待匹配或者之前的消息,然后在 Home Assistant 中更改状态。

即使定义了状态主题,也可以强制使用即时更新模式。如果您遇到窗帘/卷帘操作不正确的情况,请尝试启用它。

还可选择支持 MQTT 窗帘/卷帘设备的在线和离线消息(birth 和 LWT 消息)。在正常操作期间,如果 MQTT 窗帘/卷帘设备脱机(即发布到某个主题),Home Assistant 将显示窗帘/卷帘为“不可用”。如果使用设置标志发布这些消息,窗帘/卷帘将在订阅后立即更新,并且 Home Assistant 启动时将显示窗帘/卷帘的正确可用性状态。如果不设置标志,Home Assistant 启动时将显示窗帘/卷帘为“不可用”。

要在您的安装中使用 MQTT 窗帘/卷帘,请将以下内容添加到您的 configuration.yaml 文件中:

# 示例 configuration.yaml 条目
cover:
  - platform: mqtt
    name: "MQTT 窗帘"
    command_topic: "home-assistant/cover/set"

配置变量:

  • name(可选):窗帘的名称。默认为 "MQTT 窗帘"。
  • command_topic(可选):用于发布命令以控制窗帘/卷帘状态的 MQTT 主题。
  • payload_open(可选):打开窗帘/卷帘的有效载荷。默认为 "OPEN"。
  • payload_close(可选):关闭窗帘/卷帘的有效载荷。默认为 "CLOSE"。
  • payload_stop(可选):停止窗帘/卷帘的有效载荷。默认为 "STOP"。
  • state_topic(可选):订阅以接收窗帘/卷帘状态消息的 MQTT 主题。
  • state_open(可选):表示打开状态的有效载荷。默认为 "open"。
  • state_closed(可选):表示关闭状态的有效载荷。默认为 "closed"。
  • availability_topic(可选):订阅以接收来自 MQTT 窗帘/卷帘设备的出生和 LWT 消息的 MQTT 主题。如果未定义,窗帘/卷帘的可用性状态将始终为 "available"。如果已定义,窗帘/卷帘的可用性状态将默认为 "unavailable"。
  • payload_available(可选):表示在线状态的有效载荷。默认为 "online"。
  • payload_not_available(可选):表示离线状态的有效载荷。默认为 "offline"。
  • optimistic(可选):定义窗帘/卷帘是否以即时更新模式工作的标志。默认情况下,如果未定义状态主题,则为 true;否则为 false。
  • qos(可选):在接收和发布消息时使用的最大 QoS 级别。默认为 0。
  • retain(可选):定义发布的消息是否应设置保留标志。默认为 false。
  • value_template(可选):定义从有效载荷中提取值的模板。
  • set_position_topic(可选):发布位置命令的 MQTT 主题。
  • set_position_template(可选):定义要发送到主题的位置的模板。传入的位置值可以在模板中使用 {{ value }}。如果未定义模板,则将数字位置(0-100)直接写入主题。
  • tilt_command_topic(可选):发布命令以控制窗帘/卷帘倾斜的 MQTT 主题。
  • tilt_status_topic(可选):订阅以接收倾斜状态更新值的 MQTT 主题。
  • tilt_min(可选):最小倾斜值。默认

为 0。

  • tilt_max(可选):最大倾斜值。默认为 100。
  • tilt_closed_value(可选):在命令上发送的值。默认为 0。
  • tilt_opened_value(可选):在命令上发送的值。默认为 100。
  • tilt_status_optimistic(可选):确定倾斜是否以即时更新模式工作的标志。默认情况下,如果未定义,则为 false;否则为 true。
  • tilt_invert_state(可选):确定打开/关闭是否被翻转;较高的值表示关闭,较低的值表示打开。默认为 False。

示例:

# 完整配置示例(无倾斜)
cover:
  - platform: mqtt
    name: "MQTT 窗帘/卷帘"  # 设备的名称
    command_topic: "home-assistant/cover/set"  # 用于发布窗帘/卷帘命令的 MQTT 主题
    state_topic: "home-assistant/cover/state"  # 订阅以接收窗帘/卷帘状态消息的 MQTT 主题
    availability_topic: "home-assistant/cover/availability"  # 订阅来自 MQTT 窗帘/卷帘设备的出生和 LWT 消息的 MQTT 主题
    qos: 0  # 接收和发布消息时使用的最大 QoS 级别
    retain: true  # 定义发布的消息是否应设置保留标志
    payload_open: "OPEN"  # 打开窗帘/卷帘的有效载荷
    payload_close: "CLOSE"  # 关闭窗帘/卷帘的有效载荷
    payload_stop: "STOP"  # 停止窗帘/卷帘的有效载荷
    state_open: "open"  # 表示打开状态的有效载荷
    state_closed: "closed"  # 表示关闭状态的有效载荷
    payload_available: "online"  # 表示在线状态的有效载荷
    payload_not_available: "offline"  # 表示离线状态的有效载荷
    optimistic: false  # 定义窗帘/卷帘是否以即时更新模式工作的标志
    value_template: '{{ value.x }}'  # 从有效载荷中提取值的模板
# 完整配置示例
cover:
  - platform: mqtt
    name: "MQTT 窗帘"  # 设备的名称
    command_topic: "home-assistant/cover/set"  # 用于发布窗帘/卷帘命令的 MQTT 主题
    state_topic: "home-assistant/cover/state"  # 订阅以接收窗帘/卷帘状态消息的 MQTT 主题
    availability_topic: "home-assistant/cover/availability"  # 订阅来自 MQTT 窗帘/卷帘设备的出生和 LWT 消息的 MQTT 主题
    qos: 0  # 接收和发布消息时使用的最大 QoS 级别
    retain: true  # 定义发布的消息是否应设置保留标志
    payload_open: "OPEN"  # 打开窗帘/卷帘的有效载荷
    payload_close: "CLOSE"  # 关闭窗帘/卷帘的有效载荷
    payload_stop: "STOP"  # 停止窗帘/卷帘的有效载荷
    state_open: "open"  # 表示打开状态的有效载荷
    state_closed: "closed"  # 表示关闭状态的有效载荷
    payload_available: "online"  # 表示在线状态的有效载荷
    payload_not_available: "offline"  # 表示离线状态的有效载荷
    optimistic: false  # 定义窗帘/卷帘是否以即时更新模式工作的标志
    value_template: '{{ value.x }}'  # 从有效载荷中提取值的模板
    tilt_command_topic: 'home-assistant/cover/tilt'  # 用于发布窗帘/卷帘倾斜命令的 MQTT 主题
    tilt_status_topic: 'home-assistant/cover/tilt-state'  # 订阅以接收窗帘/卷帘倾斜状态消息的 MQTT 主题
    tilt_min: 0  # 最小倾斜值
    tilt_max: 180  # 最大倾斜值
    tilt_closed_value: 70  # 关闭状态的倾斜值
    tilt_opened_value: 180  # 打开状态的倾斜值

为了进行测试,您可以使用附带的命令行工具或包发送 MQTT 消息,这将允许您手动操作您的窗帘/卷帘:

$ mosquitto_pub -h 127.0.0.1 -t home-assistant/cover/set -m "CLOSE"

这条命令用于关闭窗帘/卷帘。

打赏赞微海报分享
mqtt topic 有效载荷 科技新闻

Home Assistant中使用MQTT电风扇的示例配置

Home Assistant中使用MQTT二进制传感器的示例配置

猜你喜欢

改善基础设施:HiveMQ如何推动智能城市发展

改善基础设施:HiveMQ如何推动智能城市发展

08/07
2024
为什么企业选择全托管HiveMQ云进行MQTT部署

为什么企业选择全托管HiveMQ云进行MQTT部署

07/01
2024
MQTT 赋能工业 PLC 数据采集与应用

MQTT 赋能工业 PLC 数据采集与应用

06/30
2024
  • 解决方案
    • 智能家居
    • 汽车与出行
    • 工业制造
    • 能源电力
    • 石油石化
    • 交通物流
    • 零售
  • 学习
    • MQTT 规范
    • MQTT 教程
    • MQTT 软件
    • MQTT 客户端库
    • MQTT 服务器
    • 工具和应用程序
  • 关于我们
    • 了解创科慧仁
    • 加入创科慧仁
    • 投资者关系
    • 新闻动态
    • 合作伙伴
    • 联系我们
  • 友情链接
    • Modbus中文网
    • 跳动符号官网
    • 物联网世界
    • RFID世界网
    • 深圳物联网协会
    • isoftstone软通动力
    • 中国发展战略学研究会
    • B.P商业伙伴
  • 在线客服
  • 全国客户服务热线
    4006909885
  • 官方公众号
  • 联系邮箱
    contact@mqtt.cn
Copyright © 2025 MQTT中文站. All rights reserved.Designed by nicetheme. 京ICP备20029519号
在线客服

微信咨询

微信咨询

4006909885

服务热线 7*24小时

电话咨询
  • 首页
  • MQTT 学习
    • MQTT 入门
    • MQTT 进阶
    • MQTT 编程
    • MQTT 实例
    • MQTT 要点
    • MQTT5 要点
    • MQTT 工具
    • MQTT 客户端库
    • MQTT 服务器
    • Zigbee2MQTT
    • Sparkplug
    • Home Assistant
    • Node-RED
  • MQTT 规范
    • MQTT 5 规范
    • MQTT 3.1.1 规范
    • MQTT 3.1 规范
    • MQTT-SN v1.2规范
    • Sparkplug® v3.0.0规范
  • 产品中心
  • 解决方案
    • 环境监测
    • 工业制造
    • 智慧水利
    • 水利管网
    • 积水监测
    • 综合管廊
    • 档案库房
    • 交通物流
    • 智慧城市
    • 智慧农业
    • 智慧养殖
    • 能源电力
    • 石油石化
    • 智能家居
    • 物联网
    • 汽车与出行
  • 使用文档
  • MQTT 云平台
  • 登录
  • 注册
string(5) "2.0.0"