---
title: "Alfen Eve Single Socket"
description: "Stan ładowania EV, moc i napięcie na fazę, energia i max. prąd przez Modbus TCP. Szablon TapHome dla Alfen Eve Single S-line / Pro-line."
url: "https://taphome.com/pl/compatibility/alfen-socket/"
language: pl
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["modbus-tcp","wallbox","ev-charging","3-phase","ethernet"]
  questions: ["Jak zintegrować wallbox Alfen Eve z TapHome?","Co monitoruje i steruje szablon Alfen Socket w TapHome?","Jak podłączyć Alfen Eve przez Modbus TCP do TapHome?","Jak włączyć Modbus slave na ładowarce Alfen Eve?","Jak sterować prądem ładowania EV za pomocą TapHome i Alfen?","Co to jest stan Mode 3 na ładowarce Alfen Eve?"]
---

# Alfen Eve Single Socket

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

Alfen Eve Single S-line i Pro-line (wariant gniazdkowy) to stacje ładowania EV oparte na platformie NG9xx. TapHome łączy się bezpośrednio z wallboxem przez Modbus TCP po Ethernecie — nie jest wymagana żadna dodatkowa bramka.

Szablon zapewnia wykrywanie stanu ładowania, status połączenia pojazdu, pomiar napięcia i mocy na fazę, śledzenie zużycia energii oraz dynamiczne ograniczanie prądu za pośrednictwem rejestru sterującego Max Current.

## Połączenie sieciowe

Eve Single ma port Ethernet na płycie głównej. Podłącz go do tej samej sieci lokalnej co TapHome Core standardowym kablem Ethernet.

- **Protokół:** Modbus TCP
- **Port:** 502
- **Kolejność bajtów:** Big-endian (sieciowa kolejność bajtów)
- **Adresowanie slave:** 1 dla gniazda 1, 2 dla gniazda 2 (stacje z dwoma gniazdami), 200 dla rejestrów na poziomie stacji

> [!NOTE]
> Szablon TapHome działa na poziomie gniazda (slave ID 1 lub 2). Każde gniazdo na stacji z dwoma gniazdami wymaga własnej instancji urządzenia w TapHome. Dla modeli z jednym gniazdem użyj slave ID 1.

## Konfiguracja

### Włączenie komunikacji Modbus

Funkcja Modbus slave wymaga zakupionej i aktywowanej licencji **Active Load Balancing** na ładowarce. Wymagane jest również konto Service Installer Application (SIA) — poproś o nie na https://support.alfen.com.

1. Otwórz Service Installer Application i połącz się z ładowarką
2. Przejdź do **Active balancing** w lewym menu
3. Włącz pole wyboru **Active Load Balancing**
4. Włącz **"Allow 1- and 3-phased charging"** jeśli potrzebne jest sterowanie przełączaniem faz
5. Wybierz **"Energy Management System"** jako Data Source — konfiguruje to stację jako Modbus slave
6. W lewym menu pojawia się **"TCP/IP EMS"** — Modbus TCP/IP jest domyślnie wybrany
7. Wybierz tryb sterowania:
   - **Socket mode** — sterowanie każdym gniazdem indywidualnie (zalecane dla TapHome)
   - **SCN mode** — sterowanie stacją jako całością

Podczas importu szablonu w TapHome podaj:

- **Adres IP** — IP wallboxa w sieci lokalnej
- **Slave ID** — 1 dla gniazda 1, 2 dla gniazda 2

### Opcje konfiguracji Modbus

| Ustawienie | Funkcja | Domyślne |
|------------|---------|----------|
| Allow reading | Zezwolenie na odczyt rejestrów Modbus przez TCP/IP | Wyłączone |
| Allow writing maximum currents | Zezwolenie na zapis rejestrów maksymalnego prądu | Wyłączone |
| Enable sockets | Uwzględnianie zapisanych wartości maksymalnego prądu | — |
| Validity time | Sekundy przed przejściem na bezpieczny prąd | 60 |
| IP Address allocation | DHCP lub stały IP | DHCP |

