ha_pstryk/README.md

Integracja Home Assistant z Pstryk API

!!! Dedykowana Karta do integracji: https://github.com/balgerion/ha_Pstryk_card

Integracja dla Home Assistant umożliwiająca śledzenie aktualnych cen energii elektrycznej oraz prognoz z platformy Pstryk.

Funkcje

• 🔌 Aktualna cena kupna i sprzedaży energii
• 📅 Tabela 24h z prognozowanymi cenami dla sensora API
• 📆 Tabela 48h z prognozowanymi cenami dla sensora MQTT
• ⚙️ Konfigurowalna liczba "najlepszych godzin"
• 🔻 Konfigurowalna liczba "najgorszych godzin"
• 🕒 Cena w następnej godzinie
• 📉 Średnia cena z pozostałej ilości godzin do końca doby
• 🌅 Średnia cena wschód/zachód
• 🕰️ Automatyczna konwersja czasu UTC → lokalny
• 🔄 Dane są aktualizowane minutę po pełnej godzinie
• 🧩 Konfiguracja z poziomu integracji
• 🔑 Walidacja klucza API / Cache danych / Zabezpieczenie przed timeoutem API
• 📡 Integracja wystawia po lokalnym MQTT tablice cen w natywnym formacie EVCC
• 📊 Średnia zakupu oraz sprzedaży - miesięczna/roczna
• 📈 Bilans miesięczny/roczny
• 🛡️ Debug i logowanie

Instalacja

Metoda 1: Via HACS

1. W HACS przejdź do Integracje
2. Kliknij Dodaj repozytorium
3. Wpisz URL: https://github.com/balgerion/ha_Pstryk
4. Wybierz kategorię: Integration
5. Zainstaluj i zrestartuj Home Assistant

Metoda 2: Ręczna instalacja

1. Utwórz folder custom_components/pstryk w katalogu konfiguracyjnym HA
2. Skopiuj pliki: init.py manifest.json config_flow.py const.py sensor.py logo.png (opcjonalnie)
3. Zrestartuj Home Assistant

Konfiguracja

1. Przejdź do Ustawienia → Urządzenia i usługi
2. Kliknij Dodaj integrację
3. Wyszukaj "Psrryk Energy"
4. Wprowadź dane:

• Klucz API: Twój klucz z platformy Pstryk
• Liczba najlepszych cen kupna: (domyślnie 5)
• Liczba najlepszych cen sprzedaży: (domyślnie 5)

Scrnshoty

Użycie

Dostępne encje

Nazwa encji	Opis
sensor.pstryk_current_buy_price	Aktualna cena kupna + tabela
sensor.pstryk_current_sell_price	Aktualna cena sprzedaży + tabela

Przykładowa Automatyzacja:

Włączanie bojlera

alias: Optymalne grzanie wody
description: ""
triggers:
  - minutes: "1"
    trigger: time_pattern
    hours: /1
conditions:
  - condition: template
    value_template: >
      {% set current_hour = now().replace(minute=0, second=0,
      microsecond=0).isoformat(timespec='seconds').split('+')[0] %}

      {% set best_hours = state_attr('sensor.pstryk_current_buy_price',
      'best_prices') | map(attribute='start') | list %}

      {{ current_hour in best_hours }}
actions:
  - variables:
      current_hour: >-
        {{ now().replace(minute=0, second=0,
        microsecond=0).isoformat(timespec='seconds').split('+')[0] }}
  - choose:
      - conditions:
          - condition: state
            entity_id: light.shellypro3_34987a49142c_switch_2
            state: "off"
        sequence:
          - target:
              entity_id: switch.shellypro3_34987a49142c_switch_2
            action: switch.turn_on
            data: {}
          - data:
              message: |
                Grzanie włączone! Godzina: {{ current_hour }}, Cena: {{
                  state_attr('sensor.pstryk_current_buy_price', 'best_prices')
                  | selectattr('start', 'equalto', current_hour)
                  | map(attribute='price')
                  | first
                }} PLN
            action: notify.mobile_app_balg_iphone
      - conditions:
          - condition: state
            entity_id: light.shellypro3_34987a49142c_switch_2
            state: "on"
        sequence:
          - delay:
              hours: 1
              minutes: 5
          - target:
              entity_id: switch.shellypro3_34987a49142c_switch_2
            action: switch.turn_off
            data: {}

EVCC

Scrnshoty

Konfiguracja

Taryfy:

currency: PLN
grid:
  type: custom
  forecast:
    source: mqtt
    topic: energy/forecast/buy

feedin:
  type: custom
  forecast:
    source: mqtt
    topic: energy/forecast/sell