diff --git a/current-config/SOLCAST_API_KEY.txt b/current-config/SOLCAST_API_KEY.txt new file mode 100644 index 0000000..602676c --- /dev/null +++ b/current-config/SOLCAST_API_KEY.txt @@ -0,0 +1,11 @@ +# Solcast API Key +# Data: 2026-02-05 +# Środowisko: TEST (192.168.50.151) + +API Key: MUqt4gd84T3TrK6bqYWxYWefEDdgzRKF + +Konto: wkonieczny85@gmail.com +Plan: Home PV (FREE) +Limit: 50 zapytań/dzień + +Status: ✅ Gotowy do konfiguracji diff --git a/current-config/SOLCAST_API_KEY.txt b/current-config/SOLCAST_API_KEY.txt new file mode 100644 index 0000000..602676c --- /dev/null +++ b/current-config/SOLCAST_API_KEY.txt @@ -0,0 +1,11 @@ +# Solcast API Key +# Data: 2026-02-05 +# Środowisko: TEST (192.168.50.151) + +API Key: MUqt4gd84T3TrK6bqYWxYWefEDdgzRKF + +Konto: wkonieczny85@gmail.com +Plan: Home PV (FREE) +Limit: 50 zapytań/dzień + +Status: ✅ Gotowy do konfiguracji diff --git a/docs/SOLCAST_MANUAL_INSTALLATION_GUIDE.md b/docs/SOLCAST_MANUAL_INSTALLATION_GUIDE.md new file mode 100644 index 0000000..66b45a1 --- /dev/null +++ b/docs/SOLCAST_MANUAL_INSTALLATION_GUIDE.md @@ -0,0 +1,189 @@ +# Solcast - Instrukcja instalacji ręcznej w Home Assistant TEST + +**Data:** 2026-02-05 +**Środowisko:** TEST (192.168.50.151:8123) +**API Key:** `MUqt4gd84T3TrK6bqYWxYWefEDdgzRKF` +**Token HA:** `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJlMWYzZDdiMGFhMzc0MmE0OWY3OGRlMTgyODU1NjUyZSIsImlhdCI6MTc3MDI0NjQ0NywiZXhwIjoyMDg1NjA2NDQ3fQ.UMnT7bC-MMeByJGx9D10igjMLZujLQeniAdmS5rbBNo` + +--- + +## Krok 1: Zaloguj się do Home Assistant TEST + +1. Otwórz przeglądarkę: **http://192.168.50.151:8123** +2. Login: **WK** +3. Hasło: **QWer!@34** + +--- + +## Krok 2: Otwórz HACS + +1. W menu po lewej stronie kliknij **HACS** +2. Jeśli nie ma HACS: + - Zainstaluj HACS: https://hacs.xyz/docs/setup/download + - Restart Home Assistant + +--- + +## Krok 3: Zainstaluj integrację Solcast PV Forecast + +1. W HACS kliknij **Integrations** +2. Kliknij **+ EXPLORE & DOWNLOAD REPOSITORIES** (prawy dolny róg) +3. Wyszukaj: **Solcast PV Forecast** +4. Wybierz: **Solcast PV Forecast** by **BJReplay** +5. Kliknij **Download** +6. Wybierz najnowszą wersję (np. v4.0.35) +7. Kliknij **Download** +8. **RESTART Home Assistant** (Settings → System → Restart) +9. Poczekaj 1-2 minuty aż HA się zrestartuje + +--- + +## Krok 4: Dodaj integrację Solcast + +1. Przejdź do **Settings** (Ustawienia) +2. Kliknij **Devices & Services** (Urządzenia i usługi) +3. Kliknij **+ ADD INTEGRATION** (prawy dolny róg) +4. Wyszukaj: **Solcast** +5. Wybierz **Solcast PV Forecast** + +--- + +## Krok 5: Skonfiguruj API Key + +W oknie konfiguracji wprowadź: + +``` +API Key: MUqt4gd84T3TrK6bqYWxYWefEDdgzRKF +``` + +Kliknij **Submit** (Zatwierdź) + +--- + +## Krok 6: Weryfikacja instalacji + +### Sprawdź sensory + +1. Przejdź do **Developer Tools** → **States** +2. Szukaj sensorów: + - `sensor.solcast_pv_forecast_forecast_today` + - `sensor.solcast_pv_forecast_forecast_tomorrow` + - `sensor.solcast_pv_forecast_forecast_day_3` + - `sensor.solcast_pv_forecast_forecast_day_4` + - `sensor.solcast_pv_forecast_forecast_day_5` + - `sensor.solcast_pv_forecast_forecast_day_6` + - `sensor.solcast_pv_forecast_forecast_day_7` + +### Sprawdź wartości + +Sensory powinny pokazywać prognozy w **kWh**: +- Zima: 1-5 kWh/dzień +- Wiosna/Jesień: 10-18 kWh/dzień +- Lato: 22-32 kWh/dzień + +**UWAGA:** Pierwsze dane pojawią się po 5-10 minutach! + +--- + +## Krok 7: Dodaj automatyzacje + +### Metoda A: Przez UI (łatwiejsza) + +1. Przejdź do **Settings** → **Automations & Scenes** +2. Kliknij **+ CREATE AUTOMATION** → **Create new automation** +3. Ręcznie wprowadź każdą automatyzację z pliku `solcast_automations_zarki.yaml` + +### Metoda B: Edycja pliku (szybsza) + +Jeśli masz dostęp do File Editor (addon): + +1. Otwórz plik `/config/automations.yaml` +2. Skopiuj zawartość z pliku: + `~/homeassistant-infra/ha-configs/solcast_automations_zarki.yaml` +3. Wklej na końcu pliku `automations.yaml` +4. Zapisz plik +5. **Developer Tools** → **YAML** → **RESTART Automations** + +--- + +## Automatyzacje które będą działały + +### 1. **Raport poranny (07:00)** +- Wyśle notyfikację z prognozą na dziś +- Zalecane ładowanie baterii + +### 2. **Bardzo pochmurno (<3 kWh) → ładuj do 95%** +- Aktywacja o 22:00 +- Maksymalne ładowanie z sieci + +### 3. **Pochmurno (3-6 kWh) → ładuj do 80%** +- Częściowe ładowanie + +### 4. **Średnio (6-13 kWh) → ładuj do 60%** +- Minimalne ładowanie + +### 5. **Dobre warunki (13-20 kWh) → nie ładuj** +- Tylko z PV + +### 6. **Słonecznie (>20 kWh) → nie ładuj** +- Tylko z PV + +### 7. **Raport wieczorny (23:00)** +- Porównanie prognoza vs rzeczywista produkcja +- Dokładność Solcast + +--- + +## Rozwiązywanie problemów + +### Problem: Sensory nie pojawiają się + +**Rozwiązanie:** +1. Sprawdź w HACS czy integracja jest zainstalowana +2. Sprawdź czy zrobiłeś restart HA po instalacji +3. Sprawdź logi: Settings → System → Logs + +### Problem: Sensory pokazują "unavailable" + +**Rozwiązanie:** +1. Sprawdź API Key (czy dobrze przepisany) +2. Sprawdź limit wywołań API (50/dzień) +3. Poczekaj 5-10 minut na pierwszą aktualizację + +### Problem: Wartości wydają się nieprawidłowe + +**Rozwiązanie:** +1. Sprawdź czy w Solcast dodałeś instalację z poprawnymi parametrami: + - Capacity: 5.0 kWp + - Tilt: 35° + - Azimuth: 180° + - Location: Żarki (50.7861°N, 19.4228°E) + +--- + +## Następne kroki + +Po weryfikacji na TEST (minimum 1-2 dni): + +1. ✅ Sprawdź czy prognozy są sensowne +2. ✅ Sprawdź czy automatyzacje działają +3. ✅ Porównaj prognozy z rzeczywistą produkcją +4. 🚀 Deploy na PROD (192.168.50.242) + +--- + +## Kontakt i wsparcie + +- Dokumentacja Solcast: https://solcast.com/ +- HACS Solcast: https://github.com/BJReplay/ha-solcast-solar +- Forum HA: https://community.home-assistant.io/ + +--- + +## Notatki + +- API Key zapisany w: `~/homeassistant-infra/current-config/SOLCAST_API_KEY.txt` +- Automatyzacje w: `~/homeassistant-infra/ha-configs/solcast_automations_zarki.yaml` +- Parametry instalacji: `~/homeassistant-infra/current-config/SOLCAST_INSTALLATION_PARAMS.md` + +**Status:** ⏳ Oczekuje na instalację manualną przez użytkownika