# mmware_map_card

**Repository Path**: dfrobot/mmware_map_card

## Basic Information

- **Project Name**: mmware_map_card
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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，类别选择“集成”：

   ```text
   https://github.com/DFRobot/mmware_map_card
   ```

5. 搜索并安装 **DFRobot mmWave Map**。
6. 完整重启 Home Assistant。

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

## 添加设备

进入：

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

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

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

例如两项均为 `c4004_0`。

## 添加地图卡片

只有一个设备条目时：

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

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

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

第二台设备：

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

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

## 卡片资源

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

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

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

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

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

## 手动安装

把：

```text
custom_components/mmwave_map
```

复制到：

```text
/config/custom_components/mmwave_map
```

然后重启 Home Assistant。

## 许可证

MIT