> [!WARNING]
> Obie opcje "Allow reading" i "Allow writing maximum currents" muszą być włączone w Service Installer Application, aby szablon działał. Domyślnie są wyłączone.

## Możliwości urządzenia

### Stan ładowania i wykrywanie pojazdu

Dwa czujniki boolowskie wyprowadzone z rejestru stanu IEC 61851 Mode 3 (H:1201):

- **Vehicle Connection** — zwraca true gdy pojazd jest fizycznie podłączony (stany B1, B2, C1, C2, D1, D2), false gdy odłączony (A, E, F).
- **Charge State** — zwraca true gdy pojazd aktywnie się ładuje (stany C2 lub D2), false w przeciwnym razie.

Stan Mode 3 jest zgodny z normą IEC 61851:

| Stan | Pojazd podłączony | Ładowanie | Opis |
|------|-------------------|-----------|------|
| A | Nie | Nie | Brak podłączonego pojazdu |
| B1 / B2 | Tak | Nie | Pojazd podłączony, nie ładuje |
| C1 / C2 | Tak | Tylko C2 | Pojazd żąda ładowania (C2 = PWM aktywne, ładuje) |
| D1 / D2 | Tak | Tylko D2 | Pojazd z żądaniem wentylacji |
| E | Nie | Nie | Zwarcie (CP-PE) |
| F | Nie | Nie | Błąd stacji ładowania |

Urządzenie Charge State udostępnia również **atrybut usługi** "Number of charging phases" (H:1215) pokazujący, czy pojazd aktualnie ładuje na 1 czy 3 fazach, oraz **akcję usługi** "Charging phases" do przełączania między trybem ładowania jednofazowego i trójfazowego.

### Monitorowanie napięcia

Trójfazowe czujniki napięcia faza-neutral:

- **Voltage Phase L1-N** — odczytuje H:306 (BigEndianFloat)
- **Voltage Phase L2-N** — odczytuje H:308 (BigEndianFloat)
- **Voltage Phase L3-N** — odczytuje H:310 (BigEndianFloat)

Wszystkie trzy raportują napięcie w woltach z 15-sekundowym interwałem odpytywania.

### Pomiar mocy

- **Real Power Sum** — całkowita moc czynna wszystkich faz, przeliczona z W na kW. Zawiera **atrybuty usługi** z rozbiciem na fazy: Phase L1 (H:338), Phase L2 (H:340), Phase L3 (H:342), każdy w kW.
- **Frequency** — częstotliwość sieci w Hz z rejestru H:336.

### Pomiar energii

- **Real Energy Delivered** — skumulowana energia dostarczona do pojazdu (H:374, Float64), przeliczona z Wh na kWh. Suma wszystkich faz.
- **Real Energy Consumed** — skumulowana energia zużyta przez gniazdo (H:390, Float64), przeliczona z Wh na kWh. Suma wszystkich faz.

### Atrybuty i akcje na poziomie modułu

Moduł udostępnia kilka **atrybutów usługi** widocznych w widoku szczegółowym urządzenia:

| Atrybut | Opis |
|---------|------|
| Meter Type | Typ komunikacji licznika (RTU, TCP/IP, UDP, P1) |
| State | Flagi stanu licznika — Initialised, Updated, Warning, Error |
| Mode 3 State | Surowy ciąg stanu IEC 61851 Mode 3 (A, B1, B2, C1, C2, D1, D2, E, F) |
| Max Current | Aktualnie stosowany maksymalny prąd ładowania w amperach |
| Active Load Balancing Safe Current | Wartość prądu awaryjnego po wygaśnięciu ważności max. prądu |

Moduł udostępnia również **akcję usługi** "Max Current" do zapisu maksymalnego limitu prądu ładowania (6–16 A) do rejestru H:1210. Zapisana wartość musi być odnawiana w ramach skonfigurowanego limitu czasu ważności (domyślnie 60 sekund), w przeciwnym razie stacja przechodzi na bezpieczną wartość prądu.

