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 not 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 |
password |
string |
True |
- | Password used to login at eLicznik |
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 |
---|
HACS (recommended)
Using- 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
positions. -
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 | Link | Comment |
---|---|---|---|
Ko-fi |
|
|
|
buycoffee.to |
|
||
PayPal |
|
|
|
Revolut |
|
|