Emporia Energy 技能

使用 {baseDir}/scripts 目录下的脚本来直接查询 Emporia Vue 设备数据。

运行模式通过环境变量 EMPORIA_MODE 指定：

• cloud：通过 PyEmVue 访问 Emporia 云 API（与 Home Assistant 集成方式相同）
• esphome：访问本地 ESPHome API（适用于已刷写 ESPHome 固件的设备）

选择模式（云端 vs 本地）

• 若您的 Emporia 设备仍运行官方固件，或您希望采用最简部署方式，请使用 cloud 模式。该模式需提供 Emporia 账户凭据，并依赖互联网连接。
• 仅当设备已刷写 ESPHome 固件且位于您的局域网（LAN）内时，才可使用 esphome 模式。该模式需配置设备 IP 地址或主机名，并确保可通过端口 6053 访问原生 API。

若您不确定设备是否已刷写 ESPHome 固件，请选择 cloud 模式。

环境变量配置

Cloud 模式

• EMPORIA_EMAIL
• EMPORIA_PASSWORD

可选：

• EMPORIA_SCALE（可选值：MINUTE、SECOND、MINUTES_15、DAY、MONTH），默认为 MINUTE

ESPHome 模式

• ESPHOME_HOST
• ESPHOME_PORT（可选，默认为 6053）
• ESPHOME_API_KEY（Noise PSK，Base64 编码）或 ESPHOME_PASSWORD（旧版认证方式）

配置步骤

Cloud 模式：

1. 设置 EMPORIA_MODE=cloud。
2. 设置 EMPORIA_EMAIL 和 EMPORIA_PASSWORD。
3. （可选）设置 EMPORIA_SCALE 以控制功率（power）或能量（energy）单位。
4. 首先运行 list 命令确认通道列表，再运行 summary 或 circuit 。

ESPHome 模式：

1. 确保设备已刷写 ESPHome 固件并接入您的局域网。
2. 设置 EMPORIA_MODE=esphome。
3. 将 ESPHOME_HOST 设置为设备的 IP 地址或主机名（非 Home Assistant 实例地址）。
4. 若 ESPHome 节点启用了加密通信，请设置 ESPHOME_API_KEY（Base64 编码的 Noise PSK）。
5. 首先运行 list 命令确认通道列表，再运行 summary 或 circuit 。

支持的命令

脚本支持以下命令：

• summary（默认命令）
• list
• circuit

使用示例

Cloud 模式：

export EMPORIA_MODE=cloud
export EMPORIA_EMAIL="you@example.com"
export EMPORIA_PASSWORD="..."
python {baseDir}/scripts/emporia_cloud.py summary

ESPHome 模式：

export EMPORIA_MODE=esphome
export ESPHOME_HOST="192.168.1.50"
export ESPHOME_API_KEY="base64-noise-psk"
python {baseDir}/scripts/emporia_esphome.py summary

依赖项（默认使用 pip）

Cloud 模式：

python3 -m venv .venv
source .venv/bin/activate
pip install -r {baseDir}/requirements-cloud.txt

ESPHome 模式：

python3 -m venv .venv
source .venv/bin/activate
pip install -r {baseDir}/requirements-esphome.txt

可选：您也可根据偏好使用 uv 替代 pip。

输出格式

脚本输出 JSON 格式数据，包含以下字段：

• timestamp（时间戳）
• unit（计量单位）
• total（总值，尽力而为）
• top circuits（用电量最高的回路）
• channels used（已使用的通道）

安全须知

• 切勿在任何输出中打印密钥类信息（如密码、Token、密钥等）。
• 不得提供任何硬件操作或配电箱接线方面的建议。