Tauron AMIplus sensor

This sensor uses unofficial API to get energy usage and generation data from TAURON eLicznik.

Configuration

Config flow (recommended)

To configure this integration go to: Configuration -> Integrations -> Add integration -> Tauron AMIplus.

You can also use following My Home Assistant link:

Manual - yaml

Warning: yaml configuration is no longer recommended

**Warning:** Not all features are available when using yaml configuration | Key | Type | Required | Default | Description | |-----------------------|----------|----------|------------------|--------------------------------------------------------------------------------| | `name` | `string` | `False` | `Tauron AMIPlus` | Name of sensor | | `username` | `string` | `True` | - | Username used to login at [*eLicznik*](https://elicznik.tauron-dystrybucja.pl) | | `password` | `string` | `True` | - | Password used to login at [*eLicznik*](https://elicznik.tauron-dystrybucja.pl) | | `energy_meter_id` | `string` | `True` | - | ID of energy meter | | `monitored_variables` | `list` | `True` | - | List of variables to monitor | #### Possible monitored conditions | Key | Description | |------------------------------|--------------------------------------------------| | `consumption_reading` | Current consumption reading of a meter | | `consumption_daily` | Daily energy consumption **(for previous day!)** | | `consumption_monthly` | Monthly energy consumption | | `consumption_yearly` | Yearly energy consumption | | `consumption_last_12_months` | Total energy consumption for last 12 months | | `generation_reading` | Current generation reading of a meter | | `generation_daily` | Daily energy generation **(for previous day!)** | | `generation_monthly` | Monthly energy generation | | `generation_yearly` | Yearly energy generation | | `generation_last_12_months` | Total energy generation for last 12 months | | `balanced_daily` | Daily balance **(for previous day!)** | | `balanced_monthly` | Monthly balance | | `balanced_yearly` | Yearly balance | | `balanced_last_12_months` | Balance for last 12 months | #### Example usage ``` sensor: - platform: tauron_amiplus name: Tauron AMIPlus username: !secret tauron_amiplus.username password: !secret tauron_amiplus.password energy_meter_id: !secret tauron_amiplus.energy_meter_id monitored_variables: - consumption_reading - consumption_daily - consumption_monthly - consumption_yearly - consumption_last_12_months - generation_reading - generation_daily - generation_monthly - generation_yearly - generation_last_12_months - balanced_daily - balanced_monthly - balanced_yearly - balanced_last_12_months ```

Installation

Since v2.3.0 this integration requires Home Assistant version 2022.12 or latter

Since v2.4.8 this integration might cause slow starts of Home Assistant

Using HACS (recommended)

In Integrations section add repository "Tauron AMIplus"
Install added repository

Manual

Download tauron_amiplus.zip and extract its contents to config/custom_components/tauron_amiplus directory:

mkdir -p custom_components/tauron_amiplus
cd custom_components/tauron_amiplus
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-Tauron-AMIplus/releases/latest/download/tauron_amiplus.zip
unzip tauron_amiplus.zip
rm tauron_amiplus.zip

Then restart Home Assistant before applying configuration file changes.

FAQ

How to display hourly data in Energy dashboard?

To show hourly data in Energy dashboard you have to use tauron_importer statistics instead of entities.
Why there are missing days in statistics/Energy dashboard?

Such gaps appear when there are missing values in hourly readings for this day. You can confirm it using eLicznik website.
How to fix missing data in statistics/Energy dashboard?

Once the data appears on eLicznik website can fill such gaps using tauron_amiplus.download_statistics service.
When does this integration update data?

This integration logs in and downloads data from eLicznik website every 8.5h. This timer is restarted after: HA restart, integration reload, configuration change. Additionally, a new pack of data is freshly downloaded when user retrieves diagnostics data.
How to get energy meter id?

To find out value for energy_meter_id follow these steps.

How to calculate available energy as a prosument?

To calculate available energy you can use following config:

input_number:
initial_energy_bank:
  min: 0
  max: 100000000
  step: 1
  mode: box
template:
- sensor:
    - name: Tauron energy bank
      state_class: total
      device_class: energy
      unique_id: tauron_energy_bank
      icon: mdi:home-battery-outline
      state: "{{ (states('input_number.initial_energy_bank') | float(0) + states('sensor.tauron_amiplus_123_yearly_energy_generation') | float(0) * 0.8 - states('sensor.tauron_amiplus_123_yearly_energy_consumption') | float(0)) | round(3) }}"
      unit_of_measurement: "kWh"
      availability: "{{ states('sensor.tauron_amiplus_123_yearly_energy_generation') | is_number and states('sensor.tauron_amiplus_123_yearly_energy_consumption') | is_number }}"

Support

If you want to support my work with a donation you can use one of the following platforms:

Platform	Payment methods	Comment
Ko-fi	PayPal Credit card	No fees Single or monthly payment
buycoffee.to	BLIK Bank transfer
PayPal	PayPal	No fees
Revolut	Revolut Credit Card	No fees

PiotrMachowski / Home-Assistant-custom-components-Tauron-AMIplus

readme