HomeAssistant 蓝牙室内定位终极指南Bermuda 从零到一实现房间级追踪【免费下载链接】bermudaBermuda Bluetooth/BLE Triangulation / Trilateration for HomeAssistant项目地址: https://gitcode.com/gh_mirrors/be/bermuda你的客厅里明明坐着人感应灯却理直气壮地黑着脸——这大概是很多 HomeAssistant 玩家的共同记忆。Bermuda 是一款开源的 HomeAssistant 蓝牙定位集成它借助多个蓝牙代理接收到的信号强度做三角测量把在家/不在家的二元判断升级成人具体在哪个房间的精细定位让你的自动化第一次拥有真正的方位感。痛点你的自动化为什么总比你的脚步慢半拍大多数家庭玩过基于 WiFi 或蓝牙的存在检测手机连上路由器人就在家断开人就离家。这套方案有个尴尬的盲区——在家不等于在客厅。于是你会看到这样的日常人已经走进卧室卧室灯却纹丝不动人已经出门上班客厅的空调还要再吹上半小时。传统追踪给不了房间这一维信息自动化只能靠猜而靠猜的智能家居永远差点意思。方案Bermuda 的思路是给家里装一双会算数的耳朵Bermuda 的原理并不神秘。它会收集家里各个蓝牙代理收到的信号强度RSSI也就是这个设备离我有多近的数值再根据信号随距离衰减的规律估算出设备与每个代理之间的距离。当多个代理同时听见同一台设备时就能交叉判断出它到底在哪个区域——这正是 Trilateration三角测量这个名字的由来也是它被叫作蓝牙三角定位的原因。Bermuda 集成主界面设备与实体数量一目了然蓝牙定位状态尽在掌握这套方案最大的好处是不需要给每台设备装 App、不需要额外的定位网关凡是能发 BLE 广播的东西——手机、手表、信标、温湿度计——都能纳入房间级追踪体系。上手5 分钟列出你的硬件清单先别急着装软件把三样东西备齐整个过程比想象中轻量HomeAssistant 本体建议保持较新版本老版本可能缺少蓝牙后端支持。至少一个蓝牙代理信号采集点三选一ESP32 开发板比如 D1-Mini32刷 ESPHome 固件并开启bluetooth_proxy组件便宜可靠是社区的主力选择Shelly Plus 及更新型号启用蓝牙代理功能后同样能干活主机自带的 USB 蓝牙适配器不推荐——它没法给广播包打时间戳定位精度大打折扣只适合最简单的在家/离家判断。一台想追踪的 BLE 设备手机、智能手表、钥匙信标都可以。 小贴士代理越多定位越准。想让每个房间都有判断力客厅、卧室、走廊最好各有一台信号覆盖。安装三步装好再说说手动方案HACS 安装推荐——只需几步即可完成打开 HACS搜索 Bermuda找到 Bermuda BLE Trilateration点击安装重启 HomeAssistant。手动安装同样不复杂在 HA 配置目录下建好custom_components/bermuda文件夹把项目对应目录里的文件放进去再重启即可。习惯命令行的话也可以直接把仓库 clone 到该目录git clone https://gitcode.com/gh_mirrors/be/bermuda custom_components/bermuda实战把第一台设备请进 Bermuda重启后在设置 → 设备与服务里添加 Bermuda。进入配置页你会看到它听见的所有蓝牙设备列表勾选想追踪的那台并保存Bermuda 就会为它生成两个核心传感器Area区域设备当前所在房间是自动化最常用的判断依据Distance距离设备距离最近代理的估算米数能看出人的走动趋势。设备详情页区域、距离、与各代理的测距结果一览无余这样做的好处是想实现进门开灯直接写一条区域变为客厅的自动化即可不用再靠一堆在家状态拼凑逻辑代码量瞬间清爽。进阶三个让定位脱胎换骨的能力1. 绑定 Person实现家庭成员位置追踪。Bermuda 会为设备生成device_tracker实体在设置 → 人员里把它挂到对应的人名下HomeAssistant 就能自动推算每个人的在家/离家状态。全家人出门后自动关空调、关灯一条规则就能覆盖。2. 搞定随机 MAC 地址设备iOS / Android 玩家的痛点。现在的手机出于隐私保护会定期更换蓝牙地址传统按 MAC 追踪的方式直接失效。Bermuda 支持 IRK可解析密钥方案先在 HomeAssistant 的 Private BLE Device 组件里登记设备密钥Bermuda 就能自动解析出它的真实身份随机地址从此不再是难题。3. 追踪 iBeacon 信标。像按 UUID 广播的信标设备Bermuda 也能以信标设备的形式纳入追踪特别适合盯贵重物品、宠物或者给汽车做一个已停回车库的判断。想深挖实现原理的读者可以翻一翻 custom_components/bermuda/coordinator.py距离计算与区域判定的核心算法都在这里。调优把大概准调成非常准Bermuda 在配置页和 custom_components/bermuda/const.py 中暴露了几个关键参数值得按自家环境微调环境衰减系数墙面、家具越多信号衰减越快适当调大数值1 米处参考 RSSI不同芯片默认值有差异可对照实测结果校准最大追踪半径超出即视为离开能有效滤掉邻居家设备的干扰超时时间多久没听到信号就标记为离开平滑采样数采样越多距离变化越平缓但响应越慢。另外Bermuda 还提供了bermuda.dump_devices服务在开发者工具 → 服务里调用就能导出每台设备与每个代理之间的原始数据。排查为什么定位不准时这份数据就是最直接的证据。避坑常见问题排查清单距离一直显示 Unknown通常是代理根本没收到该设备的广播。先确认设备蓝牙是否开启、与代理之间是否有遮挡再看看代理本身是否工作正常。区域判断总是慢半拍试试把更新间隔调小、平滑采样数调低代价是传感器数据量变大、数据库涨得快注意权衡。代理提示未分配区域每个代理都应归属到某个 HomeAssistant 区域房间否则它收集的信号无法参与区域判定界面上也会给出相应提醒。USB 蓝牙适配器定位飘这不是设置问题而是硬件先天不足建议直接换 ESP32 代理。结语现在就去给自动化装上方位感从人在家到人在客厅Bermuda 用一套无需昂贵硬件的方案把存在检测往前推进了一大步。无论你想省电、防盗还是单纯想让灯追着人走它都能提供全新的自动化思路。按上面的步骤装上、绑定第一台设备今晚就能感受到房间级蓝牙定位带来的变化——动手试试吧。【免费下载链接】bermudaBermuda Bluetooth/BLE Triangulation / Trilateration for HomeAssistant项目地址: https://gitcode.com/gh_mirrors/be/bermuda创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考