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模板

---