--- title: "Alfen Eve Wallbox" description: "Stacje ładowania Alfen Eve Single i Double (platforma NG9xx) zintegrowane z TapHome przez Modbus TCP." url: "https://taphome.com/pl/compatibility/alfen-box/" language: pl lastmod: 2026-03-28 generator: hugo ai: topics: ["modbus-tcp","wallbox","ev-charger","ethernet","active-load-balancing"] questions: ["Jak zintegrować wallbox Alfen Eve z TapHome?","Co monitoruje szablon Alfen Box w TapHome?","Jak podłączyć ładowarkę Alfen Eve przez Modbus TCP do TapHome?","Jak włączyć Modbus TCP na wallboxie Alfen Eve?","Jakie jest wymaganie licencyjne Active Load Balancing dla Alfen Modbus?","Jak sterować prądem ładowania Alfen Eve przez Modbus?"] --- # Alfen Eve Wallbox Komunikacja: Modbus TCP - [Oficjalna strona Alfen](https://alfen.com/charging-equipment) > Adres w sieci > > TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres. > > [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/) ## Poradnik integracji Seria Alfen Eve (Eve Single S-line, Eve Single Pro-line, Eve Double Pro-line) to komercyjne i domowe stacje ładowania pojazdów elektrycznych zbudowane na platformie NG9xx. TapHome łączy się z wallboxem przez Modbus TCP po Ethernecie na porcie 502. Aktualny szablon monitoruje wewnętrzną temperaturę płyty i udostępnia atrybuty identyfikacyjne ładowarki (nazwa produktu, nazwa stacji, liczba gniazd). Mapa rejestrów Modbus Alfen zapewnia rozbudowane rejestry per-socket do pomiaru energii i sterowania prądem, które mogą zostać dodane w przyszłych aktualizacjach szablonu. ## Połączenie sprzętowe Wallbox posiada przewodowy port Ethernet do łączności sieciowej. Podłącz go do tej samej sieci lokalnej co TapHome Core za pomocą standardowego kabla Ethernet. - **Protokół:** Modbus TCP - **Port:** 502 - **Domyślne Slave ID:** 200 (stacja), 1 (gniazdo 1 / lewe), 2 (gniazdo 2 / prawe) - **Kolejność bajtów:** Mixed-endian — słowa 16-bitowe są big-endian, słowa 32-bitowe są little-endian (low word first) > [!WARNING] > Ładowarka obsługuje maksymalnie **2 jednoczesne połączenia Modbus TCP**. Upewnij się, że żaden inny system (np. Home Assistant, OCPP backend) nie zajmuje obu połączeń, gdy TapHome musi się komunikować. ## Konfiguracja ### Włączanie komunikacji Modbus Modbus TCP nie jest domyślnie włączony na ładowarkach Alfen Eve. Aktywacja wymaga licencji **Active Load Balancing (ALB)** — płatnej funkcji, którą należy zakupić od Alfen. Po aktywacji licencji skonfiguruj Modbus za pomocą aplikacji **ACE Service Installer**: 1. Zaloguj się do ACE Service Installer i wybierz stację ładowania 2. Przejdź do **Load Balancing** (ikona wagi) 3. Wybierz **Active balancing** i zaznacz **Active Load Balancing** 4. Ustaw Data Source na **Energy Management System** — to aktywuje rolę serwera Modbus 5. W Protocol Selection wybierz **Modbus TCP/IP** 6. Ustaw **Maximum smart meter current** (A) i **Safe current** (A) 7. Przejdź do **TCP/IP EMS** w pasku bocznym 8. Ustaw Control mode: **Socket** (dla indywidualnego sterowania gniazdami) lub **SCN** (dla sterowania całą stacją) 9. Włącz **Allow reading** aby umożliwić odczyt rejestrów Modbus 10. Opcjonalnie włącz **Allow writing maximum currents**, jeśli wymagane jest sterowanie prądem | Ustawienie | Opis | Domyślnie | |------------|------|-----------| | Allow reading | Zezwolenie na odczyt rejestrów Modbus przez TCP/IP | OFF | | Allow writing maximum currents | Zezwolenie na zapis rejestrów maksymalnego prądu | OFF | | Valid time | Sekundy przed powrotem do bezpiecznego prądu | 60 s | | IP Address allocation | DHCP lub stały IP | DHCP | | Port | Port Modbus TCP | 502 | > [!WARNING] > Licencja **Active Load Balancing** jest funkcją płatną. Skontaktuj się z Alfen w celu zakupu klucza licencyjnego przed próbą włączenia komunikacji Modbus. Podczas importu szablonu w TapHome podaj: - **IP Address** — adres IP wallboxa w sieci lokalnej - **Slave ID** — 200 (domyślne dla rejestrów na poziomie stacji) ## Możliwości urządzenia Szablon monitoruje wallbox na poziomie stacji (slave address 200): ### Temperatura płyty - **Board Temperature** — odczytuje wewnętrzną temperaturę PCB wallboxa z rejestru H:1102 (Float32, °C). Jest to temperatura płytki drukowanej, a nie temperatura otoczenia. ### Dodatkowe możliwości Platforma Alfen NG9xx udostępnia rozbudowaną mapę rejestrów Modbus wykraczającą poza zakres aktualnego szablonu. Rejestry per-socket (slave address 1 lub 2) zapewniają pomiary energii w czasie rzeczywistym, w tym napięcie, prąd i moc (czynna, pozorna, bierna) na fazę, współczynnik mocy, częstotliwość oraz skumulowaną energię dostarczoną i zużytą. Rejestry stanu gniazda udostępniają dostępność, stan ładowania IEC 61851 Mode 3 oraz zapisywalny setpoint maksymalnego prądu z konfigurowalnym czasem ważności — umożliwiając dynamiczne zarządzanie obciążeniem. Rejestry na poziomie stacji dostarczają również czas pracy, liczbę uruchomień i identyfikację platformy. Te możliwości mogą zostać dodane w przyszłej aktualizacji szablonu. > [!TIP] > W przypadku ładowarek dwugniazdowych (Eve Double Pro-line) gniazdo 1 (lewe) używa slave address 1, a gniazdo 2 (prawe) slave address 2. Każde gniazdo ma własny niezależny zestaw rejestrów pomiarowych i sterujących. ## Rozwiązywanie problemów ### Brak komunikacji Modbus 1. Sprawdź, czy licencja Active Load Balancing jest aktywna na ładowarce 2. Potwierdź, że **Allow reading** jest włączone w ACE Service Installer w sekcji TCP/IP EMS 3. Upewnij się, że wallbox i TapHome Core są w tej samej sieci/podsieci 4. Sprawdź, czy żaden firewall nie blokuje portu 502 5. Sprawdź, czy slave ID się zgadza (domyślne: 200 dla rejestrów stacji) 6. Upewnij się, że nie jest podłączonych więcej niż 2 klientów Modbus TCP jednocześnie ### Wartości rejestrów zwracają NaN Ładowarki wyposażone w mierniki Reallin (produkcja po 2021 r.) zwracają NaN dla niektórych rejestrów zagregowanych: Current Sum, Apparent Power Sum, Reactive Power Sum i Real Energy Consumed Sum. Rejestry per-fazowe działają prawidłowo. Jest to ograniczenie sprzętowe miernika Reallin, a nie problem konfiguracyjny. ### Setpoint maksymalnego prądu nie jest stosowany Zapisane wartości maksymalnego prądu mają limit czasu ważności (domyślnie 60 sekund). Wartość musi być okresowo nadpisywana przed wygaśnięciem, w przeciwnym razie ładowarka powraca do skonfigurowanego bezpiecznego prądu. Sprawdź ustawienie validity time w ACE Service Installer. ## Dostępne urządzenia 1 Te urządzenia pojawią się w TapHome po imporcie. Alfen Box Moduł Atrybuty serwisowe | | | |---------------|----------------------------------------------------| | Nazwa | Identyfikator nazwy produktu ładowarki | | Nazwa stacji | Nazwa stacji przypisana do wallboxa | | Liczba gniazd | Liczba gniazd ładowania dostępnych w tym wallboxie | Atrybuty serwisowe Name ```taphome MODBUSR(H, 100, String, 6) ``` STN Name ```taphome MODBUSR(H, 1400, String, 4) ``` Number of sockets ```taphome MODBUSR(H, 1105, Uint16); ``` Temperatura płyty Czujnik temperatury Tylko do odczytu Wewnętrzna temperatura PCB wallboxa — nie temperatura otoczenia Rejestr: H:1102 Float Jednostka: °C Odczyt temperatury ```taphome MODBUSR(H, 1102, Float, 2) ``` **Połączenie:** Modbus TCP • Slave ID: $\[SlaveId] • Hostname: `ACE-{SERIAL}.local` Możliwe ulepszenia (11) - H:1100 Uptime — UInt64 (4 words), seconds since last boot - H:1101 Bootups — UInt32 (2 words), number of boot cycles - H:1104 Max Current — Float (2 words), max current per wallbox in A - H:1106 Platform Type — String, hardware platform identifier - H:300 Socket 1 — Real Energy Delivered — Float (2 words), kWh, available on socket slave ID 1 - H:306 Socket 1 — Meter State — UInt16, socket state enum (e.g. 0=Available, 1=Cable connected, 2=Charging) - H:308 Socket 1 — Active Power Total — Float (2 words), W, real-time charging power - H:320 Socket 1 — Voltage L1/L2/L3 — Float (2 words each), V, per-phase voltage on socket slave ID 1 - H:326 Socket 1 — Current L1/L2/L3 — Float (2 words each), A, per-phase current on socket slave ID 1 - H:1210 Max Current Valid Time — UInt16, seconds, R/W — timeout for max current setting - H:1200 Socket 1 — Max Current — Float (2 words), A, R/W — dynamic current limit per socket ## Parametry importu Te wartości podajesz podczas importu pliku XML. | Pytanie w aplikacji | Domyślnie | |---------------------|---------------| | Slave ID | `200` | | Adres IP | `192.168.1.0` | ## Źródła - Alfen Modbus for ACE — Configuration Guide [alfen.com](https://alfen.com/media/1047/download) 2026-03-28 [PDF](https://taphome.com/compatibility/devices/alfen-box/manufacturer/modbus-slave-tcpip.pdf) - Alfen Eve Pro — HA Community Modbus TCP Thread [community.home-assistant.io](https://community.home-assistant.io/t/alfen-eve-pro-ev-chargepoint-interface-via-tcp-modbus/346000) 2026-03-28 Dokumenty producentów są © ich właścicieli. Udostępniamy je w formie opublikowanej przez producenta, wyłącznie w celach informacyjnych. ## Powiązana dokumentacja - [Modbus Integration](https://taphome.com/pl/compatibility/modbus-guide/) - [Modbus](https://taphome.com/pl/docs/integration/modbus/) - [Prosta konfiguracja za pomocą szablonów](https://taphome.com/pl/docs/integration/modbus/templates/) - [Skrypty Modbus i prefetch](https://taphome.com/pl/docs/script/modbus-scripts/) - [Funkcje Modbus](https://taphome.com/pl/docs/script/modbus/) - [Typy danych Modbus](https://taphome.com/pl/docs/script/modbus-data-types/)