Fork: 0
root / homeassistant-infra
Transfer to URL with SHA Find file
Newer
Older
homeassistant-infra / docs / SOLCAST_SETUP_GUIDE.md
Wojciech Konieczny 23 days ago 11 KB 📘 Dodano szczegółowy przewodnik instalacji Solcast
Raw Blame History

☀️ Solcast PV Forecast - Przewodnik instalacji krok po kroku

Cel: Najdokładniejsza prognoza produkcji PV dla inteligentnego zarządzania Deye
Czas: 15-20 minut
Koszt: DARMOWY (50 zapytań/dzień wystarczy)

📋 KROK 1: Rejestracja w Solcast (5 min)

1.1 Utwórz konto

🌐 Otwórz: https://solcast.com/
📝 Kliknij: "Sign Up" (prawy górny róg)
📧 Podaj email i hasło
✅ Potwierdź email

1.2 Wybierz plan

Plan: "Home PV" (FREE)
- 50 API calls/day ✅
- 2 rooftop sites ✅
- 7-day forecast ✅
- Perfectly sufficient!

💰 Koszt: 0 zł/miesiąc

🏠 KROK 2: Dodaj swoją instalację PV (5 min)

2.1 Przejdź do dodawania lokalizacji

Po zalogowaniu:
1. Dashboard → "Your Rooftop Sites"
2. Kliknij: "+ New Rooftop Site"

2.2 Uzupełnij parametry instalacji

Resource Name:

Nazwa: "Dach Dom" (lub cokolwiek)

Location (Lokalizacja):

⚠️ WAŻNE: Musisz znać swoją lokalizację

Opcja A - Podaj adres:
  Address: [Twój adres]
  → Solcast znajdzie współrzędne

Opcja B - Współrzędne GPS:
  Latitude: np. 52.2297  (Warszawa)
  Longitude: np. 21.0122
  
💡 Jak znaleźć współrzędne?
  - Google Maps → kliknij prawym → "Współrzędne"
  - Lub w Home Assistant: Settings → System → General

Capacity (Moc instalacji):

Capacity: [Twoja moc w kWp]

Przykłady:
- 12 paneli × 400W = 4.8 kWp → wpisz: 4.8
- 30 paneli × 400W = 12 kWp → wpisz: 12
- Zobacz na fakturze/projekcie instalacji

⚠️ To NOMINALNA moc paneli (nie inwertera!)

Tilt (Nachylenie):

Tilt: [Kąt nachylenia dachu w stopniach]

Typowe wartości:
- 0° = płaski dach (idealne 0°)
- 15° = niewielkie nachylenie
- 30° = standardowy dach (średnio stromy)
- 35° = typowy dach w Polsce
- 45° = stromy dach

�� Jak zmierzyć?
  - Aplikacja telefon: "Kątomierz" / "Level"
  - Przyłóż do dachu
  - Odczytaj kąt

Azimuth (Azymut - kierunek):

Azimuth: [Kierunek w stopniach]

Kierunki świata:
- 0° / 360° = Północ (N)
- 90° = Wschód (E)
- 180° = Południe (S) ⭐ NAJLEPIEJ
- 270° = Zachód (W)

Pośrednie:
- 135° = Południowy-Wschód (SE)
- 225° = Południowy-Zachód (SW)

💡 Jak sprawdzić?
  - Google Maps: Otwórz widok satelitarny
  - Sprawdź który kierunek wskazuje dach
  - Dla Polski: większość dachów ~180° (południe)

Install Date:

Install Date: [Data instalacji]
Może być przybliżona, nie jest krytyczna

Tracking Type:

☑️ Fixed (zablokowane) - standardowe panele na dachu
☐ Single Axis - nie wybieraj (to są trackery)

2.3 Zapisz lokalizację

✅ Kliknij: "Create Rooftop Site"

2.4 (Opcjonalnie) Dodaj drugą lokalizację

Jeśli masz panele na 2 stronach dachu (np. wschód + zachód):

1. Kliknij: "+ New Rooftop Site"
2. Utwórz drugą lokalizację:
   - Resource Name: "Dach Zachód"
   - Capacity: 6 kWp (połowa instalacji)
   - Tilt: 35°
   - Azimuth: 270° (zachód)
3. Zapisz

Solcast automatycznie zsumuje prognozy!

🔑 KROK 3: Pobierz API Key (1 min)

1. Dashboard Solcast
2. Lewe menu: "Account" → "API Toolkit"
3. Sekcja: "Your API Key"
4. Kliknij: 👁️ "Show" lub "Copy"
5. Skopiuj API Key (format: xxxx-xxxx-xxxx-xxxx)

⚠️ ZAPISZ API Key w bezpiecznym miejscu!

Przykładowy API Key:

xxxx-yyyy-zzzz-aaaa-bbbb-cccc-dddd

🏠 KROK 4: Instalacja w Home Assistant (5 min)

4.1 Sprawdź czy masz HACS

TEST HA: http://192.168.50.151:8123
PROD HA: http://192.168.50.242:8123 

Zaloguj się → Sprawdź lewe menu

