Sofar Solar · Solar inverter
HYD 3...20K-3PH / HYD 3...6K-EP / SOFAR ...KTL-G3 Modbus register map
Default configuration
- Protocol
- Modbus TCP
- Port
- 8899
- Unit ID
- 1
- Addressing
- 0-based
- Byte order
- Big endian
- Word order
- High word first
Register map
| Address | Count | Name | Type | Unit | Scale | Access |
|---|---|---|---|---|---|---|
| 1160 | 1 | Grid active power at the point of common coupling Signed; positive means export to the grid. | Int16 | W | 10 | R |
| 1170 | 1 | Grid current R | UInt16 | A | 0.01 | R |
| 1171 | 1 | Grid active power R Signed; positive means export. | Int16 | W | 10 | R |
| 1181 | 1 | Grid current S | UInt16 | A | 0.01 | R |
| 1182 | 1 | Grid active power S Signed; positive means export. | Int16 | W | 10 | R |
| 1192 | 1 | Grid current T | UInt16 | A | 0.01 | R |
| 1193 | 1 | Grid active power T Signed; positive means export. | Int16 | W | 10 | R |
| 1198 | 1 | External PV active power Power of cascaded external inverters. | UInt16 | W | 10 | R |
| 1414 | 1 | PV1 power | UInt16 | W | 10 | R |
| 1417 | 1 | PV2 power | UInt16 | W | 10 | R |
| 1420 | 1 | PV3 power | UInt16 | W | 10 | R |
| 1422 | 1 | PV4 power | UInt16 | W | 10 | R |
| 1542 | 1 | Battery tower 1 power Signed; positive means charging (evcc inverts it so that charging is negative). | Int16 | W | 10 | R |
| 1544 | 1 | Battery tower 1 state of charge | UInt16 | % | 1 | R |
| 1549 | 1 | Battery tower 2 power Signed; positive means charging (evcc inverts it so that charging is negative). | Int16 | W | 10 | R |
| 1551 | 1 | Battery tower 2 state of charge | UInt16 | % | 1 | R |
| 1670 | 2 | PV generation total | UInt32 | kWh | 0.1 | R |
| 1678 | 2 | Energy purchased from grid total | UInt32 | kWh | 0.1 | R |
| 4368 | 1 | Energy storage working mode 0 = self use, 3 = passive (external power setpoint). | Int16 | - | 1 | RW |
Notes
Register map from the evcc template https://raw.githubusercontent.com/evcc-io/evcc/master/templates/definition/meter/sofarsolar-g3.yaml (Sofar HYD 5...20K-3PH, HYD 3...6K-EP, SOFAR 5...24KTL-G3 and 80...136KTL-G3), cross-checked against wills106/homeassistant-solax-modbus (custom_components/solax_modbus/plugin_sofar.py). This is the newer 'G3' protocol on a second-generation unit that serves Modbus TCP on port 8899, unit ID 1. The older HYD protocol uses different addresses in the 0x02xx block (evcc template sofarsolar.yaml) and RS-485 at 9600 8N1 - a device on that protocol needs the other map. Grid power and per-phase power are signed, positive = export to the grid. The registers are holding registers; the battery registers are repeated for up to eight BTS 5K towers and advance by seven registers per tower, so only towers 1 and 2 are listed here (power 0x0606/0x060D/0x0614/..., state of charge 0x0608/0x060F/0x0616/...). Battery compatibility: SOFAR's compatible-battery declaration for the HYD hybrid (2024-07-12) lists SOFAR BTS 5K and BTS E5-20-DS5, Pylontech US2000/US3000/US5000 and Force H1/H2/H3, WeCo GTX 3000H/5000/5000P/5000S, 4K4/4K4LT/4K4 PRO/5K3, H48050/H48074 and lead-acid - https://downloads.sofarsolar.eu/wp-content/uploads/sofar/Declarations/Technik%20Declaration/SOFAR%20HYD%20Inverter_Declaration_Compatible%20Battery%20List_2024-07-12_en-EU.pdf.