- Home
- Modbus register maps
- KATHREIN
- KATHREIN Wallbox (Modbus TCP server)
EV charger · Modbus register map
KATHREIN KATHREIN Wallbox (Modbus TCP server) Modbus register map
Updated 19 November 2026
KATHREIN wallboxes include a Modbus TCP server, disabled at the factory, that lets an energy manager read the charger state and set the charging current. This map covers the identity strings, device info and phase mapping, the UTC timestamp, the EVSE, error, PP and CP states, relay state, granted current and power, session duration and energy, and the EMS control block with its timeout fallback.
This page lists 22 Modbus registers for the KATHREIN KATHREIN Wallbox (Modbus TCP server) — 6 writable — with the table, 0-based wire address, data type, word order, scale, units and access of each, re-typed from KATHREIN’s own free documentation (linked below) and checked against it.
- Manufacturer
- KATHREIN
- Model
- KATHREIN Wallbox (Modbus TCP server)
- Equipment type
- EV charger
- Registers
- 22 (6 writable)
- Transport
- Modbus TCP
- Default unit ID
- 0
- TCP port
- 502
- Documented addressing
- hexadecimal, 0-based
- 32-bit word order
- ABCD high word first (big-endian)
Integration notes: KATHREIN KATHREIN Wallbox (Modbus TCP server)
Enable the Modbus server in easyOperate, write 0x8000 to 0x00A0 to take EMS control, then write the charging current in mA to 0x00A2 (0 pauses). Read 0x0060 for state, 0x0066 for granted power and 0x0069 for session energy.
Minimum registers to map
Addresses are 0-based wire addresses. Enough to monitor and run the unit; map more as the job needs.
| Register | Name | Type | Why | Access |
|---|---|---|---|---|
| HR 160 | EMS-Control: Control-Register | UINT16 | Enable EMS control | Read/write |
| HR 162 | EMS-Control: Setpoint Charging Current | UINT16 | Charging current setpoint (mA) | Read/write |
| HR 163 | EMS-Control: Timeout Period | UINT16 | Setpoint timeout | Read/write |
| HR 165 | EMS-Control: Timeout Fallback Current | UINT16 | Fallback current after timeout | Read/write |
| HR 96 | EVSE: Status | UINT16 | EVSE status | Read |
| HR 97 | EVSE: Error-State | BITMAP16 | Error flags | Read |
| HR 102 | EVSE: Granted Power | UINT16 | Granted power | Read |
| HR 105 | Charging: Energy | UINT32 ABCD | Session energy | Read |
Enable Modbus control & writes
The Modbus server is switched on or off in the easyOperate configuration panel; it is disabled by factory default. EMS control itself is enabled by writing 0x8000 to 0x00A0.
Communication loss & watchdog
If 0x00A3 is set above 0, each setpoint write restarts a timer of that many seconds; when it runs out the wallbox charges with the fallback current in 0x00A5 (default 6000 mA) on the lines in 0x00A4. The default 0 disables the timeout.
Byte order & addressing
- Current setpoints are in milliamps, not amps or tenths of amps.
- Writing 0xFFFF to 0x00A2 cancels the charge; 0 only pauses it.
- The unit ID is ignored today, but 0 is recommended for future firmware.
Network setup
- Connect to the wallbox IP address on TCP port 502.
- Use unit ID 0.
Watch out for
- Meter values (0x0030 on) are floats with no stated word order; check against the display before using them.
KATHREIN KATHREIN Wallbox (Modbus TCP server) Modbus registers
Address = 0-based wire address (the documented number is shown under it when it differs) · Order: ABCD = high word first, CDAB = low word first · Scale: engineering value = raw × scale.
| Table | Address | Name | Description | Type | Order | Scale | Units | Access | Values / bits |
|---|---|---|---|---|---|---|---|---|---|
| HR | 0doc 0x0000 | Header: Mapping-Version | Version of this register mapping (currently 0x0001). | UINT16 | Read | ||||
| HR | 1doc 0x0001 | Device: Number | Article number text, format 620xxxxx(-yyyy). | STRING[16] | Read | ||||
| HR | 9doc 0x0009 | Device: Type | Type text, format ACxx(E). | STRING[16] | Read | ||||
| HR | 17doc 0x0011 | Device: Serial | Serial number text, format G0Rxxxxxxx. | STRING[16] | Read | ||||
| HR | 25doc 0x0019 | Device: Info | Power class, cable or socket, calibration-law version and relay capability. | BITMAP16 | Read | bit 0 = Power class bit 0 (0x0001 = 11 kW, 3 x 16 A); bit 1 = Power class bit 1 (0x0002 = 22 kW, 3 x 32 A); bit 4 = 0 = cable, 1 = socket (plug); bit 7 = 0 = standard, 1 = Eichrecht; bit 8 = Relay capability: L1 only; bit 9 = Relay capability: L2 only; bit 10 = Relay capability: L3 only; bit 12 = Relay capability: L1 and L2; bit 13 = Relay capability: L1 and L3; bit 14 = Relay capability: L2 and L3; bit 15 = Relay capability: L1, L2 and L3 | |||
| HR | 26doc 0x001A | Device: Line-Mapping | Phase rotation the wallbox is wired with. | UINT16 | Read | 0 = L1-L2-L3 (default); 1 = L1-L3-L2 (invalid phase rotation); 2 = L2-L3-L1; 3 = L2-L1-L3 (invalid phase rotation); 4 = L3-L1-L2; 5 = L3-L2-L1 (invalid phase rotation) | |||
| HR | 27doc 0x001B | Device: Timestamp (UTC) | Unix time: seconds since 1970-01-01 00:00:00 UTC. | UINT64 | ABCD | s | Read | ||
| HR | 96doc 0x0060 | EVSE: Status | Charging session state. | UINT16 | Read | 0 = Idle; 1 = EV Connected; 2 = Authentication Waiting; 3 = Authentication Confirmed; 4 = Charging Active; 5 = Charging Paused; 6 = Charging Completed; 7 = RFID-Pairing; 65535 = Error | |||
| HR | 97doc 0x0061 | EVSE: Error-State | Active fault flags; 0 = no error. | BITMAP16 | Read | bit 0 = Relay welded; bit 1 = Residual DC current detected (RCD); bit 2 = Socket lock detection; bit 3 = Charging overcurrent; bit 4 = CP-D: ventilation not available; bit 5 = CP-E: short circuit CP-PE; bit 6 = CP-F: loop broken CP-PE; bit 7 = PP error (short circuit); bit 15 = Internal error | |||
| HR | 98doc 0x0062 | EVSE: PP-State | Plug version: cable rating from the PP resistor in amps; fixed-cable version reads 0. | UINT16 | Read | 0 = Cable not connected (socket version) / fixed cable mounted (cable version); 13 = 13 A (1500 ohm); 20 = 20 A (680 ohm); 32 = 32 A (220 ohm); 63 = 63 A (100 ohm); 65535 = Error (invalid PP resistor) | |||
| HR | 99doc 0x0063 | EVSE: CP-State | Control pilot state; other values mean undefined or error. | UINT16 | Read | 0 = A (EV not detected, standby); 1 = B (EV detected); 2 = C (EV charging); 3 = D (EV charging with fan); 4 = E (CP short circuit); 5 = F (EVSE not available, CP = -12 VDC) | |||
| HR | 100doc 0x0064 | EVSE: Relais-State | Which line relays are closed; 0 = all off. | BITMAP16 | Read | bit 0 = Relay L1 activated; bit 1 = Relay L2 activated; bit 2 = Relay L3 activated | |||
| HR | 101doc 0x0065 | EVSE: Granted Current | Current per line signalled on the CP: 0 or 6000-32000 mA. | UINT16 | mA | Read | |||
| HR | 102doc 0x0066 | EVSE: Granted Power | Power allowed over all active lines per the CP signal (1380-22080 W at 230 V). | UINT16 | W | Read | |||
| HR | 103doc 0x0067 | Charging: Duration | Duration of the charging session. | UINT32 | ABCD | s | Read | ||
| HR | 105doc 0x0069 | Charging: Energy | Energy delivered in the charging session. | UINT32 | ABCD | Wh | Read | ||
| HR | 160doc 0x00A0 | EMS-Control: Control-Register | Write 0x8000 to hand control to the energy manager; default 0x0000 (off). | UINT16 | Read/write | 0 = EMS control disabled (default); 32768 = Enable EMS control | |||
| HR | 161doc 0x00A1 | EMS-Control: Setpoint Relais-Matrix | Lines used with the current setpoint; L2 and L3 marked reserved for future. Default 0x0007. | BITMAP16 | Read/write | bit 0 = Line 1; bit 1 = Line 2 (reserved for future); bit 2 = Line 3 (reserved for future) | |||
| HR | 162doc 0x00A2 | EMS-Control: Setpoint Charging Current | 0 pauses, 6000-32000 mA charges, 0xFFFF cancels; default = power-class maximum. | UINT16 | mA | Read/write | 0 = Charging paused; 65535 = Charging cancel | ||
| HR | 163doc 0x00A3 | EMS-Control: Timeout Period | 0 = timeout off (default); each setpoint write restarts the timer. | UINT16 | s | Read/write | |||
| HR | 164doc 0x00A4 | EMS-Control: Timeout Fallback Pattern | Lines used after a timeout; default 0x0007 (3 lines). | BITMAP16 | Read/write | bit 0 = Line 1; bit 1 = Line 2; bit 2 = Line 3 | |||
| HR | 165doc 0x00A5 | EMS-Control: Timeout Fallback Current | Current applied after a timeout: 0 or 6000-32000 mA, default 6000. | UINT16 | mA | Read/write |
Notes on this map
- KATHREIN does not host this register mapping publicly; the linked copy is the unaltered release 1.1 document posted on the Symcon community forum.
- Word order: the data-type table says integer types are stored big-endian with the most significant register first, so UINT32 and UINT64 values are high word first (ABCD).
- Left out: the meter block 0x0030-0x005C (voltages, currents, powers, power factors, total energy). These are FLOAT32 values and the document only says they follow IEEE 754; the integer word-order rule is not stated for floats.
- Left out: tariff registers 0x006B-0x006D and the reserved BINARY blocks, which the document marks as reserved for future use.
- Only holding registers are answered: read with function 03, write with 06 or 16.
Check it against the live device. A register map tells you what the controller can expose; the unit in front of you may differ by firmware or options. Read a few registers and compare them with the unit’s own display; for a 32-bit value the float and byte-order decoder shows all four word orders at once, so a wrong word order or scale is obvious. New to this? Read what a register map is and why addresses are off by one.
Questions about the KATHREIN KATHREIN Wallbox (Modbus TCP server)
What Modbus registers does the KATHREIN KATHREIN Wallbox (Modbus TCP server) have?
This map lists 22 registers: 22 holding registers. 6 of them can be written. Registers vary with firmware, options and configuration, so confirm against the device.
Are the KATHREIN KATHREIN Wallbox (Modbus TCP server) Modbus addresses 0-based or 1-based?
The manufacturer's document numbers registers hexadecimal, 0-based. Every address on this page is the 0-based wire address you put in the request; the documented number is shown under it where it differs. Addresses are printed in hex and go on the wire unchanged. The table starts with register 0x0000 (mapping version), which cannot exist in 1-based numbering, so the printed numbers are protocol addresses: 0x00A2 is requested as 162 decimal.
What byte order does the KATHREIN KATHREIN Wallbox (Modbus TCP server) use for 32-bit values?
Multi-register values in this map use ABCD (high word first (big-endian)). Set your client to this order for every 32/64-bit value in the table.
What are the minimum Modbus registers to integrate the KATHREIN KATHREIN Wallbox (Modbus TCP server)?
Start with HR 160 EMS-Control: Control-Register (Enable EMS control); HR 162 EMS-Control: Setpoint Charging Current (Charging current setpoint (mA)); HR 163 EMS-Control: Timeout Period (Setpoint timeout); HR 165 EMS-Control: Timeout Fallback Current (Fallback current after timeout); HR 96 EVSE: Status (EVSE status); HR 97 EVSE: Error-State (Error flags); HR 102 EVSE: Granted Power (Granted power); HR 105 Charging: Energy (Session energy).
How do I enable Modbus control of the KATHREIN KATHREIN Wallbox (Modbus TCP server)?
The Modbus server is switched on or off in the easyOperate configuration panel; it is disabled by factory default. EMS control itself is enabled by writing 0x8000 to 0x00A0.
What happens when the KATHREIN KATHREIN Wallbox (Modbus TCP server) loses Modbus communication?
If 0x00A3 is set above 0, each setpoint write restarts a timer of that many seconds; when it runs out the wallbox charges with the fallback current in 0x00A5 (default 6000 mA) on the lines in 0x00A4. The default 0 disables the timeout.
Where is the official KATHREIN KATHREIN Wallbox (Modbus TCP server) Modbus documentation?
The source is KATHREIN-Wallbox - ModBus-Server - Register-Mapping (Release Version 1.1), revision 2024-09-09. KATHREIN doesn't publish it on its own website, so this map was re-typed from a free copy at https://community.symcon.de/uploads/short-url/cy0QLy5VdPIfO0xxbqwA4czIcnt.pdf. It may be an older revision, so check it against the live unit.
Source: KATHREIN-Wallbox - ModBus-Server - Register-Mapping · Release Version 1.1 · rev. 2024-09-09 · unofficial copy. Register numbers, types, scaling and units are reproduced as published; descriptions are our own.