ha duke energy gateway

重要 - 弃用

杜克能源公司（Duke Energy）于2023年6月底关闭了网关飞行员计划。该集成停止了运作并弃用了。

杜克能源门户

这是家庭助理的自定义集成。它通过Duke Energy Gateway Pilot计划从Duke Energy吸引实时的能源。

这种集成利用我也写的pyduke-energy库来提取数据。此API非常非正式，并且可能随时停止工作（请参阅免责声明）。

先决条件！ （请阅读）

您必须将Duke Energy Gateway连接到您的SmartMeter，以使您有效。这是一个单独的设备，而不是您的智能电表，目前由仅邀请程序提供。如果您不知道这是什么，那么您可能没有它。此集成不支持任何其他检索数据的方法（请参阅网关要求）。

传感器

该组件将设置以下实体：

sensor.duke_energy_current_usage_w

• 代表瓦特中的实时功率使用情况。
• 该数据每1-3秒从网关设备推动。注意：这会产生很多数据。如果此更新间隔对您来说太常见了，则可以在几秒钟内配置节流间隔（请参见下面的配置）。
• 请注意，由于这是电力使用情况，因此无法将其用于家庭助理能量仪表板。取而代之的是，您可以使用sensor.duke_energy_usage_today_kwh传感器，也需要通过Riemann Sum积分集成来馈送此实时传感器。
• 可提供包含仪表ID和网关ID的其他属性。

sensor.duke_energy_usage_today_kwh

• 代表当今千瓦时的能源消耗（当地时间0:00到当地时间23:59，然后重置）。
• 该数据每60秒进行一次调查，但是由于杜克能源报告的延迟，数据可能会延迟长达15分钟（请参阅pyduke-energy Repo中的限制）。
• 这可以作为家庭助理消费仪表板的使用。
• 还有包含仪表ID，网关ID和最后测量时间戳的其他属性。

安装

HACS安装

1. 在HACS中的设置下添加为自定义存储库： mjmeli/ha-duke-energy-gateway ，然后选择Integration作为类别。
2. 在HACS中搜索“ Duke Energy Gateway”，现在应将集成作为搜索结果返回。单击它，单击“下载”按钮，然后浏览提示下载。
3. 重新启动家庭助理
4. 在HAUI中，转到“设置” - >“设备和服务”，请确保您在集成选项卡上，然后单击“+”，然后搜索“ Duke Energy Gateway”。这将使您设置它。

手动安装

1. 使用选择的工具打开了HA配置的目录（文件夹）（您可以在其中找到configuration.yaml ）。
2. 如果您没有custom_components目录（文件夹），则需要创建它。
3. 在custom_components目录（文件夹）中，创建一个名为duke_energy_gateway的新文件夹。
4. 从此存储库中的custom_components/duke_energy_gateway/ Directory（文件夹）下载所有文件。
5. 将您下载的文件放在您创建的新目录（文件夹）中。
6. 重新启动家庭助理
7. 在HAUI中，转到“设置” - >“设备和服务”，请确保您在集成选项卡上，然后单击“+”，然后搜索“ Duke Energy Gateway”。这将使您设置它。

配置

配置将在UI中完成。最初，您需要提供以下数据：

数据	描述
email	您的登录电子邮件到Duke Energy。
password	您的登录密码到Duke Energy。

设置集成后，您将能够通过在集成页面上单击“配置”来进行进一步的配置。这将使您可以修改以下选项：

数据	描述
Real-time Usage Update Interval (sec)	默认情况下，随时可以更新实时使用传感器。如果此数据过于频繁，则可以配置此值以节省数据。设置为正整数X时，传感器只能每X秒更新一次。换句话说，如果设置为30，您将每30秒获得一次新的实时用法。

仪表选择

配置流将自动尝试识别您的网关和智能计。目前，每个帐户仅支持一个。确定的第一个将使用。如果找不到一个，则配置过程应失败。

如果您的仪表选择失败，则第一步应该是启用对组件的记录（请参阅记录）。如果这没有洞悉问题，请打开GitHub问题。

记录

如果您遇到任何问题并想研究日志，则此集成提供在调试级别的详细记录。可以通过将以下内容添加到您的configuration.yaml文件来启用。

 logger :
  default : info
  logs :
    custom_components.duke_energy_gateway : debug
    pyduke_energy.client : debug
    pyduke_energy.realtime : debug 

发展

我建议通过使用code .然后单击使用DEV容器重新打开的选项。在VS代码中，您可以运行任务“在端口9123上运行家庭助理”，然后通过http：// localhost：9123访问它。

如果要手动安装，则可以使用pip install -r requirements_dev.txt安装DEV依赖项。

在提交之前，运行pre-commit run --all-files 。

与开发pyduke-energy版本合作

如果您正在努力实施从pyduke-energy的新更改，但不想发布该库的版本，则可以设置开发环境以从远程工作分支安装。

1. Update requirements_dev.txt to replace the main in git+https://github.com/mjmeli/pyduke-energy@main with your working branch and update the username if you have a fork (eg git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch )
2. 卸载pyduke-energy的本地缓存版本： pip uninstall -y pyduke-energy
3. 重新运行要求安装： pip install -r requirements_dev.txt

欢迎捐款！

如果您想为此做出贡献，请阅读贡献指南

学分

该项目是由 @oncleben31的家庭助理定制组件CookieCutter模板生成的。

代码模板主要来自 @ludeeus的integration_blueprint模板

---