• Stars
    star
    120
  • Rank 295,983 (Top 6 %)
  • Language
    Python
  • License
    MIT License
  • Created over 5 years ago
  • Updated 11 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

This sensor uses unofficial API to get energy usage and generation data from https://elicznik.tauron-dystrybucja.pl.

HACS Default GitHub Latest Release GitHub All Releases Ko-Fi buycoffee.to PayPal.Me Revolut.Me

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

Open your Home Assistant instance and start setting up a new integration.

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
  • Buy Me a Coffee at ko-fi.com
  • No fees
  • Single or monthly payment
  • buycoffee.to
  • BLIK
  • Bank transfer
  • Postaw mi kawÄ™ na buycoffee.to
    PayPal
  • PayPal
  • PayPal Logo
  • No fees
  • Revolut
  • Revolut
  • Credit Card
  • Revolut
  • No fees
  • More Repositories

    1

    Xiaomi-cloud-tokens-extractor

    This tool/script retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE devices.
    Python
    2,972
    star
    2

    lovelace-xiaomi-vacuum-map-card

    This card provides a user-friendly way to fully control map-based vacuums in Home Assistant. Supported brands include Xiaomi (Roborock/Viomi/Dreame/Roidmi/Valetudo/Valetudo RE), Neato, Wyze, Roomba, Ecovacs (and probably more).
    TypeScript
    1,304
    star
    3

    Home-Assistant-custom-components-Xiaomi-Cloud-Map-Extractor

    This custom integration provides a way to present a live view of a map for Xiaomi (Roborock/Viomi/Roidmi/Dreame) vacuums without a need for rooting.
    Python
    1,077
    star
    4

    Home-Assistant-Taskbar-Menu

    This application is a simple Home Assistant client for Windows. It can display Lovelace views, control entities and show persistent notifications.
    C#
    320
    star
    5

    Home-Assistant-custom-components-Google-Keep

    This sensor uses gkeepapi library to download a list of notes from https://keep.google.com/.
    Python
    65
    star
    6

    Home-Assistant-Lovelace-HTML-Jinja2-Template-card

    This card displays provided Jinja2 template as an HTML content of a card. It uses exactly the same engine as Home Assistant in Developer tools.
    62
    star
    7

    Home-Assistant-Lovelace-Local-Conditional-card

    This card can show and hide a specific card on current device while not affecting other windows. It does not require any integration to run.
    TypeScript
    61
    star
    8

    Home-Assistant-custom-components-Saver

    This custom component allows you to save current state of any entity and use its data later to restore it.
    Python
    59
    star
    9

    lovelace-google-keep-card

    This is a companion card for Google Keep sensor. It displays notes downloaded by integration in a friendly way, similar to Google Keep app.
    52
    star
    10

    lovelace-html-card

    This card displays provided data as an HTML content of a card.
    46
    star
    11

    Home-Assistant-custom-components-Xiaomi-Vacuum-Map-Camera

    Python
    35
    star
    12

    Home-Assistant-custom-components-Burze.dzis.net

    This integration uses official API to get weather warnings for Poland and storm warnings for Europe from https://burze.dzis.net.
    Python
    33
    star
    13

    Home-Assistant-custom-components-Custom-Templates

    This integration adds possibility to use new functions in Home Assistant Jinja2 templating engine.
    Python
    31
    star
    14

    PiotrMachowski

    This repository is used to present a library of my custom elements for Home Assistant.
    27
    star
    15

    Home-Assistant-custom-components-iMPK

    This sensor uses unofficial API retrieved by decompilation of iMPK application to provide a list of MPK Wrocław news available in original app.
    Python
    15
    star
    16

    Home-Assistant-Xiaomi-Vacuum-garage

    This repo contains my configuration responsible for automation of vacuums garage
    14
    star
    17

    Home-Assistant-custom-components-Hydro-IMGW

    This custom integration retrieves data from hydro stations from hydro.imgw.pl.
    Python
    13
    star
    18

    Home-Assistant-custom-components-Antistorm

    This sensor uses official API to get storm warnings from https://antistorm.eu.
    Python
    12
    star
    19

    Home-Assistant-custom-components-MPK-KR

    Python
    11
    star
    20

    Home-Assistant-custom-components-Rozkladzik

    This sensor uses unofficial API to get data from https://www.rozkladzik.pl and provide information about departures for chosen stop.
    Python
    10
    star
    21

    Home-Assistant-picture-elements-Xiaomi-Vacuum-black

    8
    star
    22

    Home-Assistant-Lovelace-Nixie-Clock-Card

    Home Assistant Lovelace Nixie Clock Card
    6
    star
    23

    Home-Assistant-custom-components-MPK-Lodz

    Python
    6
    star
    24

    Home-Assistant-custom-components-Froggy

    This custom integration retrieves opening status of Żabka shops.
    Python
    5
    star
    25

    Home-Assistant-custom-components-Looko2

    This sensor uses official API to get air quality data from https://looko2.com.
    Python
    5
    star
    26

    Home-Assistant-test-components-SmartThings

    Python
    3
    star
    27

    Home-Assistant-custom-components-Dom-5

    This custom integration retrieves data from Dom 5 - housing cooperative management system.
    Python
    3
    star
    28

    Python-package-vacuum-map-parser-base

    Python
    2
    star
    29

    Home-Assistant-custom-components-MPK-Rzeszow

    Python
    2
    star
    30

    Home-Assistant-custom-components-GNE-PV-Monitoring

    This sensor uses official API to get data from GNE
    Python
    2
    star
    31

    Home-Assistant-Lovelace-Nixie-Card

    This card displays a state of an entity using images of nixie tubes
    1
    star