DFRobot mmWave Map

DFRobot C4004 的 Home Assistant 自定义集成和 Lovelace 雷达地图卡片。

功能

• 支持多台 C4004，每台设备使用一个独立集成条目
• 显示实时目标轨迹、检测范围和标签区域
• 显示区域状态、名称和底图
• 通过 ESPHome Native API 实体与 MQTT bridge 组合获取数据
• 从卡片跳转到 DFRobot mmWave Add-on

要求

• Home Assistant
• 已通过 ESPHome 集成接入的 C4004
• 已配置 C4004 mqtt_bridge
• Home Assistant 已配置 MQTT 集成

通过 HACS 安装

1. 打开 HACS。

2. 进入“集成”。

3. 右上角菜单选择“自定义存储库”。

4. 填写仓库 URL，类别选择“集成”：

   https://github.com/DFRobot/mmware_map_card
   

5. 搜索并安装 DFRobot mmWave Map。

6. 完整重启 Home Assistant。

HACS 要求本目录作为 GitHub 仓库根目录发布，不能继续嵌套在其他仓库的子目录中。

添加设备

进入：

设置 → 设备与服务 → 添加集成 → mmWave Map

每台 C4004 创建一个条目，并填写：

• MQTT 前缀：对应固件 mqtt_bridge.topic_prefix
• 实体前缀：对应 ESPHome 节点在 HA 中生成的实体 object_id 前缀

例如两项均为 c4004_0。

添加地图卡片

只有一个设备条目时：

type: custom:mmwave-map-card
title: 客厅雷达

存在多个设备条目时，使用实体前缀选择设备：

type: custom:mmwave-map-card
title: 客厅雷达
entity_prefix: c4004_0

第二台设备：

type: custom:mmwave-map-card
title: 卧室雷达
entity_prefix: c4004_1

large 默认为 true，通常不需要填写。

卡片资源

集成会自动注册卡片脚本。如果前端提示：

Custom element doesn't exist: mmwave-map-card

在 Home Assistant 的“设置 → 仪表盘 → 资源”中添加：

URL: /mmwave_map/mmwave-map-card.js
类型: JavaScript 模块

然后完整重启 Home Assistant，并强制刷新浏览器缓存。

手动安装

把：

custom_components/mmwave_map

复制到：

/config/custom_components/mmwave_map

然后重启 Home Assistant。

许可证

MIT