Home Assistant 神级雷达地图

群里在讨论雷达地图，就发出来给大家共享一下一个超强的雷达地图管理工具 —— Radar Map Manager（简称 RMM）。这个项目解决了毫米波雷达在智能家居应用中的几个核心痛点：多雷达融合、误报过滤、精准定位。

可视化编辑器，上手零门槛

RMM 最大的特色是它的可视化编辑器。支持两种模式：

• 配置模式（config）
  完整编辑功能，拖拽、调整、设置全覆盖

• 展示模式（read_only）
  仅展示，禁止修改

智能发现与多户型管理

自动扫描局域网内的雷达设备，一键添加。支持多户型（map_group），轻松管理复式、别墅的多个楼层与地点。

灵活的雷达配置

在户型图上自由拖拽雷达到实际摆放位置，支持旋转、缩放、镜像翻转。最厉害的是 Freeze 自动定位缩放：点击 Freeze 锁定雷达识别的第一个目标，手动拖动该目标到户型图实际位置，系统自动计算精确缩放比例，告别盲猜。

完美支持侧装（Side Mount）和顶装（Ceiling Mount）两种安装方式。

多雷达数据融合，告别影分身

家里装多个雷达最怕什么？当然是影分身！RMM 的 Sensor Fusion 引擎完美解决这个问题：

• 自动聚类
  多个雷达探测到同一目标时自动合并，融合范围可自定义

• 盲区互补
  多雷达叠加，消除探测死角

• 轨迹平滑
  内置 10 级目标轨迹平滑处理，运动轨迹自然流畅
• 
  

六大区域管理，防误报神器

RMM 提供了 6 种不同类型的区域，每种都有独特用途：

1. Monitor Zones（雷达监测区）

为每个雷达单独设置监测区。只有进入该区域才会触发该雷达的目标融合与显示。未设置则默认全局融合。

2. Detect Trigger（全局监测区）

自由设置监测区，融合目标进入该区域后自动触发 HA 实体（binary_sensor 存在实体 + sensor 人数实体）。支持自定义触发延迟（Delay），有效避免误报。

3. Detect Exclude（全局排除区）

这是干扰源杀手！在地图上圈出风扇、窗帘、绿植等位置，设为排除区。引擎自动过滤该区域内所有干扰信号，精准排除杂波。

4. Entrance Zones（入口区域）

绿色通道，防误报双保险。诞生在此区域的任何新目标，被无条件信任并瞬间转正，无需等待验证延迟。建议画在房间真实门框位置，实现零延迟的有人状态上报。

5. Stationary Hold（静止驻留区）

针对深度睡眠、阅读、如厕等微动极小的场景。雷达在此区域内短暂丢失信号时，在原地锁定驻留锚点，在倒计时结束前持续向智能家居汇报有人状态。

Stationary Hold 延时详解

这是 RMM 最实用的功能之一！你可以为每件家具定制专属容忍时间（单位：秒）：

• 大床（深度睡眠）
  设为 3600（1 小时），盖厚被子一动不动也能安心睡到天亮

• 沙发（专注观影）
  设为 600（10 分钟），兼顾沉浸体验与起身后自动关灯

• 马桶/浴缸（卫浴保护）
  设为 300（5 分钟），告别洗澡上厕所需要尴尬挥手
• 
  

绘制时通过顶部 Dly 填入秒数，留空或 0 则默认使用系统全局 S_Hold 时间。

3D 空间修正，侧装雷达福音

针对侧装雷达，RMM 内置 3D 修正算法。根据雷达安装高度与目标高度，自动将斜距还原为地距，定位精度大幅提升。

Zero I/O：60 FPS 电竞级丝滑

RMM 实现了前端 UI 与自动化的彻底分离。高达 10 Hz 的雷达目标不再写入 HA 状态机，通过内存级隧道直连前端卡片，获得 60 FPS 满血电竞级丝滑画面，对 HA 数据库写入损耗降为 0。

零信任安全架构

RMM 专属雷达即将全面接入，采用动态 PIN 码与硬件级加密，保护雷达设备本地安全接入 HA，杜绝隐私外泄。

支持的硬件

RMM 兼容性超强：

连接方式

• ESPHome / MQTT

• Zigbee（需支持坐标上报）
• 
  

坐标实体命名规范

非 RMM 专属雷达需要按以下规范命名实体：

1D 雷达：sensor.[radar_name]_distance

2D/3D 雷达：sensor.[radar_name]_target_?_x/y/z

雷达目标数（可选）：sensor.[radar_name]_presence_target_count

目标坐标单位支持 m/cm/mm，强烈建议设置单位，未设置时默认用 m。

高频实体排除设置

在 HA configuration.yaml 中增加配置，减轻数据库与 I/O 压力：

recorder:  exclude:    entity_globs:      - sensor.rmm_*_master

安装方法

HACS 自动安装（推荐）

添加仓库，打开 Home Assistant 左侧 HACS → 集成（Integrations）→ 浏览并下载存储库 → 搜索 Radar Map Manager → 下载 → 重启 HA。

配置指南

第一步：添加集成

配置 → 设备与服务 → 添加集成 → 搜索 Radar Map Manager 并添加。

第二步：添加卡片

仪表盘 → 编辑仪表盘 → 添加卡片 → 搜索 Radar Map Manager 卡片。

编辑模式完全指南

点击卡片右上角 ⚙️ 进入编辑模式，包含三大模块：

A. 雷达布局（Layout）

添加/删除雷达：点击 + 选中扫描出的雷达或输入 HA 中的雷达名称，点击 – 删除已添加雷达。

雷达设置：拖动雷达到实际摆放位置，拖动雷达把手选择角度。调整比例推荐点击 Freeze 自动计算，也可手动调整 ScX/ScY 或点击 Ax/Ay。镜像模式勾选 Mirror。自定义雷达类型：2D、2.5D 或 3D。H 为雷达安装高度。UNDO 撤销上一步。

雷达监测区域设置：选中雷达 → 点击 Monitor → ADD NEW → 选定多边形端点 → 命名 → FINISH 保存。双击端点删除，选中区域 DEL 删除，CLR ALL 删除全部。

B. 区域管理（Zones）

Detect Trigger 区域：编辑操作同 Monitor 区域。Dly 设置目标进入/离开消抖延迟（秒），自动创建 binary_sensor 与 sensor 实体。

Detect Exclude 区域：落入的融合目标被直接丢弃，不显示、不触发。

Entrance Zones（入口区域）：落入的融合目标立即活人认证，无需 verify 延迟。

Stationary Hold（静止驻留区域）：可通过 Dly 单独定义驻留容忍时长（秒）。

项目地址

• https://github.com/Moe8383/radar_map_manager

  
  想要了解更多好用集成，敬请关注，不要错过

•