106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# Integracja Home Assistant z Pstryk API
|
|
|
|
[](https://github.com/twoj_nick/pstryk-homeassistant)
|
|
|
|
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"
|
|
- ⏰ Automatyczna konwersja czasu UTC → lokalny
|
|
- 🔄 Aktualizacja co 1 minutę po pełnej godzinie
|
|
- 🛡️ Obsługa błędów i logowanie diagnostyczne
|
|
|
|
## Instalacja
|
|
|
|
### Metoda 1: Via HACS
|
|
1. W HACS przejdź do `Integracje`
|
|
2. Kliknij `Dodaj repozytorium`
|
|
3. Wpisz URL: `https://github.com/twoj_nick/pstryk-homeassistant`
|
|
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 |
|
|
| `sensor.pstryk_current_sell_price` | Aktualna cena sprzedaży |
|
|
| `sensor.pstryk_buy_price_table` | Tabela cen kupna |
|
|
| `sensor.pstryk_sell_price_table` | Tabela cen sprzedaży |
|
|
|
|
Przykładowa Automatyzacja:
|
|
|
|
Włączanie bojlera
|
|
|
|
```yaml
|
|
alias: Optymalne grzanie wody
|
|
triggers:
|
|
- minutes: /1
|
|
trigger: time_pattern
|
|
conditions:
|
|
- condition: template
|
|
value_template: >
|
|
{% set current_time = now().strftime('%H:%M') %} {% set best_times =
|
|
state_attr('sensor.pstryk_buy_price_table', 'best_prices')
|
|
| map(attribute='start_local')
|
|
| list
|
|
%} {{ current_time in best_times }}
|
|
actions:
|
|
- choose:
|
|
- conditions:
|
|
- condition: state
|
|
entity_id: switch.bojler
|
|
state: "off"
|
|
sequence:
|
|
- target:
|
|
entity_id: switch.bojler
|
|
action: switch.turn_on
|
|
data: {}
|
|
- data:
|
|
message: >
|
|
Grzanie włączone! Godzina: {{ current_time }}, Cena: {{
|
|
state_attr('sensor.pstryk_buy_price_table', 'best_prices') |
|
|
selectattr('start_local', 'equalto', current_time) |
|
|
map(attribute='price') | first }} PLN
|
|
action: notify.mobile_app
|
|
- conditions:
|
|
- condition: state
|
|
entity_id: switch.bojler
|
|
state: "on"
|
|
sequence:
|
|
- delay: "01:00:00"
|
|
- target:
|
|
entity_id: switch.bojler
|
|
action: switch.turn_off
|
|
data: {}
|
|
|