# ☀️ 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:

```yaml
✅ 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ą

```yaml
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

```yaml
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

```yaml
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

```yaml
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:

```yaml
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:**
- Solcast Dashboard: https://solcast.com/dashboard
- Dokumentacja: https://github.com/BJReplay/ha-solcast-solar
- Support: https://community.home-assistant.io/

**Wygenerowano:** 2026-02-05  
**Wersja:** 1.0