--- title: "Alfen Eve Single Socket" description: "EV-Ladestatus, phasenweise Leistung und Spannung, Energie und Max-Strom über Modbus TCP. TapHome-Vorlage für Alfen Eve Single S-line / Pro-line." url: "https://taphome.com/de/compatibility/alfen-socket/" language: de lastmod: 2026-03-29 generator: hugo ai: topics: ["modbus-tcp","wallbox","ev-charging","3-phase","ethernet"] questions: ["Wie integriert man eine Alfen Eve Wallbox mit TapHome?","Was überwacht und steuert die Alfen-Socket-TapHome-Vorlage?","Wie verbindet man Alfen Eve über Modbus TCP mit TapHome?","Wie aktiviert man den Modbus-Slave auf dem Alfen Eve Ladegerät?","Wie steuert man den EV-Ladestrom mit TapHome und Alfen?","Was ist der Mode 3 Status beim Alfen Eve Ladegerät?"] --- # Alfen Eve Single Socket Kommunikation: Modbus TCP - [Offizielle Alfen-Website](https://alfen.com/charging-equipment) > Netzwerkadresse > > TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert. > > [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/) ## Integrationsanleitung Die Alfen Eve Single S-line und Pro-line (Steckdosen-Variante) sind EV-Ladestationen basierend auf der NG9xx-Plattform. TapHome verbindet sich direkt mit der Wallbox über Modbus TCP per Ethernet — kein zusätzliches Gateway erforderlich. Die Vorlage bietet Ladestatus-Erkennung, Fahrzeugverbindungsstatus, phasenweise Spannungs- und Leistungsmessung, Energieverbrauchserfassung und dynamische Strombegrenzung über das Max Current Steuerregister. ## Netzwerkverbindung Die Eve Single hat einen Ethernet-Port auf der Hauptplatine. Verbinden Sie diese mit dem gleichen lokalen Netzwerk wie TapHome Core über ein Standard-Ethernet-Kabel. - **Protokoll:** Modbus TCP - **Port:** 502 - **Byte-Reihenfolge:** Big-Endian (Netzwerk-Byte-Reihenfolge) - **Slave-Adressierung:** 1 für Steckdose 1, 2 für Steckdose 2 (Doppelsteckdosen-Stationen), 200 für Register auf Stationsebene > [!NOTE] > Die TapHome-Vorlage arbeitet auf Steckdosenebene (Slave-ID 1 oder 2). Jede Steckdose einer Doppelsteckdosen-Station erfordert eine eigene Geräteinstanz in TapHome. Für Modelle mit einer Steckdose verwenden Sie Slave-ID 1. ## Konfiguration ### Modbus-Kommunikation aktivieren Die Modbus-Slave-Funktion erfordert eine erworbene und aktivierte **Active Load Balancing**-Lizenz auf dem Ladegerät. Außerdem ist ein Service Installer Application (SIA) Konto erforderlich — beantragen Sie dieses unter https://support.alfen.com. 1. Öffnen Sie die Service Installer Application und verbinden Sie sich mit dem Ladegerät 2. Navigieren Sie zu **Active balancing** im linken Menü 3. Aktivieren Sie die Checkbox **Active Load Balancing** 4. Aktivieren Sie **"Allow 1- and 3-phased charging"** wenn Phasenumschaltung benötigt wird 5. Wählen Sie **"Energy Management System"** als Data Source — dies konfiguriert die Station als Modbus-Slave 6. **"TCP/IP EMS"** erscheint im linken Menü — Modbus TCP/IP ist standardmäßig ausgewählt 7. Wählen Sie den Steuermodus: - **Socket mode** — jede Steckdose einzeln steuern (empfohlen für TapHome) - **SCN mode** — die Station als Ganzes steuern Beim Import der Vorlage in TapHome geben Sie an: - **IP-Adresse** — die Wallbox-IP im lokalen Netzwerk - **Slave-ID** — 1 für Steckdose 1, 2 für Steckdose 2 ### Modbus-Konfigurationsoptionen | Einstellung | Funktion | Standard | |-------------|----------|----------| | Allow reading | Lesen von Modbus-Registern über TCP/IP erlauben | Aus | | Allow writing maximum currents | Schreiben der Max-Strom-Register erlauben | Aus | | Enable sockets | Geschriebene Max-Strom-Werte berücksichtigen | — | | Validity time | Sekunden vor Rückfall auf sicheren Strom | 60 | | IP Address allocation | DHCP oder feste IP | DHCP | > [!WARNING] > Beide Optionen "Allow reading" und "Allow writing maximum currents" müssen in der Service Installer Application aktiviert sein, damit die Vorlage funktioniert. Standardmäßig sind sie deaktiviert. ## Gerätefähigkeiten ### Ladestatus und Fahrzeugerkennung Zwei boolesche Sensoren, abgeleitet vom IEC 61851 Mode 3 Statusregister (H:1201): - **Vehicle Connection** — gibt true zurück wenn ein Fahrzeug physisch verbunden ist (Zustände B1, B2, C1, C2, D1, D2), false wenn getrennt (A, E, F). - **Charge State** — gibt true zurück wenn das Fahrzeug aktiv lädt (Zustände C2 oder D2), false andernfalls. Der Mode 3 Status folgt der Norm IEC 61851: | Zustand | Fahrzeug verbunden | Laden | Beschreibung | |---------|-------------------|-------|-------------| | A | Nein | Nein | Kein Fahrzeug verbunden | | B1 / B2 | Ja | Nein | Fahrzeug verbunden, lädt nicht | | C1 / C2 | Ja | Nur C2 | Fahrzeug fordert Laden an (C2 = PWM aktiv, lädt) | | D1 / D2 | Ja | Nur D2 | Fahrzeug mit Belüftungsanforderung | | E | Nein | Nein | Kurzschluss (CP-PE) | | F | Nein | Nein | Fehler der Ladestation | Das Charge State Gerät bietet außerdem ein **Dienstattribut** "Number of charging phases" (H:1215), das anzeigt ob das Fahrzeug aktuell mit 1 oder 3 Phasen lädt, und eine **Dienstaktion** "Charging phases" zum Umschalten zwischen 1-Phasen- und 3-Phasen-Lademodus. ### Spannungsüberwachung Dreiphasige Phase-Neutral-Spannungssensoren: - **Voltage Phase L1-N** — liest H:306 (BigEndianFloat) - **Voltage Phase L2-N** — liest H:308 (BigEndianFloat) - **Voltage Phase L3-N** — liest H:310 (BigEndianFloat) Alle drei melden die Spannung in Volt mit einem 15-Sekunden-Abfrageintervall. ### Leistungsmessung - **Real Power Sum** — gesamte Wirkleistung aller Phasen, umgerechnet von W in kW. Enthält **Service-Attribute** mit phasenweiser Aufschlüsselung: Phase L1 (H:338), Phase L2 (H:340), Phase L3 (H:342), jeweils in kW. - **Frequency** — Netzfrequenz in Hz aus Register H:336. ### Energiemessung - **Real Energy Delivered** — kumulierte an das Fahrzeug gelieferte Energie (H:374, Float64), umgerechnet von Wh in kWh. Summe aller Phasen. - **Real Energy Consumed** — kumulierte von der Steckdose verbrauchte Energie (H:390, Float64), umgerechnet von Wh in kWh. Summe aller Phasen. ### Attribute und Aktionen auf Modulebene Das Modul stellt mehrere **Service-Attribute** bereit, die in der Gerätedetailansicht sichtbar sind: | Attribut | Beschreibung | |----------|-------------| | Meter Type | Kommunikationstyp des Zählers (RTU, TCP/IP, UDP, P1) | | State | Statusflags des Zählers — Initialised, Updated, Warning, Error | | Mode 3 State | Rohzeichenkette des IEC 61851 Mode 3 Status (A, B1, B2, C1, C2, D1, D2, E, F) | | Max Current | Aktuell angewandter maximaler Ladestrom in Ampere | | Active Load Balancing Safe Current | Rückfallstromwert nach Ablauf der Max-Strom-Gültigkeit | Das Modul bietet außerdem eine **Dienstaktion** "Max Current" zum Schreiben des maximalen Ladestromlimits (6–16 A) in Register H:1210. Der geschriebene Wert muss innerhalb des konfigurierten Gültigkeits-Timeouts (Standard 60 Sekunden) erneuert werden, sonst fällt die Station auf den sicheren Stromwert zurück. > [!WARNING] > Der Max-Strom-Wert wird beim Neustart **nicht beibehalten**. Nach einem Stromausfall fällt die Station auf den sicheren Strom zurück, bis ein neuer Wert über Modbus geschrieben wird. ### Weitere Fähigkeiten Die Alfen Eve stellt weitere Modbus-Register für verkettete Spannungen, phasenweise Ströme und Gesamtstrom, Leistungsfaktor, Scheinleistung, Blindleistung und phasenweise Energieaufschlüsselung bereit. Register auf Stationsebene (Slave 200) liefern Platinentemperatur, OCPP-Status, aggregierten Verbrauch des Smart Charging Network (SCN) und phasenweise Max-Strom-Steuerung. Diese können in einem zukünftigen Update zur TapHome-Vorlage hinzugefügt werden. ## Fehlerbehebung ### Keine Modbus-Kommunikation 1. Überprüfen Sie, ob das Ethernet-Kabel angeschlossen ist und das Ladegerät im gleichen Netzwerk wie TapHome Core ist 2. Bestätigen Sie, dass die Active Load Balancing Lizenz aktiviert ist 3. Prüfen Sie, ob "Allow reading" in der Service Installer Application aktiviert ist 4. Bestätigen Sie die korrekte Slave-ID — verwenden Sie 1 für Steckdose 1 (nicht 200, das ist die Stationsadresse) 5. Stellen Sie sicher, dass keine Firewall Port 502 blockiert 6. Das Ladegerät unterstützt maximal 2 gleichzeitige Modbus-TCP-Verbindungen — prüfen Sie, dass kein anderes System beide Slots belegt ### Max-Strom wird nicht angewandt 1. Überprüfen Sie, ob "Allow writing maximum currents" in der Service Installer Application aktiviert ist 2. Prüfen Sie, ob der sichere Strom konfiguriert ist (muss vor der Steuerung des Max-Stroms über Modbus eingestellt sein) 3. Stellen Sie sicher, dass der Stromwert vor Ablauf des Gültigkeits-Timeouts erneuert wird (Standard 60 Sekunden) 4. Prüfen Sie Register H:1214 (Setpoint accounted for) — Wert 1 bestätigt, dass der geschriebene Strom angewandt wurde ### Phasenumschaltung funktioniert nicht Stellen Sie sicher, dass "Allow 1- and 3-phased charging" in den Active Load Balancing Einstellungen der Service Installer Application aktiviert ist. Diese Einstellung ist erforderlich, damit die Dienstaktion zur Phasenumschaltung funktioniert. ### Firmware-Empfehlung Firmware-Version **6.4.0-4210 oder neuer** wird empfohlen. Ältere Versionen haben einen Fehler, bei dem das Leistungsbudget auf 0 A zurückgesetzt wird, wenn kein Auto lädt. ## Verfügbare Geräte 9 Diese Geräte erscheinen nach dem Import in TapHome. Alfen Socket Modul Serviceattribute | | | |----------------------------------------|----------------------------------------------------------------------------------------------------------------| | Zählertyp | Kommunikationstyp des Zählers — RTU, TCP/IP, UDP oder P1 | | Status | Statusflags des Zählers — Initialised, Updated, Warning, Error | | Mode 3 Status | IEC 61851 Mode 3 Ladezustand — A (getrennt), B1/B2 (verbunden), C1/C2 (laden), D1/D2 (Belüftung), E/F (Fehler) | | Max. Strom | Aktuell angewandter maximaler Ladestrom in Ampere | | Active Load Balancing Sicherheitsstrom | Rückfallstromwert nach Ablauf der Max-Strom-Gültigkeit | Serviceaktionen | | | |------------|----------------------------------------------------------------------------------------------------| | Max. Strom | Maximalen Ladestromlimit setzen (6–16 A) — muss innerhalb des Gültigkeits-Timeouts erneuert werden | Lesen (Modul) ```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")); ``` Serviceattribute 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" ``` Serviceaktionen Max Current Parameter: Max Current \[A] (6–16 cur) ```taphome MODBUSW(H, 1210, Float, cur, 2) ``` Frequenz Variable Nur lesen Register: H:336 Float Einheit: Hz Lesen ```taphome MODBUSR(H, 336, Float, 2) ``` Ladezustand Reed-Kontakt Nur lesen Erkennung aktiven Ladens — true wenn das Fahrzeug Strom bezieht (Mode 3 Zustände C2 oder D2) Register: H:1201 String switch-map Serviceattribute | | | |-----------------------|------------------------------------------------------------| | Anzahl der Ladephasen | Anzahl der aktuell zum Laden verwendeten Phasen (1 oder 3) | Serviceaktionen | | | |------------|------------------------------------------------------| | Ladephasen | Umschalten zwischen 1-Phasen- und 3-Phasen-Lademodus | Lesen ```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) ``` Serviceattribute Number of charging phases ```taphome MODBUSR(H, 1215, Uint16); ``` Serviceaktionen Charging phases Parameter: Charging Phases ```taphome MODBUSW(H, 1215, Uint16, chrg); ``` Verbrauchte Energie Variable Nur lesen Kumulierte von der Steckdose verbrauchte Energie aller Phasen (kWh) Register: H:390 Float Einheit: kWh Lesen ```taphome MODBUSR(H, 390, Float, 4)/1000; ``` Gelieferte Energie Variable Nur lesen Kumulierte an das Fahrzeug gelieferte Energie aller Phasen (kWh) Register: H:374 Float Einheit: kWh Lesen ```taphome MODBUSR(H, 374, Float, 4)/1000 ``` Gesamtwirkleistung Variable Nur lesen Gesamtwirkleistung aller Phasen (kW) mit phasenweiser Aufschlüsselung in Dienstattributen Register: H:344 Float Einheit: kW Serviceattribute | | |----------| | Phase L1 | | Phase L2 | | Phase L3 | Lesen ```taphome MODBUSR(H, 344, Float, 2)/1000 ``` Serviceattribute 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"; ``` Fahrzeugverbindung Reed-Kontakt Nur lesen Steckererkennung — true wenn das EV-Kabel angeschlossen ist (Mode 3 Zustände B1/B2/C1/C2/D1/D2) Register: H:1201 String switch-map Lesen ```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) ``` Spannung Phase L1-N Variable Nur lesen Register: H:306 BigEndianFloat Einheit: V Lesen ```taphome MODBUSR(H, 306, BigEndianFloat, 2) ``` Spannung Phase L2-N Variable Nur lesen Register: H:308 BigEndianFloat Einheit: V Lesen ```taphome MODBUSR(H, 308, BigEndianFloat, 2) ``` Spannung Phase L3-N Variable Nur lesen Register: H:310 BigEndianFloat Einheit: V Lesen ```taphome MODBUSR(H, 310, BigEndianFloat, 2) ``` **Verbindung:** Modbus TCP • Slave ID: $\[SlaveId] • Hostname: `ACE-{SERIAL}.local` Mögliche Verbesserungen (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 ## Importparameter Diese Werte geben Sie beim Import des XML ein. | In der App abgefragt | Standard | |----------------------|---------------| | Slave-ID | `1` | | IP-Adresse | `192.168.1.0` | ## Quellen - 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 Herstellerdokumente sind © ihrer jeweiligen Eigentümer. Sie werden so bereitgestellt, wie der Hersteller sie veröffentlicht hat, nur zur Information. ## Verwandte Dokumentation - [Modbus Integration](https://taphome.com/de/compatibility/modbus-guide/) - [Modbus](https://taphome.com/de/docs/integration/modbus/) - [Einfache Konfiguration mit Vorlagen](https://taphome.com/de/docs/integration/modbus/templates/) - [Modbus-Skripte und Prefetch](https://taphome.com/de/docs/script/modbus-scripts/) - [Modbus-Funktionen](https://taphome.com/de/docs/script/modbus/) - [Modbus-Datentypen](https://taphome.com/de/docs/script/modbus-data-types/)