/ha-globalomnium

Pruebas DEV Integración lectura Consumo de Agua basandose en la integración de ideenergy integration for home-assistant

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

FORK IN PROGRESS

Hi all, I'm a newbie trying to make my first Home Assistant Custom Component and my first Python work. This repo is a modified fork from ldotlopez/ha-ideenergy but I'm trying to adapt it to get water consumption from GlobalOmnium / Emivasa / Aguas de Valencia.

Global Omnium Custom Integration for Home Assistant

hacs_badge hassfest validation HACS validation

GitHub Release (latest SemVer including pre-releases) CodeQL Code style: black

globalomnium integration for home-assistant

Global Omnium Custom Integration for Home Assistant, providing sensors for Spanish Water Distributor Global Omnium.

⚠️ Make sure to read the 'FAQ', 'Dependencies' and 'Warning' sections

Features

  • Integration with the Home Assistant Energy Panel.

  • Accumulated and Instant consumption sensors.

  • Historical sensors with better precision. This data is not realtime and usually has a 24-hour to 48-hour offset.

  • Support for multiple contracts (service points).

  • Configuration through Home Assistant Interface without the need to edit YAML files.

  • Update algorithm to read the meter near the end of each hourly period (between minute 50 and 59) with a better representation of consumption in the Home Assistant energy panel.

  • Fully asynchronous and integrated with HomeAssistant.

Dependencies

You must have an Global Omnium username and access to the Clients' website. You may register here: Oficina Virtual | Golbal Omnium.

Installation

Using HACS (recommended)

  1. Copy this repository URL: https://github.com/carlos-48/ha-globalomnium/

  2. In the HACS section, add this repository as a custom one:

  • On the "repository" field put the URL copied before

  • On the "Category" select "Integration"

  • Click the "Download" button and download latest version.

    Custom repositorysitory

  1. Restart HA

  2. Configure the integration

  • (Option A) Click the "Add integration" button → Open your Home Assistant instance and start setting up a new integration.

  • (Option B) Go to "Settings" "Devices & Services" and click "+ ADD INTEGRATION" and select "Global Omnium Water Consumption".

  1. Follow the configuration steps: provide your credentials for access to Global Omnium and select the contract that you want to monitor. (Should you need to add more contracts, just follow the previous step as many times as needed).

Manually

  1. Download/clone this repository: https://github.com/carlos-48/ha-globalomnium/

  2. Copy the custom_components/globalomnium folder into your custom_components folder into your HA installation

  3. Restart HA

  4. Configure the integration

  • (Option A) Click on this button → Open your Home Assistant instance and start setting up a new integration.
  • (Option B) Go to "Settings" → "Devices & Services" and click "+ ADD INTEGRATION" and select "Global Omnium Water Consumption".
  1. Follow the configuration steps: provide your credentials for access to Global Omnium and select the contract that you want to monitor. (Should you need to add more contracts, just follow the previous step as many times as needed).

Warnings

This extension provides an 'historical' sensor to incorporate data from the past into Home Assistant database. For your own safety the sensor is not enabled by default and must be enabled manually.

☠️ Historic sensor is based on a high experimental hack and can broke and/or corrupt your database and/or statistics. Use at your own risk.

License

This project is licensed under the GNU General Public License v3.0 License - see the LICENSE file for details

Disclaimer

THIS PROJECT IS NOT IN ANY WAY ASSOCIATED WITH OR RELATED TO THE GLOBAL OMNIUM GROUP COMPANIES OR ANY OTHER. The information here and online is for educational and resource purposes only and therefore the developers do not endorse or condone any inappropriate use of it, and take no legal responsibility for the functionality or security of your devices.