让RuView接入Home Assistant:MQTT自动发现+Matter桥接全指南(21个实体一次配好) 让RuView接入Home AssistantMQTT自动发现Matter桥接全指南21个实体一次配好【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuViewRuView 是一个用普通 WiFi 信号就能完成人体存在检测、生命体征监测心率/呼吸率和姿态感知的开源 WiFi 感知项目——全程不需要摄像头。本指南教你把 RuView 接入Home Assistant通过MQTT 自动发现一条命令配好21 个实体11 个原始信号 10 个语义推断状态再用Matter 桥接让 Apple Home / Google Home 也能看见你的传感器。 RuView 是什么无摄像头的 WiFi 空间感知RuView 利用现有路由器发出的 WiFi 信号CSI/信道状态信息通过 Rust 编写的wifi-densepose-sensing-server感知服务器实时输出存在、人数、心率、呼吸率、跌倒、动作级别等数据。硬件上可以是一台树莓派 ESP32-S3 感知节点或信用卡大小的Cognitum Seed一体机。它的核心卖点没有摄像头、没有可穿戴设备就能知道卧室里有人、正在睡觉、呼吸率 16 RPM。但感知数据关在 RuView 自己的界面里对智能家居来说就是座孤岛——这就是本指南要解决的问题。 为什么是双协议MQTT 为主Matter 互补RuView 的 HA 集成设计决策见 ADR-115采用双协议策略两条路径不是二选一而是互补维度MQTT 自动发现HA-DISCOMatter 桥接HA-FABRIC覆盖数据全部21 个实体含心率、呼吸、姿态标准化子集存在/人数/跌倒/区域可用控制器Home Assistant 任意 MQTT 消费者Apple Home / Google Home / Alexa / SmartThings / HA配置方式HA 自动创建实体零代码扫二维码配对生物特征数据✅ 支持❌ Matter 协议尚无对应集群一句话MQTT 承载全量数据给 HA 玩家Matter 承载标准子集给全屋生态。一个节点可以同时进两个体系HA 通过unique_id自动去重不会出现幽灵设备。Cognitum Seed 是 RuView 的自学习硬件节点插上网就能工作无需云端账号 MQTT 自动发现完整配置步骤3 步搞定以下操作已在Home Assistant Core 2025.5 Mosquitto 2.0.18上验证完整操作手册见 Home Assistant 集成文档。前置条件一台局域网内的MQTT broker——最简单的方式是在 Home Assistant OS 的附加组件商店里一键安装MosquittoEMQX、VerneMQ 也兼容Home Assistant 2025.5 或更新版本MQTT 集成已启用并指向该 brokerRuViewwifi-densepose-sensing-serverv0.7.0二进制或源码cargo run编译第 1 步启动带--mqtt的感知服务器Docker 方式推荐非开发者docker run --rm --nethost \ ruvnet/wifi-densepose:0.7.0 \ --source esp32 \ --mqtt --mqtt-host 192.168.1.10 \ --mqtt-username homeassistant --mqtt-password-env MQTT_PASSWORD源码方式Rust 1.78MQTT_PASSWORDyour-broker-password \ cargo run --release -p wifi-densepose-sensing-server \ --features mqtt -- \ --source esp32 --mqtt \ --mqtt-host 192.168.1.10 \ --mqtt-username homeassistant第 2 步等待自动发现约 5 秒启动后感知服务器会向homeassistant/.../config主题逐实体发布发现消息保留消息、QoS 1每 600 秒刷新一次HA 重启也能自愈Home Assistant 随即自动创建1 个 device每个 RuView 节点一个以 MAC 或友好名称命名21 个 entities全部挂在该 device 下第 3 步验证打开 HA 的设置 → 设备与服务应能看到 RuView node 及其实体。感知服务器的实时数据面板长这样——这些 RSSI、动作带、呼吸带数值现在全部会同步进 HA 优雅停机直接 Ctrl-C发布会先向所有 availability 主题推送offlineHA 立即把实体标记为不可用kill -9则由 MQTT LWT遗嘱消息兜底30 秒内生效。 21 个实体全清单每个节点一次配好11 个原始信号实体HA 实体组件类型单位来源字段Presence存在binary_sensor—edge_vitals.presencePerson count人数sensorpersonsedge_vitals.n_personsHeart rate心率sensorbpmedge_vitals.heartrate_bpmBreathing rate呼吸率sensorbpmedge_vitals.breathing_rate_bpmMotion level动作级别sensor%edge_vitals.motionMotion energy动作能量sensor—edge_vitals.motion_energyFall detected跌倒event—edge_vitals.fall_detectedPresence score存在置信度sensor%edge_vitals.presence_scoreSignal strength信号强度sensordBmedge_vitals.rssiZone occupancy区域占用binary_sensor—sensing_update.zonesPose姿态关键点可选sensor属性—需加--mqtt-publish-pose10 个语义推断实体HA-MIND⭐这才是精华。RuView 内置一个服务端推理层用小型状态机把原始信号融合成自动化真正需要的高级状态每个状态还附带reason解释属性例如[motion5%, br12bpm, presencetrue]方便你调试为什么触发了语义实体触发条件someone_sleeping有人在睡觉存在 动作5% 呼吸率 8–20 bpm持续 5 分钟possible_distress疑似不适心率超基线 1.5 倍 动作20%持续 60 秒room_active房间活跃30 秒滚动窗口内动作 10%elderly_inactivity_anomaly老人活动异常空闲时间超过个人基线 2 倍meeting_in_progress会议进行中≥2 人 低幅动作持续 10 分钟bathroom_occupied卫生间有人存在 标记为 bathroom 的区域激活fall_risk_elevated跌倒风险升高0–100 风险分超过 70 触发事件bed_exit夜间离床22:00–06:00 从睡眠状态离开床区域no_movement无动作安全检查存在 动作1% 持续 30 分钟multi_room_transition跨房间移动10 秒内离开 X 区并进入 Y 区每个原型的精确率/召回率数据公开在 语义原语指标文档。 8 个自动化蓝图 3 个看板零代码直接用仓库内置了可直接导入的资产放在 examples/ha-blueprints/ 目录下——把 YAML 文件丢进 HA 的config/blueprints/automation/ruvnet/然后在设置 → 自动化与场景 → 蓝图 → 导入即可蓝图场景01 疑似不适时推送通知独居/老人看护02 有人睡觉时走廊调暗夜起不刺眼03 起床后唤醒流程灯光渐亮 咖啡机04 老人活动异常告警平时 9 点起床11 点还没动 → 提醒05 会议灯光勿扰模式办公室/居家办公06 卫生间有人时开排风扇隐私模式安全07 跌倒风险超阈值升级告警预防性干预08 房间无人时自动布防自动安防另外 examples/lovelace/ 提供 3 个开箱即用的Lovelace 看板单房间总览、多节点全屋网格、以及一个医疗/AAL 看护视图隐私模式下依然完整可用。 Matter 桥接Apple Home 也能接入不想只用 HA感知服务器内置 Matter 桥接--matter开关独立于--mqtt把节点以Bridged Devices Aggregator形态暴露给任意 Matter 控制器cargo run -p wifi-densepose-sensing-server -- \ --source esp32 \ --matter \ --matter-setup-file /tmp/matter-qr.txt启动后日志里会打印Matter 安装码 二维码字符串用 iPhone 的 Apple Home 或 HA 的 Matter 集成扫码即可配对支持多控制器同一节点可同时进 Apple Home、Google Home 和 HAMatter fabric 隔离机制HA 里会自动去重暴露的能力存在OccupancySensing、跌倒事件Switch.MultiPressComplete、人数厂商扩展属性仅 HA/SmartThings 可见、每区域占用端点注意心率、呼吸率、姿态不会走 Matter协议没有对应集群生物特征只走 MQTT重置配对用--matter-reset目前使用开发厂商 ID0xFFF1Apple Home 若提示未知厂商点仍然添加即可v0.7.0 的完整变更与基准数据见 v0.7.0 发布说明。 隐私模式健康数据不出家门在医疗、养老、商用环境部署时加上--privacy-mode心率、呼吸率、姿态关键点在MQTT 线上被直接剥离发现消息都不发布——HA 根本不知道这些实体存在10 个语义推断状态照常工作推理发生在服务器端过线的只是布尔值/分数。护理员能看到检测到不适但永远看不到原始心率数值这是让 RuView 能合规部署在养老院、医院、学校的架构级优势最小必要原则契合 HIPAA/GDPR 思路建议非 localhost broker 一律搭配--mqtt-tlsv0.7.0 对明文连接会打 WARNv0.8.0 起将直接硬失败。️ 常见故障排查症状排查步骤HA 里没有出现实体用mosquitto_sub -h broker -t homeassistant/# -v看是否有发现消息没有 → 检查--mqtt-host和网络有消息但 HA 无设备 → 确认 HA 的 MQTT 集成指向同一 broker实体出现但状态不更新看服务器日志有无[ws]/[edge_vitals]行确认 CSI 数据流诊断时把--mqtt-rate-vitals 1.0调高默认 0.2 Hz 即每 5 秒一次出现非 localhost 明文 MQTT WARN加--mqtt-tls并提供 CA或把 Mosquitto 搬到与感知服务器同一台机器Matter 配对失败检查--matter-setup-file里的安装码确认主机与控制器同一 WiFi 子网未知厂商提示点仍然添加写在最后一条--mqtt命令21 个实体自动就位8 个蓝图即导即用——RuView 从此不再是又一个黑盒感知平台而是任何 Home Assistant 安装乃至任何 Matter 生态智能家居的即插即用传感器。下一步可以试试把someone_sleeping接进你的晚安场景看看 WiFi 信号如何在你睡着时悄悄调暗走廊的灯 延伸阅读ADR-115 完整设计文档 · Home Assistant 集成操作手册 · 语义原语精度指标【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考