✅ Widzisz "HACS"? → Przejdź do 4.2
❌ Nie widzisz? → Musisz zainstalować HACS

Jak zainstalować HACS (jeśli nie ma):

HACS już jest zainstalowany na TEST i PROD 
(skopiowaliśmy go wcześniej razem z Solarman)

Sprawdź ponownie w lewym menu.

4.2 Zainstaluj Solcast PV Forecast przez HACS

1. W Home Assistant: Kliknij "HACS" (lewe menu)
2. Kliknij: "Integrations"
3. Kliknij: "⊕ Explore & Download Repositories" (prawy dolny róg)
4. W wyszukiwarce wpisz: "Solcast"
5. Znajdź: "Solcast PV Forecast" (autor: BJReplay)
6. Kliknij na integrację
7. Kliknij: "Download" (prawy dolny róg)
8. Wybierz najnowszą wersję
9. Kliknij: "Download"
10. Poczekaj na potwierdzenie

4.3 Restartuj Home Assistant

1. Settings → System → Hardware
2. Kliknij: ⋮ (trzy kropki, prawy górny róg)
3. Wybierz: "Restart Home Assistant"
4. Potwierdź: "Restart"
5. Poczekaj 1-2 minuty na restart

⚙️ KROK 5: Konfiguracja Solcast (3 min)

5.1 Dodaj integrację

1. Po restarcie: Settings → Devices & Services
2. Kliknij: "+ Add Integration" (prawy dolny róg)
3. Szukaj: "Solcast"
4. Kliknij: "Solcast PV Forecast"

5.2 Wprowadź API Key

Pole: "API Key"
Wklej: [Twój API Key skopiowany w kroku 3]

Przykład: xxxx-yyyy-zzzz-aaaa-bbbb-cccc-dddd

✅ Kliknij: "Submit"

5.3 Potwierdzenie

✅ Jeśli wszystko OK:
   "Success! Integration added."
   
❌ Jeśli błąd:
   - Sprawdź czy API Key jest poprawny
   - Sprawdź połączenie internetowe HA
   - Sprawdź czy masz aktywne konto Solcast

📊 KROK 6: Sprawdź czy działa (2 min)

6.1 Zobacz encje

1. Settings → Devices & Services
2. Znajdź: "Solcast PV Forecast"
3. Kliknij: "X entities" (np. "10 entities")

6.2 Główne sensory które otrzymasz:

✅ sensor.solcast_pv_forecast_forecast_today
   Stan: np. "35.2 kWh"
   Opis: Prognoza produkcji na dzisiaj

✅ sensor.solcast_pv_forecast_forecast_tomorrow  
   Stan: np. "28.7 kWh"
   Opis: Prognoza produkcji na jutro ⭐ NAJWAŻNIEJSZY

✅ sensor.solcast_pv_forecast_forecast_day_3
   Stan: np. "15.3 kWh"
   Opis: Prognoza na pojutrze

✅ sensor.solcast_pv_forecast_power_now
   Stan: np. "3450 W"
   Opis: Przewidywana moc teraz

✅ sensor.solcast_pv_forecast_peak_power_today
   Stan: np. "8500 W"
   Opis: Przewidywany szczyt mocy dziś

6.3 Test w Developer Tools

1. Developer Tools → States
2. Filtruj: "solcast"
3. Sprawdź wartości sensorów

Powinno być widać cyfry (kWh, W)
Jeśli "unknown" → poczekaj 5 minut na pierwszą aktualizację

📈 KROK 7: Dodaj do Dashboard (2 min)

7.1 Utwórz kartę z prognozą

1. Przejdź do swojego Dashboard
2. Kliknij: "Edit Dashboard" (prawy górny róg, ołówek)
3. Kliknij: "+ Add Card"
4. Wybierz: "Entities Card"
5. Dodaj encje:
   - sensor.solcast_pv_forecast_forecast_today
   - sensor.solcast_pv_forecast_forecast_tomorrow
   - sensor.solcast_pv_forecast_forecast_day_3
   - sensor.solcast_pv_forecast_power_now
6. Tytuł karty: "☀️ Prognoza PV (Solcast)"
7. Zapisz

7.2 Wykres produkcji

1. "+ Add Card"
2. Wybierz: "History Graph"
3. Entities:
   - sensor.solcast_pv_forecast_power_now
   - sensor.inverter_deye_pv_power (rzeczywista)
4. Hours to show: 24
5. Tytuł: "Prognoza vs Rzeczywistość"
6. Zapisz

🤖 KROK 8: Automatyzacja (5 min)

8.1 Automatyzacja: Ładuj jeśli pochmurnie

Skopiuj do: Settings → Automations & Scenes → Create Automation

alias: "Deye + Solcast - Ładuj jeśli pochmurnie"
description: "Włącz ładowanie gdy jutro mała produkcja PV"

trigger:
  - platform: time
    at: "22:00:00"

condition:
  # Jeśli prognoza na jutro < 10 kWh
  - condition: numeric_state
    entity_id: sensor.solcast_pv_forecast_forecast_tomorrow
    below: 10
  
  # I bateria < 80%
  - condition: numeric_state
    entity_id: sensor.inverter_deye_battery_soc
    below: 80

