Victron Energy · Charge controller
SmartSolar MPPT / BlueSolar MPPT charge controllers (solarcharger service on a GX device) Modbus register map
Default configuration
- Protocol
- Modbus TCP
- Port
- 502
- Unit ID
- 239
- Addressing
- 0-based
- Byte order
- Big endian
- Word order
- High word first
Register map
| Address | Count | Name | Type | Unit | Scale | Access |
|---|---|---|---|---|---|---|
| 771 | 1 | Battery voltage | UInt16 | V | 0.01 | R |
| 772 | 1 | Battery current Positive while charging. | Int16 | A | 0.1 | R |
| 773 | 1 | Battery temperature Only reported by VE.Can MPPTs. | Int16 | °C | 0.1 | R |
| 774 | 1 | Charger on/off 1 = on, 4 = off. Only available on VE.Can MPPTs. | UInt16 | - | 1 | RW |
| 775 | 1 | Charge state 0 = off, 2 = fault, 3 = bulk, 4 = absorption, 5 = float, 6 = storage, 7 = equalize, 11 = other (Hub-1), 245 = wake-up, 252 = external control. | UInt16 | - | 1 | R |
| 776 | 1 | PV voltage Not available when multiple VE.Can chargers are combined. | UInt16 | V | 0.01 | R |
| 777 | 1 | PV current Calculated by the GX device from /Yield/Power and /Pv/V. | Int16 | A | 0.1 | R |
| 778 | 1 | Equalization pending 0 = no, 1 = yes, 2 = error, 3 = unavailable/unknown. | UInt16 | - | 1 | R |
| 779 | 1 | Equalization time remaining | UInt16 | s | 0.1 | R |
| 780 | 1 | Relay on the charger 0 = open, 1 = closed. | UInt16 | - | 1 | R |
| 781 | 1 | Alarm (deprecated) 0 = no alarm, 2 = alarm. The register list marks it deprecated: the value is always 0. | UInt16 | - | 1 | R |
| 784 | 1 | Yield today | UInt16 | kWh | 0.1 | R |
| 785 | 1 | Maximum charge power today | UInt16 | W | 1 | R |
| 786 | 1 | Yield yesterday | UInt16 | kWh | 0.1 | R |
| 787 | 1 | Maximum charge power yesterday | UInt16 | W | 1 | R |
| 788 | 1 | Error code 0 = no error, 1 = battery temperature too high, 2 = battery voltage too high, 3 = battery temperature sensor miswired (+), 4 = battery temperature sensor miswired (-), 5 = battery temperature sensor disconnected, 6 = battery voltage sense miswired (+), 7 = battery voltage sense miswired (-), 8 = battery voltage sense disconnected, 9 = battery voltage wire losses too high, 17 = charger temperature too high, 18 = charger over-current, 19 = charger current polarity reversed, 20 = bulk time limit reached, 22 = charger temperature sensor miswired, 23 = charger temperature sensor disconnected, 34 = input current too high. | UInt16 | - | 1 | R |
| 789 | 1 | PV power (16-bit) Older 16-bit variant of the 32-bit PV power at 792. | UInt16 | W | 0.1 | R |
| 790 | 1 | User yield Energy generated since the last user reset. | UInt16 | kWh | 0.1 | R |
| 791 | 1 | MPP operation mode 0 = off, 1 = voltage/current limited, 2 = MPPT active, 255 = not available. | UInt16 | - | 1 | R |
| 792 | 2 | PV power 32-bit PV power; occupies 792 and 793. | UInt32 | W | 1 | R |
| 794 | 1 | Load current Load output current on models with a load output. | Int16 | A | 0.1 | R |
| 3700 | 1 | PV voltage, tracker 1 Multi-tracker models (MPPT RS). The register list labels this first tracker block 'tracker 0' (/Pv/0) while its MPP-operation-mode and enabled rows below are labelled 'tracker 1' over the same /Pv/0 path; these rows number the trackers 1-4 throughout, so tracker 1 here is the register list's tracker 0. | UInt16 | V | 0.01 | R |
| 3701 | 1 | PV voltage, tracker 2 | UInt16 | V | 0.01 | R |
| 3702 | 1 | PV voltage, tracker 3 | UInt16 | V | 0.01 | R |
| 3703 | 1 | PV voltage, tracker 4 | UInt16 | V | 0.01 | R |
| 3708 | 1 | Yield today, tracker 1 | UInt16 | kWh | 0.1 | R |
| 3709 | 1 | Yield today, tracker 2 | UInt16 | kWh | 0.1 | R |
| 3710 | 1 | Yield today, tracker 3 | UInt16 | kWh | 0.1 | R |
| 3711 | 1 | Yield today, tracker 4 | UInt16 | kWh | 0.1 | R |
| 3712 | 1 | Yield yesterday, tracker 1 | UInt16 | kWh | 0.1 | R |
| 3713 | 1 | Yield yesterday, tracker 2 | UInt16 | kWh | 0.1 | R |
| 3714 | 1 | Yield yesterday, tracker 3 | UInt16 | kWh | 0.1 | R |
| 3715 | 1 | Yield yesterday, tracker 4 | UInt16 | kWh | 0.1 | R |
| 3716 | 1 | Maximum charge power today, tracker 1 | UInt16 | W | 1 | R |
| 3717 | 1 | Maximum charge power today, tracker 2 | UInt16 | W | 1 | R |
| 3718 | 1 | Maximum charge power today, tracker 3 | UInt16 | W | 1 | R |
| 3719 | 1 | Maximum charge power today, tracker 4 | UInt16 | W | 1 | R |
| 3720 | 1 | Maximum charge power yesterday, tracker 1 | UInt16 | W | 1 | R |
| 3721 | 1 | Maximum charge power yesterday, tracker 2 | UInt16 | W | 1 | R |
| 3722 | 1 | Maximum charge power yesterday, tracker 3 | UInt16 | W | 1 | R |
| 3723 | 1 | Maximum charge power yesterday, tracker 4 | UInt16 | W | 1 | R |
| 3724 | 1 | PV power, tracker 1 | UInt16 | W | 1 | R |
| 3725 | 1 | PV power, tracker 2 | UInt16 | W | 1 | R |
| 3726 | 1 | PV power, tracker 3 | UInt16 | W | 1 | R |
| 3727 | 1 | PV power, tracker 4 | UInt16 | W | 1 | R |
| 3728 | 2 | User yield (32-bit) Energy generated since the last user reset; 32-bit variant. | UInt32 | kWh | 1 | R |
| 3730 | 1 | PV power (16-bit) | UInt16 | W | 1 | R |
| 3731 | 1 | MPP operation mode, tracker 1 0 = off, 1 = voltage/current limited, 2 = MPPT active, 255 = not available. | UInt16 | - | 1 | R |
| 3732 | 1 | MPP operation mode, tracker 2 | UInt16 | - | 1 | R |
| 3733 | 1 | MPP operation mode, tracker 3 | UInt16 | - | 1 | R |
| 3734 | 1 | MPP operation mode, tracker 4 | UInt16 | - | 1 | R |
| 3735 | 1 | Tracker 1 enabled 0 = disabled, 1 = enabled. Only available on MPPT RS. | UInt16 | - | 1 | R |
| 3736 | 1 | Tracker 2 enabled 0 = disabled, 1 = enabled. | UInt16 | - | 1 | R |
| 3737 | 1 | Tracker 3 enabled 0 = disabled, 1 = enabled. | UInt16 | - | 1 | R |
| 3738 | 1 | Tracker 4 enabled 0 = disabled, 1 = enabled. | UInt16 | - | 1 | R |
Read this device live with Modbus Connect, free for Windows, macOS and Linux
Related guides
Notes
A SmartSolar or BlueSolar MPPT controller has no Modbus port of its own: it speaks VE.Direct (or VE.Can) to a GX device, and these registers are the com.victronenergy.solarcharger service on that GX device's Modbus TCP server. Read them with the solar charger's own unit ID, not the system unit ID 100 used by the victron-gx-cerbo seed: the register list's Unit ID mapping sheet gives the preferred IDs (e.g. 239 = VE.Direct via USB, ttyUSB0; 226 = Cerbo GX VE.Direct port 1). Since Venus OS 2.60 unit IDs are assigned dynamically, so check Settings > Integrations > Modbus TCP server > Available services on the GX device and use the ID listed there; 239 is only the preferred value for a VE.Direct-to-USB charger. Addresses are the decimal addresses of the CCGX Modbus TCP register list (revision 55), used unchanged as wire addresses; that list's 'Scalefactor' column is a divisor, so the factors here are the equivalent multipliers. 792 is a 32-bit value and occupies 792 and 793, which is why 793 is not listed. Left out: the custom-name string at 3740 and the RESERVED rows 782, 783 and 3704-3707 (revision 55 lists no serial-number register for this service). The register list numbers the PV-voltage, yield and maximum-power blocks 'tracker 0'-'tracker 3' but the MPP-operation-mode and enabled rows 'tracker 1'-'tracker 4' over the same /Pv/0.../Pv/3 paths; the rows here number the trackers 1-4, so tracker 1 is the register list's 'tracker 0'. Register 777 is a value the GX device calculates, not a measurement the charger reports. Source: Victron Energy 'CCGX-Modbus-TCP-register-list.xlsx', revision 55, in the vendor's dbus_modbustcp repository.