Newer
Older
homeassistant-infra / docs / SOLCAST_MANUAL_INSTALLATION_GUIDE.md

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:

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 ToolsStates
  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 SettingsAutomations & Scenes
  2. Kliknij + CREATE AUTOMATIONCreate 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 ToolsYAMLRESTART 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


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