> [!WARNING]
> Wartość max. prądu **nie jest zachowywana** po restarcie. Po zaniku zasilania stacja przechodzi na bezpieczny prąd do momentu zapisania nowej wartości przez Modbus.

### Dodatkowe możliwości

Alfen Eve udostępnia dodatkowe rejestry Modbus dla napięć międzyfazowych, prądów fazowych i prądu sumarycznego, współczynnika mocy, mocy pozornej, mocy biernej i rozbicia energii na fazy. Rejestry na poziomie stacji (slave 200) dostarczają temperaturę płyty, stan OCPP, zagregowane zużycie Smart Charging Network (SCN) i sterowanie max. prądem na fazę. Mogą one zostać dodane do szablonu TapHome w przyszłej aktualizacji.

## Rozwiązywanie problemów

### Brak komunikacji Modbus

1. Sprawdź, czy kabel Ethernet jest podłączony i ładowarka jest w tej samej sieci co TapHome Core
2. Potwierdź, że licencja Active Load Balancing jest aktywowana
3. Sprawdź, czy "Allow reading" jest włączone w Service Installer Application
4. Potwierdź prawidłowe slave ID — użyj 1 dla gniazda 1 (nie 200, to adres na poziomie stacji)
5. Upewnij się, że zapora sieciowa nie blokuje portu 502
6. Ładowarka obsługuje maksymalnie 2 jednoczesne połączenia Modbus TCP — sprawdź, czy żaden inny system nie wykorzystuje obu slotów

### Max. prąd nie jest stosowany

1. Sprawdź, czy "Allow writing maximum currents" jest włączone w Service Installer Application
2. Sprawdź, czy bezpieczny prąd jest skonfigurowany (musi być ustawiony przed sterowaniem max. prądem przez Modbus)
3. Upewnij się, że wartość prądu jest odnawiana przed upływem limitu czasu ważności (domyślnie 60 sekund)
4. Sprawdź rejestr H:1214 (Setpoint accounted for) — wartość 1 potwierdza, że zapisany prąd został zastosowany

### Przełączanie faz nie działa

Upewnij się, że "Allow 1- and 3-phased charging" jest włączone w ustawieniach Active Load Balancing w Service Installer Application. To ustawienie jest wymagane, aby akcja usługi przełączania faz działała.

### Zalecenie dotyczące firmware

Zalecana jest wersja firmware **6.4.0-4210 lub nowsza**. Wcześniejsze wersje mają błąd, w którym budżet mocy resetuje się do 0 A, gdy żaden samochód nie jest ładowany.

## Dostępne urządzenia 9

Te urządzenia pojawią się w TapHome po imporcie.

Alfen Socket Moduł

Atrybuty serwisowe

|                                       |                                                                                                                        |
|---------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| Typ licznika                          | Typ komunikacji licznika — RTU, TCP/IP, UDP lub P1                                                                     |
| Stan                                  | Flagi stanu licznika — Initialised, Updated, Warning, Error                                                            |
| Stan Mode 3                           | Stan ładowania IEC 61851 Mode 3 — A (odłączony), B1/B2 (podłączony), C1/C2 (ładowanie), D1/D2 (wentylacja), E/F (błąd) |
| Max. prąd                             | Aktualnie stosowany maksymalny prąd ładowania w amperach                                                               |
| Active Load Balancing bezpieczny prąd | Wartość prądu awaryjnego po wygaśnięciu ważności max. prądu                                                            |

Akcje serwisowe

|           |                                                                                                             |
|-----------|-------------------------------------------------------------------------------------------------------------|
| Max. prąd | Ustawienie maksymalnego limitu prądu ładowania (6–16 A) — musi być odnawiane w ramach limitu czasu ważności |

Odczyt (moduł)

