Victron Energy QuickApp dla FIBARO HC3

Opis

QuickApp umożliwia integrację systemów Victron Energy z kontrolerem FIBARO Home Center 3. Aplikacja pobiera dane z lokalnego VRM Portal ID i tworzy urządzenia monitorujące wszystkie komponenty systemu energetycznego oraz integruje się z Energy Panel HC3.

Funkcje

• Real-time monitoring wszystkich urządzeń Victron (falowniki, baterie, ładowarki)
• Pełna integracja z Energy Panel - automatyczne śledzenie produkcji i zużycia energii
• Automatyczne tworzenie urządzeń podrzędnych dla każdego komponentu systemu
• Szczegółowe dane energetyczne - moc chwilowa, energia skumulowana, SOC baterii
• Obsługa systemów wielofazowych - oddzielne monitorowanie każdej fazy
• Zaawansowana diagnostyka - szczegółowe logi i status połączenia

Wymagania

• FIBARO Home Center 3 z firmware 5.080+
• System Victron Energy z aktywnym VRM Portal
• Dostęp do sieci lokalnej gdzie znajduje się system Victron
• VRM Portal ID systemu

Instalacja

1. Konfiguracja VRM Portal

1. Zaloguj się do VRM Portal
2. Znajdź swój VRM Portal ID (6-cyfrowy kod w ustawieniach instalacji)
3. Upewnij się, że system Victron jest połączony z siecią lokalną

2. Instalacja QuickApp

1. W HC3 przejdź do Ustawienia → Urządzenia → Dodaj urządzenie
2. Wybierz Dodaj urządzenie Z-Wave → QuickApp
3. Skopiuj i wklej kod QuickApp
4. Zapisz urządzenie

3. Konfiguracja zmiennych

Dla połączenia lokalnego z Cerbo GX (zalecane):

• cerbo_ip - adres IP Cerbo GX w sieci lokalnej (np. 192.168.1.100)
• update_interval - interwał odświeżania w sekundach (domyślnie 30)
• use_local_connection - ustaw na true dla połączenia lokalnego

Dla połączenia przez VRM Portal:

• vrm_portal_id - twój VRM Portal ID (6-cyfrowy kod)
• vrm_host - serwer VRM (domyślnie vrmapi.victronenergy.com)
• update_interval - interwał odświeżania w sekundach (domyślnie 30)
• use_local_connection - ustaw na false dla połączenia przez VRM

Konfiguracja Energy Panel

Automatycznie utworzone urządzenia Energy Panel:

• PV Energia (kWh) - skumulowana produkcja energii PV
• Zużycie Energia (kWh) - skumulowane zużycie energii
• PV Moc chwilowa - aktualna moc produkcji PV
• Zużycie Moc chwilowa - aktualna moc zużycia

Konfiguracja w Energy Panel:

1. Przejdź do Energia → Ustawienia panelu → Konfiguracja mierników
2. Wybierz odpowiednie urządzenia:
   • Mierniki produkcji energii: PV Energia (kWh)
   • Mierniki zużycia energii z sieci: Zużycie Energia (kWh)
   • Mierniki mocy chwilowej produkcji: PV Moc chwilowa
   • Mierniki mocy chwilowej zużycia: Zużycie Moc chwilowa
3. Zapisz konfigurację

Utworzone urządzenia

Urządzenia monitorujące (PowerMeter):

• Sieć - moc z/do sieci energetycznej
• Inwerter PV - moc generowana przez panele PV
• Obciążenie AC - całkowite obciążenie AC
• Magazyn - moc ładowania/rozładowania baterii
• Obciążenie krytyczne - obciążenie krytyczne (jeśli dostępne)

Urządzenia Energy Panel (EnergyMeter/PowerMeter):

• PV Energia (kWh) - energia wyprodukowana przez PV
• Zużycie Energia (kWh) - energia zużyta przez instalację
• PV Moc chwilowa - aktualna moc PV
• Zużycie Moc chwilowa - aktualna moc zużycia

Sensory dodatkowe:

• Magazyn SOC - stan naładowania baterii (%)

Parametry konfiguracyjne

Połączenie lokalne (zalecane):

Parametr	Opis	Przykład
cerbo_ip	Adres IP Cerbo GX w sieci lokalnej	192.168.1.100
cerbo_port	Port Modbus TCP	502 (domyślny)
use_local_connection	Tryb połączenia lokalnego	true
update_interval	Interwał aktualizacji (sekundy)	30

Połączenie przez VRM Portal:

Parametr	Opis	Przykład
vrm_portal_id	VRM Portal ID (6 cyfr)	123456
vrm_host	Adres serwera VRM	vrmapi.victronenergy.com
use_local_connection	Tryb połączenia przez VRM	false
update_interval	Interwał aktualizacji (sekundy)	30

Rozwiązywanie problemów

Brak danych z systemu Victron (połączenie lokalne)

• Sprawdź czy Cerbo GX jest dostępny pod podanym IP
• Upewnij się, że Modbus TCP jest włączony w Cerbo GX
• Sprawdź czy HC3 i Cerbo GX są w tej samej sieci
• Przetestuj połączenie: ping [IP_CERBO] z poziomu sieci

Brak danych z systemu Victron (połączenie VRM)

• Sprawdź poprawność VRM Portal ID
• Upewnij się, że system Victron jest online w VRM Portal
• Sprawdź połączenie internetowe HC3

Urządzenia nie pojawiają się w Energy Panel

• Uruchom ponownie QuickApp
• Sprawdź czy urządzenia mają poprawny rateType w właściwościach
• Odczekaj 15 minut na synchronizację Energy Panel

Nieprawidłowe dane energetyczne

• Energy Panel aktualizuje dane co 15 minut
• Sprawdź czy system Victron raportuje prawidłowe dane
• Zresetuj liczniki energii jeśli potrzeba

Problemy z połączeniem lokalnym

• Sprawdź czy Cerbo GX ma stały adres IP
• Upewnij się, że Modbus TCP jest włączony na porcie 502
• Test połączenia: użyj Advanced Port Scanner lub Nmap do sprawdzenia portu 502:
  • nmap -p 502 [IP_CERBO] (Linux/Windows z Nmap)
  • Advanced Port Scanner - skanuj zakres IP i port 502
• Upewnij się, że firewall nie blokuje port 502
• Sprawdź czy VRM Portal jest włączony w Cerbo GX (wymagane dla lokalnego API)

API i integracja

QuickApp automatycznie:

• Pobiera dane z Victron VRM API co 30 sekund
• Aktualizuje wszystkie urządzenia podrzędne
• Kalkuluje energie skumulowane dla Energy Panel
• Loguje status operacji w trybie debug

Wsparcie

• Forum FIBARO: Smart Home Forum
• Victron Community: Victron Community
• VRM Portal: vrm.victronenergy.com

Licencja

MIT License - wolne oprogramowanie dla społeczności

---

Wersja: 1.0 | Kompatybilność: HC3 5.080+ | Autor: @pyziak