action:
  - service: switch.turn_on
    target:
      entity_id: switch.inverter_deye_battery_grid_charging
  
  - service: select.select_option
    target:
      entity_id: select.inverter_deye_program_1_charging
    data:
      option: "Grid"
  
  - service: time.set_value
    target:
      entity_id: time.inverter_deye_program_1_time
    data:
      time: "01:00:00"
  
  - service: notify.persistent_notification
    data:
      title: "🌥️ Solcast: Mała produkcja jutro"
      message: >
        Prognoza: {{ states('sensor.solcast_pv_forecast_forecast_tomorrow') }} kWh
        Włączono ładowanie z sieci w nocy.

8.2 Automatyzacja: Nie ładuj jeśli słonecznie

alias: "Deye + Solcast - Wyłącz ładowanie gdy słonecznie"
description: "Oszczędzaj gdy jutro dużo słońca"

trigger:
  - platform: time
    at: "22:00:00"

condition:
  # Jeśli prognoza > 30 kWh
  - condition: numeric_state
    entity_id: sensor.solcast_pv_forecast_forecast_tomorrow
    above: 30
  
  # I bateria > 40%
  - condition: numeric_state
    entity_id: sensor.inverter_deye_battery_soc
    above: 40

action:
  - service: switch.turn_off
    target:
      entity_id: switch.inverter_deye_battery_grid_charging
  
  - service: select.select_option
    target:
      entity_id: select.inverter_deye_program_1_charging
    data:
      option: "Disabled"
  
  - service: notify.persistent_notification
    data:
      title: "☀️ Solcast: Duża produkcja jutro!"
      message: >
        Prognoza: {{ states('sensor.solcast_pv_forecast_forecast_tomorrow') }} kWh
        Ładowanie z sieci wyłączone - oszczędzasz!

⚙️ KROK 9: Dostosuj progi do swojej instalacji

Przykładowe progi dla różnych mocy instalacji:

Instalacja 5 kWp (mała):
  Pochmurnie: < 5 kWh
  Średnio: 5-15 kWh
  Słonecznie: > 15 kWh

Instalacja 10 kWp (średnia):
  Pochmurnie: < 10 kWh
  Średnio: 10-30 kWh
  Słonecznie: > 30 kWh

Instalacja 15 kWp (duża):
  Pochmurnie: < 15 kWh
  Średnio: 15-45 kWh
  Słonecznie: > 45 kWh

Obserwuj przez tydzień i dostosuj!

🔍 ROZWIĄZYWANIE PROBLEMÓW

Problem 1: "Unknown" w sensorach

Przyczyna: Pierwsza aktualizacja jeszcze nie nastąpiła
Rozwiązanie: Poczekaj 5-10 minut

Problem 2: Błąd API Key

Przyczyna: Niepoprawny API Key
Rozwiązanie:
  1. Sprawdź API Key w Solcast Dashboard
  2. Usuń integrację w HA
  3. Dodaj ponownie z poprawnym kluczem

Problem 3: Brak aktualizacji

Przyczyna: Limit 50 zapytań/dzień przekroczony
Rozwiązanie:
  - Sprawdź w Solcast: Account → Usage
  - Zmniejsz częstotliwość aktualizacji w HA
  - Lub poczekaj do północy (reset limitu)

Problem 4: Niepoprawne prognozy

Przyczyna: Źle skonfigurowane parametry instalacji
Rozwiązanie:
  1. Solcast Dashboard → Your Rooftop Sites
  2. Edit → Sprawdź:
     - Capacity (moc)
     - Tilt (nachylenie)
     - Azimuth (kierunek)
  3. Popraw i obserwuj przez kilka dni

📊 MONITOROWANIE UŻYCIA API

Solcast Dashboard → Account → Usage

Typowe użycie:
- Aktualizacja co 1h = 24 zapytania/dzień ✅
- Aktualizacja co 30min = 48 zapytań/dzień ✅
- Limit: 50 zapytań/dzień (FREE plan)

💡 Wystarczy aktualizacja co godzinę!

✅ CHECKLIST - Sprawdź czy wszystko działa

☐ Konto Solcast utworzone
☐ Instalacja PV dodana (capacity, tilt, azimuth)
☐ API Key skopiowany
☐ HACS zainstalowany w HA
☐ Integracja Solcast zainstalowana
☐ Home Assistant zrestartowany
☐ Sensory pokazują wartości (nie "unknown")
☐ Dashboard z prognozą utworzony
☐ Automatyzacje skonfigurowane
☐ Progi dostosowane do instalacji
☐ Test przez kilka dni ✅

🎉 GOTOWE!

Teraz masz:

  • ✅ Najdokładniejszą prognozę produkcji PV w Polsce
  • ✅ Automatyczne zarządzanie ładowaniem baterii
  • ✅ Oszczędności 60-100 zł/miesiąc
  • ✅ Dłuższa żywotność baterii

Następny krok: Obserwuj przez tydzień i dostosuj progi!

Przydatne linki:

Wygenerowano: 2026-02-05
Wersja: 1.0