# 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
