Home Assistant 与 MQTT
在 App 配置 MQTT,接入七项设备数据,并区分暂时停用与清除配置。
已配对设备可从桌面 App“设备设置 → MQTT / Home Assistant”配置;Android 在“设置 → Home Assistant / MQTT”进入。数据由设备直接发往 Broker,App 退出后仍可上报。
支持的内容
提供温度、湿度、CO₂、光照、在位状态、本次在位时长和今日累计在位时长七项数据,不提供番茄钟控制或主题管理。
未知状态不能当作无人;离席或未知时,本次在位秒数不可用;未校时或今日统计不可用时,今日累计不可用。雷达确认离席结束旧会话,返回重新计时,离席不会回补到累计值。
配置与验证
- 在可信局域网准备 MQTT Broker 和用户名、密码,Home Assistant 连接同一个 Broker,并使用默认的
homeassistant发现前缀。 - 连接目标 DeskPulse,打开 App 的 MQTT 页面。
- “服务器地址”填写 Broker 的 IPv4 或主机名,不带协议、端口和路径;单独填写端口,默认 1883。
- 填写 MQTT 用户名和密码。这里不是 Home Assistant 网页地址、网页登录账号或 DeskPulse 配对码。已有密码留空表示保持不变。
- 点击“保存并启用”,等待设备确认,再观察“连接状态”;也可先“保存配置(保持关闭)”。
- Broker 已连接后,到 Home Assistant 的 MQTT 集成检查设备和传感器是否发现、是否更新。需要时点击“刷新 MQTT 状态”。
App 显示保存成功不代表 Broker 或 Home Assistant 已接通。失败时先检查地址、网络与账号密码;旧固件缺少能力时按提示配套升级。
停用与清除
- 关闭“启用 MQTT”:暂停连接,保留服务器配置、凭据和 Home Assistant 实体。
- “清除配置”:二次确认后删除设备保存的服务器、账号和密码,同时关闭 MQTT。Home Assistant 可能仍需手工删除残留设备。
- 更换 Broker:核对新地址与凭据,旧服务器的残留实体可能需要手动处理。
- 恢复出厂会清除 MQTT 配置。
当前限制
当前仅支持 MQTT 3.1.1 明文 TCP,默认端口 1883;不支持匿名连接、MQTT TLS 或 WebSocket,换端口也不会启用 TLS。请在可信局域网使用。设备屏幕和浏览器配网页没有 Broker 配置入口。
Broker 暂时离线不影响设备本地环境采集、在位记录、番茄钟与 App 局域网直连。