README.md

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

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 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	PayPal Credit card		No fees Single or monthly payment
buycoffee.to	BLIK Bank transfer
PayPal	PayPal		No fees
Revolut	Revolut Credit Card		No fees