Solar Forecast API – Home Assistant Integrace

Co umí

Vše co potřebujete pro správu FVE

Integrace přináší kompletní přehled solární výroby přímo do Home Assistantu bez závislosti na placených službách.

🌤

Předpověď až 7 dní

Hodinová i 15minutová předpověď výroby na základě Open-Meteo dat a pvlib solárního modelu.

🏠

Až 10 stringů

Konfigurace více samostatných polí – jih, západ, východ. Každý string má vlastní senzory i celkový součet.

⛰

PVGIS horizont

Automatické stínování terénem z databáze PVGIS. Přesné výsledky i v horách nebo u zástavby.

📐

Auto-kalibrace

Zadejte entitu se skutečnou denní výrobou a integrace se automaticky kalibruje na reálné podmínky vašeho systému.

🌡

Předpověď počasí

Teplota, jasnost oblohy, stav počasí, rychlost a směr větru – vše přímo jako HA senzory.

⚡

Časová okna přebytků

Automaticky vypočítaná okna kdy bude přebytek výroby – ideální pro řízení spotřebičů a nabíjení baterií.

🔑

API klíče

Volitelný API klíč odemkne rozšířené funkce: kalibraci, počasí, 15min rozlišení a více dní předpovědi.

🔓

Bez omezení

Žádné denní limity, žádné placené plány. Vlastní server na forecast.xnas.cz.

Senzory

Co uvidíte v Home Assistantu

Integrace vytvoří sadu senzorů automaticky podle vaší konfigurace.

Estimated power production - now

Aktuální odhadovaný výkon

Estimated energy production - today

Celková předpověď dnes

kWh

Estimated energy production - remaining today

Zbývající výroba dnes

kWh

Estimated energy production - next hour

Předpověď příští hodiny

kWh

Estimated energy production - tomorrow

Celková předpověď zítra

kWh

Highest power - today / tomorrow

Maximální výkon dnes / zítra

Peak time - today / tomorrow

Čas maximálního výkonu

datetime

Estimated energy production - day +2 až +6

Předpověď dalších dní (s API klíčem)

kWh

String N Estimated power production - now

Aktuální výkon konkrétního stringu

String N Estimated energy production - today

Předpověď dnes pro konkrétní string

kWh

String N Estimated energy production - tomorrow

Předpověď zítra pro konkrétní string

kWh

String N Highest power - today

Maximální výkon stringu dnes

String N Peak time - today

Čas peaku stringu

datetime

⚠ Per-string senzory se zobrazí pouze při konfiguraci 2 a více stringů.

Weather - Temperature

Aktuální teplota

°C

Weather - Sky clarity

Jasnost oblohy

Weather - Condition

Slovní popis počasí (Partly Cloudy apod.)

text

Weather - Wind speed

Rychlost větru

km/h

Weather - Wind direction

Směr větru (N, NE, ...)

text

⚠ Senzory počasí vyžadují API klíč s funkcí weather.

Horizon - Max elevation

Maximální elevace horizontu z PVGIS (vypnuto ve výchozím stavu)

Senzor Horizon obsahuje v atributech kompletní azimut/elevace profil horizontu.

Instalace

Spustit za 5 minut

Instalace přes HACS je nejjednodušší způsob. Alternativně lze soubory zkopírovat ručně.

Přidat repozitář

V HACS → Custom repositories přidejte URL:
github.com/adasek-dev/solar-forecast-api-ha

Nainstalovat

Vyhledejte „Solar Forecast API" v HACS a klikněte Install. Restartujte Home Assistant.

Přidat integraci

Settings → Devices & Services → Add Integration → Solar Forecast API

Nakonfigurovat

Zadejte počet stringů, sklon, azimut a výkon každého pole. Hotovo.

Konvence

Azimut panelů

Integrace používá forecast.solar konvenci – střed je jih (0°), ne sever.

±180° 0° -90° 90°

S J ☀ V Z

Jih (optimální)	0°
Jihozápad	45°
Západ	90°
Jihovýchod	-45°
Východ	-90°
Sever	±180°

Převod z pvlib/HA konvence (0 = sever):
azimut_fs = azimut_pvlib − 180

API Klíč

Co odemkne API klíč

Bez API klíče integrace funguje v základním režimu: 1 den předpovědi, interval 60 minut. API klíč odemkne rozšířené funkce:

actual Kalibrace přes skutečnou výrobu
calibration Ukládání kalibrační historie
weather Senzory předpovědi počasí
timewindows Časová okna přebytků

S API klíčem dostupné nastavení:

Až 7 dní předpovědi
Interval aktualizace 5, 15, 30, 45 nebo 60 min
Rozlišení 15 nebo 60 minut
Tlumení výkonu ráno/večer (damping)
Vypnutí PVGIS horizontu

Navštívit forecast.xnas.cz →

Předpověď solární výroby ve vašem HA