```taphome
#warning
IF(GETBIT(MODBUSR(H, 300, Uint16), 2)=1, ADDWARNING("Meter in warning state"));
#error
IF(GETBIT(MODBUSR(H, 300, Uint16), 3)=1, ADDError("Meter in error"));
IF(MODBUSR(H, 1201, String, 5)="F", ADDError("Charging error"));
```

Atrybuty serwisowe

Meter Type

```taphome
SWITCH(MODBUSR(H, 305, Uint16),
 0, "RTU",
 1, "TCP/IP",
 2, "UDP",
 3, "P1",
 "Other");
```

State

```taphome
var reg := MODBUSR(H, 300, Uint16);
var string := 
IF(GETBIT(reg, 0) = 1, "Initialised ", "") +
IF(GETBIT(reg, 1) = 1, "Updated ", "") +
IF(GETBIT(reg, 2) = 1, "Warning ", "") +
IF(GETBIT(reg, 3) = 1, "Error", "");
```

Mode 3 State

```taphome
MODBUSR(H, 1201, String, 5);
```

Max Current

```taphome
MODBUSR(H, 1210, Float, 2) + " A"
```

Active Load Balancing Safe Current

```taphome
MODBUSR(H, 1212, Float, 2) + " A"
```

Akcje serwisowe

Max Current

Parametry: Max Current \[A] (6–16 cur)

```taphome
MODBUSW(H, 1210, Float, cur, 2)
```

Częstotliwość Zmienna Tylko do odczytu

Rejestr: H:336 Float Jednostka: Hz

Odczyt

```taphome
MODBUSR(H, 336, Float, 2)
```

Stan ładowania Kontakt reed Tylko do odczytu

Wykrywanie aktywnego ładowania — true gdy pojazd pobiera energię (stany Mode 3 C2 lub D2)

Rejestr: H:1201 String switch-map

Atrybuty serwisowe

|                      |                                                       |
|----------------------|-------------------------------------------------------|
| Liczba faz ładowania | Liczba faz aktualnie używanych do ładowania (1 lub 3) |

Akcje serwisowe

|                |                                                                   |
|----------------|-------------------------------------------------------------------|
| Fazy ładowania | Przełączanie między trybem ładowania jednofazowego i trójfazowego |

Odczyt

```taphome
SWITCH(MODBUSR(H, 1201, String, 5),
"A", false,
"B1", false,
"B2", false,
"C1", false,
"C2", true,
"D1", false,
"D2", true,
"E", false,
"F", false,
Nan)
```

Atrybuty serwisowe

Number of charging phases

```taphome
MODBUSR(H, 1215, Uint16);
```

Akcje serwisowe

Charging phases

Parametry: Charging Phases

```taphome
MODBUSW(H, 1215, Uint16, chrg);
```

Zużyta energia Zmienna Tylko do odczytu

Skumulowana energia zużyta przez gniazdo ze wszystkich faz (kWh)

Rejestr: H:390 Float Jednostka: kWh

Odczyt

```taphome
MODBUSR(H, 390, Float, 4)/1000;
```

Dostarczona energia Zmienna Tylko do odczytu

Skumulowana energia dostarczona do pojazdu ze wszystkich faz (kWh)

Rejestr: H:374 Float Jednostka: kWh

Odczyt

```taphome
MODBUSR(H, 374, Float, 4)/1000
```

Całkowita moc czynna Zmienna Tylko do odczytu

Całkowita moc czynna wszystkich faz (kW) z rozbiciem na fazy w atrybutach usługi

Rejestr: H:344 Float Jednostka: kW

Atrybuty serwisowe

|         |
|---------|
| Faza L1 |
| Faza L2 |
| Faza L3 |

Odczyt

```taphome
MODBUSR(H, 344, Float, 2)/1000
```

Atrybuty serwisowe

Phase L1

```taphome
MODBUSR(H, 338, Float, 2)/1000 + " kW";
```

Phase L2

```taphome
MODBUSR(H, 340, Float, 2)/1000 + " kW";
```

Phase L3

```taphome
MODBUSR(H, 342, Float, 2)/1000 + " kW";
```

