Hildebrand Glow (DCC) 集成
使用Hildebrand Glow API从英国SMETS(智能)电表获取能源消耗数据的Home Assistant集成。
此集成无需Hildebrand Glow提供的消费者设备即可工作,可与您现有的智能电表配合使用。您需要在Android或iOS上的Bright应用中免费设置您的智能电表。这仅适用于使用数据通信公司(DCC)后端的情况,所有SMETS 2电表和部分SMETS 1电表都使用此后端。一旦您可以在应用中看到您的数据,就可以开始使用了。
提供的数据会有大约30分钟的延迟。要获取实时消耗数据,您可以购买Hildebrand Glow硬件。虽然此集成技术上可以与他们的硬件配合使用,但您应该使用本地MQTT集成或云端MQTT集成来获取无延迟的实时消耗数据。
安装
通过HACS自动安装
您可以通过HACS安装此组件以轻松接收更新。安装HACS后,点击此链接:
手动添加到HACS
访问HACS集成面板并转到浏览和下载存储库。搜索Hildebrand Glow (DCC)
,然后点击下载。之后您就可以通过集成面板安装它了。
手动安装
将 custom_components/hildebrandglow_dcc/
目录及其所有文件复制到您的 config/custom_components/
目录中。
配置
安装完成后,重启 Home Assistant:
然后,添加集成:
手动添加集成
访问 Home Assistant 中的集成部分,点击右下角的添加按钮。搜索Hildebrand Glow (DCC)
并输入您的凭据。您可能需要清除浏览器缓存才能使集成出现在列表中。
传感器
认证成功后,集成将自动为您账户上的每个智能电表设置以下传感器:
- 使用量(今日)- 今天的消耗量(千瓦时)
- 费用(今日)- 今天消耗的总费用(英镑)
- 基本费用 - 当前基本费用(英镑)
- 费率 - 当前电价(英镑/千瓦时)
使用量和费用传感器会继续显示前一天的数据,直到01:30之后不久,以确保收集到前一天的所有数据。
基本费用和费率传感器默认是禁用的,因为它们不太常用。在启用它们之前,请确保数据在 Bright 应用程序中可见。
如果显示的数据有误,请先检查 Bright 应用程序。如果那里的数据也有误,您需要联系您的供应商,告诉他们修复提供给 DCC 其他用户的数据,因为 Bright 就是其中之一。
能源管理
创建的传感器直接集成到 Home Assistant 的家庭能源管理中。 建议您在能源集成中使用每日使用量和费用传感器。
调试
要调试集成,请在您的 configuration.yaml
中添加以下内容:
logger:
default: warning
logs:
custom_components.hildebrandglow_dcc: debug
开发
首先,建议创建一个虚拟环境来安装依赖项:
python -m venv dev-venv
. dev-venv\Scripts\activate
然后您可以安装允许您进行开发的依赖项:
pip3 install -r requirements-dev.txt
这将安装 black
、homeassistant
、isort
、pyglowmarkt
和 pylint
。
代码风格
该项目使用 black、isort 和 pylint 来在整个代码库中强制执行一致的代码风格。
致谢
感谢:
-
pyglowmarkt 库,用于与 Hildebrand API 交互。
-
Hildebrand API 文档和Swagger UI。
-
本项目所基于的原始项目。
-
用于理解API的Hildebrand-Glow-Python-Library。
-
所有的贡献者和用户,没有他们,这个集成就不会有今天的成果。