From 41d8700786fe07a6c86817685123a359eda82119 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Tue, 31 Mar 2026 01:21:00 -0600 Subject: [PATCH 01/10] Initial documentation for new CentriConnect component --- source/_integrations/centriconnect.markdown | 166 ++++++++++++++++++++ 1 file changed, 166 insertions(+) create mode 100644 source/_integrations/centriconnect.markdown diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown new file mode 100644 index 000000000000..1463d3b1de30 --- /dev/null +++ b/source/_integrations/centriconnect.markdown @@ -0,0 +1,166 @@ +--- +title: CentriConnect/MyPropane +description: Instructions on how to integrate CentriConnect/MyPropane monitors into Home Assistant. +ha_category: + - Energy + - Sensor +ha_release: 2025.5 +ha_iot_class: Cloud Polling +ha_config_flow: true +ha_codeowners: + - '@gresrun' +ha_domain: centriconnect +ha_platforms: + - diagnostics + - sensor +ha_integration_type: device +ha_quality_scale: bronze +related: + - url: https://developers.home-assistant.io/docs/documenting/standards + title: Documentation standard + - url: https://developers.home-assistant.io/docs/core/integration-quality-scale/rules/ + title: Integration Quality Scale - Rules + - docs: /docs/glossary/ + title: Glossary + - docs: /docs/tools/quick-search/#my-links + title: My link +--- + +**CentriConnect/MyPropane** {% term integration %} allows you to monitor the level and status of propane tanks equiped with [centriconnect.com](https://www.centriconnect.com/) monitoring devices from within Home Assistant and setup automations based on the information. + +## Supported devices + +The following devices are known to be supported by the integration: + +- MyPropane Tank Monitor (Above Ground) +- MyPropane Tank Monitor (Under Ground) + +## Prerequisites + +To use this integration, you need to register your tank monitor with CentriConnect and create an account + +1. Make note of the full "Device ID" and "Device Authentication Code" printed on the setup card +1. Download the the **MyPropane** app and connect by scanning the QR code on the back of your tank monitor. +1. Follow the steps to create an account and register the device. +1. Select "Account" from the main menu +1. Copy or write down your "User ID" + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Device ID: + description: "The unique identifer for your tank monitor. You can find it on the back of the device or on the setup card." +Device Authorization Code: + description: "The secret authorization code for the device. It is only located on the setup card." +User ID: + description: "The unique identifier for your CentriConnect/MyPropane account. You can find it in the Account settings in the app." +{% endconfiguration_basic %} + +## Supported functionality + +The **CentriConnect/MyPropane** integration provides the following entities: + +### Sensors + +- **Alert Status** + - **Description**: The alert status of the tank level with respect to the configured alert levels. + - **Possible Values**: 'No Alert', 'Low Level', 'Critical Level' + - **Remarks**: Alert levels are configured in the app and when the tank level falls below those levels this value is updated. + +- **Altitude** + - **Description**: Current altitude of the device in meters above sea level. + - **Remarks**: Disabled by default. + +- **Battery Level** + - **Description**: Current battery percentage of the device. + - **Remarks**: Battery is charged by the solar panel, if the battery is low, check to make sure the solar panel is clean and the device is oriented towards the sun. + +- **Battery Voltage** + - **Description**: Current battery voltage in volts + - **Remarks**: Disabled by default. Usually between 3.5V and 4.05V. + +- **Device Temperature** + - **Description**: Current temperature measured by the device in °F + - **Remarks**: Disabled by default. Not particularly useful as a thermometer since the value updates 2-3 times per day. + +- **Last Post Time** + - **Description**: Timestamp of the last device update + - **Remarks**: Disabled by default. + +- **Latitude** + - **Description**: Latitude of the GPS coordinate of the device + - **Remarks**: Disabled by default. + +- **Longitude** + - **Description**: Longitude of the GPS coordinate of the device + - **Remarks**: Disabled by default. + +- **LTE Signal Level** + - **Description**: Current cellular signal level as a percentage + - **Remarks**: - + +- **LTE Signal Strength** + - **Description**: Current cellular signal strength in dBm + - **Remarks**: Disabled by default. Usually between -140 dBm and -70 dBm. + +- **Next Post Time** + - **Description**: Timestamp of the estimated next device update + - **Remarks**: Disabled by default. + +- **Solar Level** + - **Description**: Current solar power level as a percentage + - **Remarks**: - + +- **Solar Voltage** + - **Description**: Current solar power in volts + - **Remarks**: Disabled by default. Usually between 0V and 2.86V. + +- **Tank Level** + - **Description**: Current tank level as a percentage + - **Remarks**: This is the sensor you're looking for. + +- **Tank Remaining Volume** + - **Description**: Estimated remaining volume of fluid/gas in the tank + - **Remarks**: Tank Level x Tank Size. The units of this sensor reflect the units provided for the tank size during device registration. + +- **Tank Size** + - **Description**: The volume of the tank. Provided during device registration. + - **Remarks**: The units of this sensor reflect the units provided during device registration. + +## Examples + +### Display the current tank lavel as a gauge + +The example below uses the common [gauge card](/dashboards/gauge/) in the {% term frontend %} to show the tank level with colored severity bands. + +```yaml +type: gauge +entity: sensor.my_propane_tank_level +name: Tank Level +unit: '%' +needle: true +severity: + green: 30 + yellow: 15 + red: 0 +``` + +## Data updates + +The **CentriConnect/MyPropane** integration {% term polling polls %} data from the API every 6 hours. + +## Known limitations + +The tank monitor only provides new data 2-3 times a day so more frequent polling is not configurable. + +This integration exposes all the data provided in the API but not all data about the tank configuration shown in the app is exposed in the API. + +## Troubleshooting + +Before reporting an issue, enable [debug logging](/docs/configuration/troubleshooting/#debug-logs-and-diagnostics) and restart the integration. +As soon as the issue re-occurs, stop the debug logging again (_a download of the debug log file will start automatically_). +Additionally, download the {% term diagnostics %} data. Once you have collected the debug log and the diagnostics data, include them in the issue report. + +## Remove the integration + +{% include integrations/remove_device_service.md %} From ee18024d16ae8b8cd8a3694aba3252356752fcd5 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Tue, 31 Mar 2026 01:36:06 -0600 Subject: [PATCH 02/10] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/centriconnect.markdown | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index 1463d3b1de30..de3c801e7b0a 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -26,7 +26,7 @@ related: title: My link --- -**CentriConnect/MyPropane** {% term integration %} allows you to monitor the level and status of propane tanks equiped with [centriconnect.com](https://www.centriconnect.com/) monitoring devices from within Home Assistant and setup automations based on the information. +**CentriConnect/MyPropane** {% term integration %} allows you to monitor the level and status of propane tanks equipped with [centriconnect.com](https://www.centriconnect.com/) monitoring devices from within Home Assistant and setup automations based on the information. ## Supported devices @@ -37,19 +37,19 @@ The following devices are known to be supported by the integration: ## Prerequisites -To use this integration, you need to register your tank monitor with CentriConnect and create an account +To use this integration, you need to register your tank monitor with CentriConnect and create an account. -1. Make note of the full "Device ID" and "Device Authentication Code" printed on the setup card +1. Make note of the full "Device ID" and "Device Authentication Code" printed on the setup card. 1. Download the the **MyPropane** app and connect by scanning the QR code on the back of your tank monitor. 1. Follow the steps to create an account and register the device. -1. Select "Account" from the main menu -1. Copy or write down your "User ID" +1. Select "Account" from the main menu. +1. Copy or write down your "User ID". {% include integrations/config_flow.md %} {% configuration_basic %} Device ID: - description: "The unique identifer for your tank monitor. You can find it on the back of the device or on the setup card." + description: "The unique identifier for your tank monitor. You can find it on the back of the device or on the setup card." Device Authorization Code: description: "The secret authorization code for the device. It is only located on the setup card." User ID: @@ -129,7 +129,7 @@ The **CentriConnect/MyPropane** integration provides the following entities: ## Examples -### Display the current tank lavel as a gauge +### Display the current tank level as a gauge The example below uses the common [gauge card](/dashboards/gauge/) in the {% term frontend %} to show the tank level with colored severity bands. From d17dfe3721d4355486e63db0f62f009b7b99d1c8 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Tue, 31 Mar 2026 01:37:03 -0600 Subject: [PATCH 03/10] Update section title from 'Remove' to 'Removing' --- source/_integrations/centriconnect.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index de3c801e7b0a..33857de9d3af 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -161,6 +161,6 @@ Before reporting an issue, enable [debug logging](/docs/configuration/troublesho As soon as the issue re-occurs, stop the debug logging again (_a download of the debug log file will start automatically_). Additionally, download the {% term diagnostics %} data. Once you have collected the debug log and the diagnostics data, include them in the issue report. -## Remove the integration +## Removing the integration {% include integrations/remove_device_service.md %} From 7509a20d4a5e76aa65210bc9a900ba019f2af0e1 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Tue, 31 Mar 2026 01:37:12 -0600 Subject: [PATCH 04/10] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/centriconnect.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index 33857de9d3af..abbec845dc8e 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -40,7 +40,7 @@ The following devices are known to be supported by the integration: To use this integration, you need to register your tank monitor with CentriConnect and create an account. 1. Make note of the full "Device ID" and "Device Authentication Code" printed on the setup card. -1. Download the the **MyPropane** app and connect by scanning the QR code on the back of your tank monitor. +1. Download the **MyPropane** app and connect by scanning the QR code on the back of your tank monitor. 1. Follow the steps to create an account and register the device. 1. Select "Account" from the main menu. 1. Copy or write down your "User ID". From 054e9ffb266c5a3ba81ed85f44f168acaabe5499 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Thu, 2 Apr 2026 22:51:57 -0600 Subject: [PATCH 05/10] Remove boilerplate links from centriconnect.markdown Removed boilerplate related documentation links from CentriConnect integration markdown. --- source/_integrations/centriconnect.markdown | 9 --------- 1 file changed, 9 deletions(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index abbec845dc8e..693656d5d9a2 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -15,15 +15,6 @@ ha_platforms: - sensor ha_integration_type: device ha_quality_scale: bronze -related: - - url: https://developers.home-assistant.io/docs/documenting/standards - title: Documentation standard - - url: https://developers.home-assistant.io/docs/core/integration-quality-scale/rules/ - title: Integration Quality Scale - Rules - - docs: /docs/glossary/ - title: Glossary - - docs: /docs/tools/quick-search/#my-links - title: My link --- **CentriConnect/MyPropane** {% term integration %} allows you to monitor the level and status of propane tanks equipped with [centriconnect.com](https://www.centriconnect.com/) monitoring devices from within Home Assistant and setup automations based on the information. From f36e1195bbcef6699ed16c537bcac6923e77b5c1 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Mon, 11 May 2026 22:55:34 -0700 Subject: [PATCH 06/10] Update release number Apply suggestion from @joostlek Co-authored-by: Joost Lekkerkerker --- source/_integrations/centriconnect.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index 693656d5d9a2..22280baa312b 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -4,7 +4,7 @@ description: Instructions on how to integrate CentriConnect/MyPropane monitors i ha_category: - Energy - Sensor -ha_release: 2025.5 +ha_release: 2026.6 ha_iot_class: Cloud Polling ha_config_flow: true ha_codeowners: From f581ae15951829f0d159b71e8e12a6150a93fbc2 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Mon, 11 May 2026 22:57:14 -0700 Subject: [PATCH 07/10] Remove diagnostics platform and update grammar in intro --- source/_integrations/centriconnect.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index 22280baa312b..2e3247866baf 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -11,13 +11,12 @@ ha_codeowners: - '@gresrun' ha_domain: centriconnect ha_platforms: - - diagnostics - sensor ha_integration_type: device ha_quality_scale: bronze --- -**CentriConnect/MyPropane** {% term integration %} allows you to monitor the level and status of propane tanks equipped with [centriconnect.com](https://www.centriconnect.com/) monitoring devices from within Home Assistant and setup automations based on the information. +**CentriConnect/MyPropane** {% term integration %} allows you to monitor the level and status of propane tanks equipped with [centriconnect.com](https://www.centriconnect.com/) monitoring devices from within Home Assistant. You can then set up automations based on that information. ## Supported devices From 2c7b39bfe5f961252820163effd51b7f066aacc6 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Mon, 11 May 2026 22:59:10 -0700 Subject: [PATCH 08/10] Use Device Authentication Code consistently --- source/_integrations/centriconnect.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index 2e3247866baf..86b15f9ef045 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -40,8 +40,8 @@ To use this integration, you need to register your tank monitor with CentriConne {% configuration_basic %} Device ID: description: "The unique identifier for your tank monitor. You can find it on the back of the device or on the setup card." -Device Authorization Code: - description: "The secret authorization code for the device. It is only located on the setup card." +Device Authentication Code: + description: "The secret authentication code for the device. It is only located on the setup card." User ID: description: "The unique identifier for your CentriConnect/MyPropane account. You can find it in the Account settings in the app." {% endconfiguration_basic %} From 6ccd943738582948e503e0c18ad2ad0bae8074aa Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Mon, 11 May 2026 23:02:33 -0700 Subject: [PATCH 09/10] Improve formatting and remove unused device metrics Updated formatting for clarity and removed unnecessary sections. --- source/_integrations/centriconnect.markdown | 28 +++++---------------- 1 file changed, 6 insertions(+), 22 deletions(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index 86b15f9ef045..c18d130e8311 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -29,11 +29,11 @@ The following devices are known to be supported by the integration: To use this integration, you need to register your tank monitor with CentriConnect and create an account. -1. Make note of the full "Device ID" and "Device Authentication Code" printed on the setup card. +1. Make note of the full **Device ID** and **Device Authentication Code** printed on the setup card. 1. Download the **MyPropane** app and connect by scanning the QR code on the back of your tank monitor. 1. Follow the steps to create an account and register the device. -1. Select "Account" from the main menu. -1. Copy or write down your "User ID". +1. Select **Account** from the main menu. +1. Copy or write down your **User ID**. {% include integrations/config_flow.md %} @@ -61,7 +61,7 @@ The **CentriConnect/MyPropane** integration provides the following entities: - **Description**: Current altitude of the device in meters above sea level. - **Remarks**: Disabled by default. -- **Battery Level** +- **Battery** - **Description**: Current battery percentage of the device. - **Remarks**: Battery is charged by the solar panel, if the battery is low, check to make sure the solar panel is clean and the device is oriented towards the sun. @@ -73,18 +73,6 @@ The **CentriConnect/MyPropane** integration provides the following entities: - **Description**: Current temperature measured by the device in °F - **Remarks**: Disabled by default. Not particularly useful as a thermometer since the value updates 2-3 times per day. -- **Last Post Time** - - **Description**: Timestamp of the last device update - - **Remarks**: Disabled by default. - -- **Latitude** - - **Description**: Latitude of the GPS coordinate of the device - - **Remarks**: Disabled by default. - -- **Longitude** - - **Description**: Longitude of the GPS coordinate of the device - - **Remarks**: Disabled by default. - - **LTE Signal Level** - **Description**: Current cellular signal level as a percentage - **Remarks**: - @@ -93,10 +81,6 @@ The **CentriConnect/MyPropane** integration provides the following entities: - **Description**: Current cellular signal strength in dBm - **Remarks**: Disabled by default. Usually between -140 dBm and -70 dBm. -- **Next Post Time** - - **Description**: Timestamp of the estimated next device update - - **Remarks**: Disabled by default. - - **Solar Level** - **Description**: Current solar power level as a percentage - **Remarks**: - @@ -111,10 +95,10 @@ The **CentriConnect/MyPropane** integration provides the following entities: - **Tank Remaining Volume** - **Description**: Estimated remaining volume of fluid/gas in the tank - - **Remarks**: Tank Level x Tank Size. The units of this sensor reflect the units provided for the tank size during device registration. + - **Remarks**: Tank Level multiplied by Tank Size. The units of this sensor reflect the units provided for the tank size during device registration. - **Tank Size** - - **Description**: The volume of the tank. Provided during device registration. + - **Description**: The total volume of the tank. Provided during device registration. - **Remarks**: The units of this sensor reflect the units provided during device registration. ## Examples From b05fb508e352c70667c5200c14a0f71c6ca360a4 Mon Sep 17 00:00:00 2001 From: Greg Haines Date: Mon, 11 May 2026 23:04:37 -0700 Subject: [PATCH 10/10] s/re-occurs/recurs/ + s/'/" in YAML example --- source/_integrations/centriconnect.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/centriconnect.markdown b/source/_integrations/centriconnect.markdown index c18d130e8311..f8b9818c26ca 100644 --- a/source/_integrations/centriconnect.markdown +++ b/source/_integrations/centriconnect.markdown @@ -111,7 +111,7 @@ The example below uses the common [gauge card](/dashboards/gauge/) in the {% ter type: gauge entity: sensor.my_propane_tank_level name: Tank Level -unit: '%' +unit: "%" needle: true severity: green: 30 @@ -132,7 +132,7 @@ This integration exposes all the data provided in the API but not all data about ## Troubleshooting Before reporting an issue, enable [debug logging](/docs/configuration/troubleshooting/#debug-logs-and-diagnostics) and restart the integration. -As soon as the issue re-occurs, stop the debug logging again (_a download of the debug log file will start automatically_). +As soon as the issue recurs, stop the debug logging again (_a download of the debug log file will start automatically_). Additionally, download the {% term diagnostics %} data. Once you have collected the debug log and the diagnostics data, include them in the issue report. ## Removing the integration