待补充
mKeRix/room-assistant
3/5
🧩 软硬件结合
已发布
项目简介
Presence tracking and more for automation on the room-level
room-assistant 是一个专注于房间级自动化的开源项目，旨在将家庭自动化从“整屋控制”提升到“房间级精准管理”。它的核心功能是精确追踪每个房间的占用情况以及你在房屋内的具体位置，同时支持接入各类传感器数据。项目采用模块化设计，你可以根据需求灵活选择蓝牙低功耗（BLE）扫描、红外传感器、门窗传感器等组件，所有数据都能无缝集成到 Home Assistant 等主流家庭自动化平台中。
标签
项目特点
**房间级精准定位**：通过蓝牙低功耗（BLE）扫描、红外传感器、门窗传感器等多重手段，精确判断每个房间的占用状态和人员位置。
**模块化架构**：核心功能按模块拆分，你可以根据实际需求自由组合 BLE、红外、温湿度、光照等传感器组件，避免资源浪费。
**无缝集成 Home Assistant**：所有传感器数据通过 MQTT 或 REST API 直接推送至 Home Assistant，无需额外桥接，配置简单。
**低功耗硬件支持**：可运行在树莓派、ESP32、ESP8266 等低功耗设备上，适合长期部署在多个房间。
**开源且社区活跃**：代码完全开源，社区持续贡献新模块和修复，支持自定义扩展。
**多传感器融合**：支持同时接入蓝牙、红外、超声波、门窗磁等多种传感器，通过算法融合提高占用检测的准确率。
技术规格
| 支持平台 | Home Assistant, MQTT Broker |
|---|---|
| 通信协议 | MQTT, REST API, WebSocket |
| 传感器支持 | BLE 扫描、红外 (PIR)、门窗磁、温湿度、光照、超声波 |
| 硬件兼容性 | Raspberry Pi (3/4/Zero), ESP32, ESP8266, Linux 主机 |
| 部署方式 | Docker 容器、Node.js 直接运行、Home Assistant 插件 |
| 数据输出 | JSON 格式，通过 MQTT 主题或 HTTP 端点 |
| 扫描间隔 | 可配置，默认 5 秒 |
| 最大设备数 | 取决于硬件性能，通常支持 50+ BLE 设备 |
| 语言 | JavaScript (Node.js) |
| 许可证 | MIT |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Raspberry Pi 3/4/Zero 或 ESP32/ESP8266 | 1 | — | 每个房间至少一个 |
| BLE 扫描模块（内置蓝牙） | 1 | — | 树莓派/ESP32 自带 |
| 红外运动传感器 (PIR) | 1-2 | — | 可选，推荐 HC-SR501 |
| 门窗磁传感器 | 1-3 | — | 可选，用于门窗状态检测 |
| 温湿度传感器 (DHT22/BME280) | 1 | — | 可选 |
| 光照传感器 (BH1750) | 1 | — | 可选 |
| MQTT Broker (如 Mosquitto) | 1 | — | 可部署在树莓派或 NAS 上 |
| 5V 2A 电源适配器 | 1 | — | 为树莓派/ESP 供电 |
| MicroSD 卡 (16GB+) | 1 | — | 树莓派系统盘 |
能力画像
**记忆与知识检索**：3/5 — 需要查阅文档了解各模块配置和传感器接线，但文档结构清晰，检索难度中等。
**动手与操作**：4/5 — 涉及硬件接线、传感器安装、设备部署，需要一定的动手能力和耐心。
**编程与算法**：2/5 — 主要工作是修改 JSON/YAML 配置文件，无需编写复杂代码，但理解 MQTT 和自动化规则需要基础编程思维。
**设计与建模**：1/5 — 项目不涉及电路设计或3D建模，硬件布局简单。
**实验与调试**：4/5 — 需要反复测试传感器触发范围、蓝牙扫描精度、MQTT 通信稳定性，调试过程较多。
**协作与分享**：3/5 — 可通过 GitHub Issues 和 Discord 社区交流问题，但项目规模较小，协作机会有限。
**学习与研究**：3/5 — 需要学习 MQTT 协议、Home Assistant 自动化、传感器原理，但学习曲线平缓。
**系统集成**：5/5 — 核心价值在于与 Home Assistant 深度集成，支持多种传感器和自动化场景，集成能力极强。
项目图库
所需技能
基础 Linux 命令行操作（SSH、文件编辑）
了解 MQTT 协议基本概念
熟悉 Home Assistant 配置与自动化
基础硬件接线能力（杜邦线、面包板）
阅读英文技术文档的能力
简单的 YAML/JSON 配置文件编辑
网络基础知识（IP 地址、端口转发）
适用场景
实现“人到灯亮、人走灯灭”的房间级灯光自动化
根据房间占用情况自动调节空调、暖气温度
监测老人或儿童在房屋内的活动轨迹，提供安全提醒
办公室会议室占用检测，自动显示空闲状态
智能家居场景联动：检测到进入卧室后自动关闭客厅灯光、启动睡眠模式
多房间设备管理：根据人员位置自动切换音乐、电视等设备到所在房间
节能优化：无人房间自动关闭非必要电器