From e7240fd3aecad376126d81d273b5b4572e0a0b66 Mon Sep 17 00:00:00 2001 From: Jason Hunter Date: Mon, 23 Sep 2024 02:59:24 -0400 Subject: [PATCH] Duke Energy Documentation (#34631) * Duke Energy Documentation * Style tweaks, add config flow and prereqs * fix markdown * tiny tweak * Update source/_integrations/duke_energy.markdown --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/duke_energy.markdown | 39 +++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 source/_integrations/duke_energy.markdown diff --git a/source/_integrations/duke_energy.markdown b/source/_integrations/duke_energy.markdown new file mode 100644 index 00000000000..20c144d2ef7 --- /dev/null +++ b/source/_integrations/duke_energy.markdown @@ -0,0 +1,39 @@ +--- +title: Duke Energy +description: Instructions on how to integrate Duke Energy within Home Assistant. +ha_category: + - Energy +ha_release: 2024.10 +ha_iot_class: Cloud Polling +ha_codeowners: + - '@hunterjm' +ha_domain: duke_energy +ha_config_flow: true +ha_integration_type: integration +--- + +The **Duke Energy** {% term integration %} allows you to get energy information from [Duke Energy](https://www.duke-energy.com/). + +## Supported devices + +Currently, this integration only supports electric meters. + +## Prerequisites + +You need a Duke Energy account to use this integration. During installation of the integration, you will need the username and password to access your account. + +{% include integrations/config_flow.md %} + +## Energy + +Because Duke Energy only releases usage data with around a 48-hour delay, the integration inserts data into statistic objects. +You can find the statistics in {% my developer_statistics title="**Developer Tools** > **Statistics**"%} and search for "duke_energy". +**This delay means that there will be no data in the energy dashboard for today and likely yesterday** (depending on time of day you are checking). + +At the initial setup, the integration pulls historical hourly usage since the account activation. Duke Energy typically only keeps this data for the past 3 years. +After the initial setup, the integration keeps pulling data (twice per day) for the past 30 days to allow for any corrections in the data. + +In the configuration of the energy dashboard ({% my config_energy title="**Settings** > **Dashboards** > **Energy**" %}): + +1. Select **Add consumption** for the **Electricity grid**. +2. Select **Duke Energy Electric {meter serial number} Consumption** for the **consumed energy**.