SunSpec Model 211 — single phase (AN or AB) meter
SunSpec Model 211 is a standardised floating-point AC energy meter definition used across single-phase (AN or AB) grid-connection points in solar PV, battery storage, and building-energy installations. The template reads the complete SunSpec Model 211 register block over Modbus TCP, covering per-phase current, line-to-neutral and line-to-line voltage, frequency, real power, apparent power, reactive power, power factor, four-quadrant cumulative energy (import and export in Wh, VAh, and varh), and the event-flag register. Any device advertising model ID 211 via the SunSpec discovery sequence is compatible. The template also covers the related models: SunSpec Model 212, SunSpec Model 213, and SunSpec Model 214. ModbusCloud Gateway connects over TCP and surfaces all registers in your portal without manual address entry.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 64, read only
- Brand
- SunSpec
- Compatible models
- SunSpec Model 212 — split single phase (ABN) meter · SunSpec Model 213 — wye-connect three phase (abcn) meter · SunSpec Model 214 — delta-connect three phase (abc) meter
- Last updated
Registers (64)
64 read, 0 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| id | Read | ||||
| l | Read | ||||
| a | A | Read | |||
| apha | A | Read | |||
| aphb | A | Read | |||
| aphc | A | Read | |||
| phv | V | Read | |||
| phvpha | V | Read | |||
| phvphb | V | Read | |||
| phvphc | V | Read | |||
| ppv | V | Read | |||
| ppvphab | V | Read | |||
| ppvphbc | V | Read | |||
| ppvphca | V | Read | |||
| hz | Hz | Read | |||
| w | W | Read | |||
| wpha | W | Read | |||
| wphb | W | Read | |||
| wphc | W | Read | |||
| va | VA | Read | |||
| vapha | VA | Read | |||
| vaphb | VA | Read | |||
| vaphc | VA | Read | |||
| var | var | Read | |||
| varpha | var | Read | |||
| varphb | var | Read | |||
| varphc | var | Read | |||
| pf | PF | Read | |||
| pfpha | PF | Read | |||
| pfphb | PF | Read | |||
| pfphc | PF | Read | |||
| totwhexp | Wh | Read | |||
| totwhexppha | Wh | Read | |||
| totwhexpphb | Wh | Read | |||
| totwhexpphc | Wh | Read | |||
| totwhimp | Wh | Read | |||
| totwhimppha | Wh | Read | |||
| totwhimpphb | Wh | Read | |||
| totwhimpphc | Wh | Read | |||
| totvahexp | VAh | Read | |||
| totvahexppha | VAh | Read | |||
| totvahexpphb | VAh | Read | |||
| totvahexpphc | VAh | Read | |||
| totvahimp | VAh | Read | |||
| totvahimppha | VAh | Read | |||
| totvahimpphb | VAh | Read | |||
| totvahimpphc | VAh | Read | |||
| totvarhimpq1 | varh | Read | |||
| totvarhimpq1pha | varh | Read | |||
| totvarhimpq1phb | varh | Read | |||
| totvarhimpq1phc | varh | Read | |||
| totvarhimpq2 | varh | Read | |||
| totvarhimpq2pha | varh | Read | |||
| totvarhimpq2phb | varh | Read | |||
| totvarhimpq2phc | varh | Read | |||
| totvarhexpq3 | varh | Read | |||
| totvarhexpq3pha | varh | Read | |||
| totvarhexpq3phb | varh | Read | |||
| totvarhexpq3phc | varh | Read | |||
| totvarhexpq4 | varh | Read | |||
| totvarhexpq4pha | varh | Read | |||
| totvarhexpq4phb | varh | Read | |||
| totvarhexpq4phc | varh | Read | |||
| evt | Read |
Loading registers…
Send your device list
If a device is not in the library yet, we build the template for free as soon as we have the register data.
Use cases
- Monitor total imported and exported active energy (totwhimp, totwhexp) to verify net-metering balances month over month.
- Track real-time real power (w) and power factor (pf) to detect reactive-load problems on single-phase grid connections.
- Alert on frequency (hz) deviations outside the acceptable grid band to identify islanding or grid instability events early.
- Compare per-phase apparent power (vapha) against rated capacity to verify correct load distribution across the installation.
- Report four-quadrant reactive energy (totvarhimpq1 through totvarhexpq4) to support power-quality audits or grid-operator reporting.
Installation
Enable Modbus TCP on the physical meter: open the device web interface or front-panel configuration and activate Modbus TCP under the communication or network section, confirming the device responds on port 502.
Assign a static IP address to the meter and connect it to the same LAN as the ModbusCloud Gateway; verify network reachability using a ping from a laptop on the same subnet.
In the ModbusCloud portal, add a new device, select TCP as the protocol, enter the meter IP address and port 502, then import the SunSpec Model 211 template and assign the correct Modbus unit ID (typically 1, but check the meter configuration).
Spot-check the id register (address 0): it must read 211 for Model 211, 212 for split single-phase, 213 for wye three-phase, or 214 for delta three-phase. If it reads a different value, the meter is advertising a different SunSpec model and you should select the matching template.
Things to watch for
The id register returns a value other than 211. Why?
SunSpec devices auto-advertise their model ID based on their wiring configuration. A value of 212 means split single-phase (ABN), 213 means wye-connected three-phase, and 214 means delta-connected three-phase. Select the template matching the actual model ID reported by the device rather than changing wiring to force 211.
All float32 registers return garbage or wildly wrong values.
The SunSpec floating-point model uses IEEE 754 big-endian byte order with the high word first. If your gateway or Modbus master swaps word order, every float32 will decode incorrectly. Verify that the ModbusCloud Gateway is set to big-endian word order for this device, which is required by the SunSpec specification.
The meter connects but phvphb and phvphc always read zero.
Model 211 covers single-phase AN or AB connections. Registers for phases B and C are present in the block but are not populated by a single-phase device. Zero or NaN in those fields is expected behaviour, not an error. Use a Model 213 or 214 template for three-phase meters.
The gateway connects but no register values appear in the portal.
Check that the SunSpec discovery address is correct: the device must have the SunSpec magic identifier at Modbus register 40001 or 50001. If the meter uses a non-standard base address, set the SunSpec start address explicitly in the ModbusCloud Gateway configuration. Also confirm the unit ID matches the meter's configured Modbus slave address.
Knowledge base articles for this device
SunSpec Modbus: one register map for many inverters
SunSpec Modbus is the open register map SMA, Fronius, SolarEdge and Kostal share. The layout, int+SF vs float, the TCP port per brand and reading a mixed fleet.
Fronius Modbus: read a Symo GEN24 over Modbus TCP
Fronius Modbus explained: enable Modbus TCP on the Symo GEN24 on port 502, choose between int+SF and float, read the right SunSpec registers and scale them correctly. Practical guide for solar installers.
SMA Modbus: reading a Sunny Boy over Modbus TCP (installers)
SMA Modbus explained: enable the Modbus TCP server on port 502, choose between the SMA profile (unit ID 3) and SunSpec (unit ID 126), read the right registers, and handle the NaN values at night. Practical guide for installers.
Want to see how it works?
