158 lines
4.8 KiB
Markdown
158 lines
4.8 KiB
Markdown
# Integracja Home Assistant z Pstryk API
|
|
|
|
[](https://github.com/balgerion/ha_Pstryk/)
|
|
|
|
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
|
|
- ⚙️ Konfigurowalna liczba "najlepszych godzin"
|
|
- 🔻 Konfigurowalna liczba "najgorszych godzin"
|
|
- 🕒 Cena w następnej godzinie
|
|
- 🕰️ Automatyczna konwersja czasu UTC → lokalny
|
|
- 🔄 Dane są aktualizowane minutę po pełnej godzinie
|
|
- 🛡️ Debug i logowanie
|
|
- 🧩 Konfiguracja z poziomu integracji
|
|
- 🔑 Walidacja klucza API / Cache danych / Zabezpieczenie przed timeoutem API
|
|
- 📡 Integracja wystawia po lokalnym MQTT dane dla EVCC
|
|
|
|
|
|
## TODO
|
|
-
|
|
Taryfy dla Victron MQTT
|
|
## 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
|
|
|
|
|
|
```yaml
|
|
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:
|
|
```yaml
|
|
currency: PLN
|
|
grid:
|
|
type: custom
|
|
forecast:
|
|
source: mqtt
|
|
topic: energy/forecast/buy
|
|
|
|
feedin:
|
|
type: custom
|
|
forecast:
|
|
source: mqtt
|
|
topic: energy/forecast/sell
|
|
```
|