Połączenie pojazdu Kontakt reed Tylko do odczytu

Wykrywanie wtyczki — true gdy kabel EV jest podłączony (stany Mode 3 B1/B2/C1/C2/D1/D2)

Rejestr: H:1201 String switch-map

Odczyt

```taphome
SWITCH(MODBUSR(H, 1201, String, 5),
"A", false,
"B1", true,
"B2", true,
"C1", true,
"C2", true,
"D1", true,
"D2", true,
"E", false,
"F", false,
Nan)
```

Napięcie faza L1-N Zmienna Tylko do odczytu

Rejestr: H:306 BigEndianFloat Jednostka: V

Odczyt

```taphome
MODBUSR(H, 306, BigEndianFloat, 2)
```

Napięcie faza L2-N Zmienna Tylko do odczytu

Rejestr: H:308 BigEndianFloat Jednostka: V

Odczyt

```taphome
MODBUSR(H, 308, BigEndianFloat, 2)
```

Napięcie faza L3-N Zmienna Tylko do odczytu

Rejestr: H:310 BigEndianFloat Jednostka: V

Odczyt

```taphome
MODBUSR(H, 310, BigEndianFloat, 2)
```

**Połączenie:** Modbus TCP • Slave ID: $\[SlaveId] • Hostname: `ACE-{SERIAL}.local`

Możliwe ulepszenia (18)

- H:312 Voltage L1-L2 — Float32 (2 words), V, line-to-line voltage
- H:314 Voltage L2-L3 — Float32 (2 words), V, line-to-line voltage
- H:316 Voltage L3-L1 — Float32 (2 words), V, line-to-line voltage
- H:318 Current N — Float32 (2 words), A, neutral current
- H:320 Current L1 — Float32 (2 words), A, phase L1 current
- H:322 Current L2 — Float32 (2 words), A, phase L2 current
- H:324 Current L3 — Float32 (2 words), A, phase L3 current
- H:326 Current Sum — Float32 (2 words), A, total current
- H:328 Power Factor L1/L2/L3/Sum — Float32 (2 words each), 4 registers at H:328-335
- H:346 Apparent Power L1/L2/L3/Sum — Float32 (2 words each), VA, 4 registers at H:346-353
- H:354 Reactive Power L1/L2/L3/Sum — Float32 (2 words each), VAr, 4 registers at H:354-361
- H:362 Real Energy Delivered per-phase (L1/L2/L3) — Float64 (4 words each), Wh, per-phase breakdown (template only has sum)
- H:378 Real Energy Consumed per-phase (L1/L2/L3) — Float64 (4 words each), Wh, per-phase breakdown (template only has sum)
- H:394 Apparent Energy L1/L2/L3/Sum — Float64 (4 words each), VAh, 4 registers at H:394-409
- H:410 Reactive Energy L1/L2/L3/Sum — Float64 (4 words each), VArh, 4 registers at H:410-425
- H:1200 Availability — Uint16, 1=Operative
- H:1206 Actual Applied Max Current — Float32 (2 words), A, currently applied current after ALB calculation
- H:1208 Modbus Slave Max Current Valid Time — Uint32, seconds, remaining validity of written max current

## Parametry importu

Te wartości podajesz podczas importu pliku XML.

| Pytanie w aplikacji | Domyślnie     |
|---------------------|---------------|
| Slave ID            | `1`           |
| Adres IP            | `192.168.1.0` |

## Źródła

- Alfen Modbus Slave TCP/IP — Register Mapping v2.3
  
  [alfresco.alfen.com](https://alfresco.alfen.com/share/s/MF_z6vSJT7y6M0dPOBrOyA) 2026-03-29
  
  [PDF](https://taphome.com/compatibility/devices/alfen-socket/manufacturer/modbus-register-mapping.pdf)
- nessnaj/alfen\_eve\_modbus\_tcp — Python Register Map
  
  [github.com](https://github.com/nessnaj/alfen_eve_modbus_tcp) 2026-03-29
- 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-29

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/)