一、安装前准备
仅支持本地模式。 当前版本通过 mDNS 发现 EMS 设备，并通过 TCP 获取实时数据，无需 AEC Cloud 账号。
-
✓
Home Assistant 与 EMS 设备必须处于同一局域网（同一网段，网络中间不能有隔离 mDNS/UDP 广播的设备）。
-
✓
支持的设备类型：85、90、99、131、174，更多类型在持续支持中。
-
✓
准备一种能访问 Home Assistant 配置目录 /config 的方式，例如：Samba 共享、File Editor / Studio Code Server 加载项，或 SSH 终端。
二、安装包：ha_ems.zip
获取 ha_ems.zip 压缩包。解压后包含以下目录结构：
ha_ems.zip
├── custom_components/
│ └── ha_ems/
│ ├── manifest.json
│ ├── __init__.py
│ ├── config_flow.py
│ ├── local_mdns.py
│ ├── local_protocol.py
│ ├── sensor.py
│ ├── services.yaml
│ ├── strings.json
│ └── translations/
└── www/
└── ha_ems/
├── ha_ems.yaml
├── ha-ems-local-devices-card.js
└── *.svg
1
第 1 步：把文件放进 /config
把 ZIP 解压到 /config，解压后应得到以下两个目录：
/config/custom_components/ha_ems ← 集成本体（含 manifest.json）
/config/www/ha_ems ← 仪表盘卡片（ha_ems.yaml、JS 卡片等）
也可以直接手动复制这两个目录，效果相同。复制完成后，确认以下关键文件存在：
/config/custom_components/ha_ems/manifest.json
/config/custom_components/ha_ems/local_mdns.py
/config/www/ha_ems/ha-ems-local-devices-card.js
/config/www/ha_ems/ha_ems.yaml
2
第 2 步：在 configuration.yaml 中启用仪表盘
在 /config/configuration.yaml 中添加独立 YAML 仪表盘：
lovelace:
dashboards:
ha-ems:
mode: yaml
title: HA EMS
icon: mdi:home-lightning-bolt
show_in_sidebar: true
filename: www/ha_ems/ha_ems.yaml
现在跳过这步也没关系，之后随时可以补（补完需再重启一次）。
3
第 3 步：重启 Home Assistant
整个安装只需重启这一次
先用浏览器打开 Home Assistant 并登录（地址通常是 http://homeassistant.local:8123）。然后进入“开发者工具 → YAML”，点击“重启 Home Assistant”。
-
集成文件被 Home Assistant 加载。
-
如果做了第 2 步，侧边栏会出现 “HA EMS” 仪表盘。此时页面还没有数据，属正常现象，等第 4 步添加集成后会自动填充。
4
第 4 步：添加集成
-
在浏览器中打开 Home Assistant 并登录（地址通常是 http://homeassistant.local:8123；若上一步已打开页面，直接继续即可）。
-
进入“设置 → 设备与服务 → 添加集成”。
-
搜索 HA EMS 并提交。
-
配置流程会直接创建本地模式条目，不需要账号或密码。
添加完成后，设备发现和仪表盘数据会自动开始，无需再重启。仪表盘包含设备列表、连接状态、实时功率、能量流向图、控制参数和诊断信息。
5
第 5 步：检查前端资源
集成加载后会自动注册本地卡片资源，一般无需手动操作。如果页面提示 “找不到自定义卡”，再到“设置 → 仪表板 → 资源”手动添加：
URL: /local/ha_ems/ha-ems-local-devices-card.js?v=0.6.2
Type: JavaScript Module
同一个资源只添加一次。以后更新卡片文件后，在浏览器按 Ctrl+F5 强制刷新缓存。
6
第 6 步：验证安装
在“开发者工具 → 状态”中搜索以下实体：
sensor.ha_ems_mode
sensor.ha_ems_local_devices
sensor.ha_ems_local_device_issues
sensor.ha_ems_local_devices 的属性 devices 中应列出发现到的设备。每台受支持的设备会生成一个 sensor.ha_ems_<设备>_energy_parameters 实体。设备总览页显示数据后会出现能量流向图；若显示“正在等待 EnergyParameter 数据”，先检查设备连接和端口，再看 Home Assistant 日志。
常见问题
| 现象 | 处理方法 |
| 添加集成时找不到 HA EMS |
确认 /config/custom_components/ha_ems/manifest.json 存在，然后重启。 |
| 发现不到设备 |
确认 HA 与设备在同一网段，且网络未隔离 mDNS/UDP 广播。 |
| 设备已连接但没有能流图 |
能流图需要 EnergyParameter 响应；查看设备实体的 protocol_status、protocol_error 和日志。 |
| 页面提示自定义卡不存在 |
确认 JS 文件在 /config/www/ha_ems/，资源类型为 JavaScript Module，并按 Ctrl+F5。 |
| 实体显示“不可用” |
查看 HA 日志中的第一条 Python 异常，先修复再重启集成。 |
卸载
-
✓
在“设置 → 设备与服务”中删除 HA EMS 配置条目（会停止本地扫描和 TCP 连接）。
-
✓
删除 /config/custom_components/ha_ems 和 /config/www/ha_ems。
-
✓
重启 Home Assistant。
👉
联系我们获取集成包下载地址，或获取接入技术支持
👈