From c54e515851a06c28aa6c56842533b5adc820ccd6 Mon Sep 17 00:00:00 2001 From: tronikos Date: Wed, 29 Mar 2023 15:19:17 -0700 Subject: [PATCH 01/11] Create opower.markdown --- source/_integrations/opower.markdown | 65 ++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 source/_integrations/opower.markdown diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown new file mode 100644 index 000000000000..663809d042bc --- /dev/null +++ b/source/_integrations/opower.markdown @@ -0,0 +1,65 @@ +title: Opower +description: Instructions on how to integrate Opower within Home Assistant. +ha_category: + - Energy + - Sensor +ha_release: 2023.4 +ha_iot_class: Cloud Polling +ha_codeowners: + - '@tronikos' +ha_domain: opower +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: integration +--- + +The Opower integration allows you to get energy information from utilities that use [Opower](https://www.oracle.com/industries/utilities/opower-energy-efficiency/). + +More than 175 utilities use Opower but currently only the following ones are supported: + +- [Pacific Gas and Electric Company (PG&E)](https://www.pge.com/) + +To add this integration to your installation, you will need your login username and password for your utility website. + +{% include integrations/config_flow.md %} + +## Sensors + +The integration adds the following sensors: + +For electricity: + +- Current bill electric usage to date +- Current bill electric cost to date +- Current bill electric forecasted usage +- Current bill electric forecasted cost +- Typical monthly electric usage +- Typical monthly electric cost + +For gas: + +- Current bill gas usage to date +- Current bill gas cost to date +- Current bill gas forecasted usage +- Current bill gas forecasted cost +- Typical monthly gas usage +- Typical monthly gas cost + +## Energy + +Because utilities only release usage/cost data with a 48 hour delay, data is inserted into statistic objects. At the initial setup the integration pulls historical monthly usage/cost since the account activation, daily usage/cost for the past 3 years and for electricity hourly usage/cost for the past 2 months. + +In the configuration of the energy dashboard (Settings > Dashboards > Energy): + +For electricity: + +1. Click on add consumption for the Electricity grid. +2. Select 'Opower {utility name} elec {account number} consumption' for the consumed energy. +3. Select 'Opower {utility name} elec {account number} cost' for the entity with the total costs. + +For gas: + +1. Click on add gas source for the Gas Consumption. +2. Select 'Opower {utility name} gas {account number} consumption' for the gas usage. +3. Select 'Opower {utility name} gas {account number} cost' for the entity with the total costs. From f28693a68de35c18ba65872fffc5050f5b85ab48 Mon Sep 17 00:00:00 2001 From: tronikos Date: Wed, 29 Mar 2023 15:26:08 -0700 Subject: [PATCH 02/11] Update opower.markdown --- source/_integrations/opower.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index 663809d042bc..ab1664f8403f 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -1,9 +1,10 @@ +--- title: Opower description: Instructions on how to integrate Opower within Home Assistant. ha_category: - Energy - Sensor -ha_release: 2023.4 +ha_release: 2023.5 ha_iot_class: Cloud Polling ha_codeowners: - '@tronikos' From 09a4f2255f7186af285106d6a6a0ba9fc6876bd9 Mon Sep 17 00:00:00 2001 From: tronikos Date: Wed, 29 Mar 2023 17:15:28 -0700 Subject: [PATCH 03/11] Update opower.markdown --- source/_integrations/opower.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index ab1664f8403f..c97b219261e8 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -17,7 +17,7 @@ ha_integration_type: integration The Opower integration allows you to get energy information from utilities that use [Opower](https://www.oracle.com/industries/utilities/opower-energy-efficiency/). -More than 175 utilities use Opower but currently only the following ones are supported: +More than 175 utilities use Opower. Currently only the following ones are supported: - [Pacific Gas and Electric Company (PG&E)](https://www.pge.com/) @@ -49,7 +49,7 @@ For gas: ## Energy -Because utilities only release usage/cost data with a 48 hour delay, data is inserted into statistic objects. At the initial setup the integration pulls historical monthly usage/cost since the account activation, daily usage/cost for the past 3 years and for electricity hourly usage/cost for the past 2 months. +Because utilities only release usage/cost data with a 48 hour delay, the integration inserts data into statistic objects. At the initial setup the integration pulls historical monthly usage/cost since the account activation, daily usage/cost for the past 3 years and for electricity hourly usage/cost for the past 2 months. After the initial setup the integration keeps pulling hourly data for electricity and daily data for gas for the past 30 days to allow for any corrections in the data from the utilities. In the configuration of the energy dashboard (Settings > Dashboards > Energy): From 6e1f1b48e3c0340ad4ae677cda5a07ee2fddeff0 Mon Sep 17 00:00:00 2001 From: tronikos Date: Wed, 5 Apr 2023 01:00:29 -0700 Subject: [PATCH 04/11] Update opower.markdown --- source/_integrations/opower.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index c97b219261e8..595f150c08a4 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -33,8 +33,8 @@ For electricity: - Current bill electric usage to date - Current bill electric cost to date -- Current bill electric forecasted usage -- Current bill electric forecasted cost +- Current bill electric forecasted usage (for the first few days of the bill this is 0) +- Current bill electric forecasted cost (for the first few days of the bill this is 0) - Typical monthly electric usage - Typical monthly electric cost @@ -42,8 +42,8 @@ For gas: - Current bill gas usage to date - Current bill gas cost to date -- Current bill gas forecasted usage -- Current bill gas forecasted cost +- Current bill gas forecasted usage (for the first few days of the bill this is 0) +- Current bill gas forecasted cost (for the first few days of the bill this is 0) - Typical monthly gas usage - Typical monthly gas cost From c876735ecb552db7b3e2162ee3d16ec1d337c3ed Mon Sep 17 00:00:00 2001 From: tronikos Date: Thu, 18 May 2023 14:41:52 -0700 Subject: [PATCH 05/11] Update opower.markdown --- source/_integrations/opower.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index 595f150c08a4..ec261c4824bc 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -20,6 +20,7 @@ The Opower integration allows you to get energy information from utilities that More than 175 utilities use Opower. Currently only the following ones are supported: - [Pacific Gas and Electric Company (PG&E)](https://www.pge.com/) +- [Puget Sound Energy (PSE)](https://www.pse.com/) To add this integration to your installation, you will need your login username and password for your utility website. From bd83ec86e058569badce602f0cd8073e20b4e2aa Mon Sep 17 00:00:00 2001 From: tronikos Date: Thu, 18 May 2023 14:42:12 -0700 Subject: [PATCH 06/11] Update opower.markdown --- source/_integrations/opower.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index ec261c4824bc..abb9ee4f6fed 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -4,7 +4,7 @@ description: Instructions on how to integrate Opower within Home Assistant. ha_category: - Energy - Sensor -ha_release: 2023.5 +ha_release: 2023.6 ha_iot_class: Cloud Polling ha_codeowners: - '@tronikos' From 6270944f747bb93164a36d1352832eedcd032b4d Mon Sep 17 00:00:00 2001 From: tronikos Date: Mon, 12 Jun 2023 04:09:43 -0700 Subject: [PATCH 07/11] Update opower.markdown --- source/_integrations/opower.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index abb9ee4f6fed..d0cd581e7441 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -21,6 +21,7 @@ More than 175 utilities use Opower. Currently only the following ones are suppor - [Pacific Gas and Electric Company (PG&E)](https://www.pge.com/) - [Puget Sound Energy (PSE)](https://www.pse.com/) +- [Baltimore Gas and Electric (BGE)](https://www.bge.com/) To add this integration to your installation, you will need your login username and password for your utility website. From 4b09304afa617302d4c3e95cc81f23198d5bbf91 Mon Sep 17 00:00:00 2001 From: tronikos Date: Thu, 15 Jun 2023 00:15:09 -0700 Subject: [PATCH 08/11] Update opower.markdown --- source/_integrations/opower.markdown | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index d0cd581e7441..0c083f491429 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -19,11 +19,17 @@ The Opower integration allows you to get energy information from utilities that More than 175 utilities use Opower. Currently only the following ones are supported: -- [Pacific Gas and Electric Company (PG&E)](https://www.pge.com/) -- [Puget Sound Energy (PSE)](https://www.pse.com/) -- [Baltimore Gas and Electric (BGE)](https://www.bge.com/) - -To add this integration to your installation, you will need your login username and password for your utility website. +- Pacific Gas & Electric (PG&E) +- Puget Sound Energy (PSE) +- Exelon subsidiaries + - Atlantic City Electric + - Baltimore Gas and Electric (BGE) + - Commonwealth Edison (ComEd) + - Delmarva Power + - PECO Energy Company (PECO) + - Potomac Electric Power Company (Pepco) + +To add this integration to your installation, you will need your login username and password for your utility website. Two-factor authentication is not supported. {% include integrations/config_flow.md %} From 3fc8c6753fffa6b2389395b41bc7272d2df1630e Mon Sep 17 00:00:00 2001 From: tronikos Date: Mon, 3 Jul 2023 05:25:56 -0700 Subject: [PATCH 09/11] Update opower.markdown --- source/_integrations/opower.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index 0c083f491429..b6d113d294da 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -4,7 +4,7 @@ description: Instructions on how to integrate Opower within Home Assistant. ha_category: - Energy - Sensor -ha_release: 2023.6 +ha_release: 2023.8 ha_iot_class: Cloud Polling ha_codeowners: - '@tronikos' From 6346d5dfac1e0fbc016cae53470a93a3e558b64a Mon Sep 17 00:00:00 2001 From: tronikos Date: Mon, 3 Jul 2023 23:52:46 -0700 Subject: [PATCH 10/11] Apply suggestions from code review Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/opower.markdown | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index b6d113d294da..b83ebae35b90 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -57,18 +57,18 @@ For gas: ## Energy -Because utilities only release usage/cost data with a 48 hour delay, the integration inserts data into statistic objects. At the initial setup the integration pulls historical monthly usage/cost since the account activation, daily usage/cost for the past 3 years and for electricity hourly usage/cost for the past 2 months. After the initial setup the integration keeps pulling hourly data for electricity and daily data for gas for the past 30 days to allow for any corrections in the data from the utilities. +Because utilities only release usage/cost data with a 48-hour delay, the integration inserts data into statistic objects. At the initial setup, the integration pulls historical monthly usage/cost since the account activation, daily usage/cost for the past 3 years, and for electricity hourly usage/cost for the past 2 months. After the initial setup, the integration keeps pulling hourly data for electricity and daily data for gas for the past 30 days to allow for any corrections in the data from the utilities. -In the configuration of the energy dashboard (Settings > Dashboards > Energy): +In the configuration of the energy dashboard (**{% my energy title="Settings > Dashboards > Energy" %}**): For electricity: -1. Click on add consumption for the Electricity grid. -2. Select 'Opower {utility name} elec {account number} consumption' for the consumed energy. -3. Select 'Opower {utility name} elec {account number} cost' for the entity with the total costs. +1. Select **Add consumption for the Electricity grid**. +2. Select **Opower {utility name} elec {account number} consumption** for the consumed energy. +3. Select **Opower {utility name} elec {account number} cost** for the entity with the total costs. For gas: -1. Click on add gas source for the Gas Consumption. -2. Select 'Opower {utility name} gas {account number} consumption' for the gas usage. -3. Select 'Opower {utility name} gas {account number} cost' for the entity with the total costs. +1. Select **Add gas source for the Gas Consumption**. +2. Select **Opower {utility name} gas {account number} consumption** for the gas usage. +3. Select **Opower {utility name} gas {account number} cost** for the entity with the total costs. From d4efc4ffa549d53158fd2200e732bec87113abec Mon Sep 17 00:00:00 2001 From: tronikos Date: Tue, 4 Jul 2023 00:00:24 -0700 Subject: [PATCH 11/11] Update opower.markdown --- source/_integrations/opower.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/opower.markdown b/source/_integrations/opower.markdown index b83ebae35b90..0ba841916a42 100644 --- a/source/_integrations/opower.markdown +++ b/source/_integrations/opower.markdown @@ -63,12 +63,12 @@ In the configuration of the energy dashboard (**{% my energy title="Settings > D For electricity: -1. Select **Add consumption for the Electricity grid**. -2. Select **Opower {utility name} elec {account number} consumption** for the consumed energy. -3. Select **Opower {utility name} elec {account number} cost** for the entity with the total costs. +1. Select **Add consumption** for the **Electricity grid**. +2. Select **Opower {utility name} elec {account number} consumption** for the **consumed energy**. +3. Select **Opower {utility name} elec {account number} cost** for the **entity with the total costs**. For gas: -1. Select **Add gas source for the Gas Consumption**. -2. Select **Opower {utility name} gas {account number} consumption** for the gas usage. -3. Select **Opower {utility name} gas {account number} cost** for the entity with the total costs. +1. Select **Add gas source** for the **Gas consumption**. +2. Select **Opower {utility name} gas {account number} consumption** for the **gas usage**. +3. Select **Opower {utility name} gas {account number} cost** for the **entity with the total costs**.