Shelly Shelly Pro 3EM Modbus TCP template

Shelly Pro 3EM

Monitors three-phase energy metering via Modbus TCP on Shelly Pro 3EM

Modbus TCP template for the Shelly Pro 3EM three-phase energy meter. It reads voltage, current, active power, apparent power, power factor, and accumulated energy across all three phases and neutral. No writable control registers are included.

Protocol
Modbus TCP
Connection
Ethernet, Modbus TCP
Registers
61, read only
Brand
Shelly
Key readings
Voltage A, B, C · Current A, B, C · Active power A, B, C and total · Apparent power A, B, C and total · Power factor A, B, C · Total active energy (perpetual)
Compatible models
Shelly Pro 3EM
Last updated

Registers (61)

61 read, 0 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
Phase A meter errorRead
Phase B meter errorRead
Phase C meter errorRead
Neutral meter errorRead
Phase sequence errorRead
Neutral currentARead
Neutral current mismatchRead
Neutral overcurrent errorRead
Total currentARead
Total active powerkWRead
Total apparent powerVARead
Phase A voltageVRead
Phase A currentARead
Phase A active powerkWRead
Phase A apparent powerVARead
Phase A power factorRead
Phase A overpower errorRead
Phase A overvoltage errorRead
Phase A overcurrent errorRead
Phase B voltageVRead
Phase B currentARead
Phase B active powerkWRead
Phase B apparent powerVARead
Phase B power factorRead
Phase B overpower errorRead
Phase B overvoltage errorRead
Phase B overcurrent errorRead
Phase C voltageVRead
Phase C currentARead
Phase C active powerkWRead
Phase C apparent powerVARead
Phase C power factorRead
Phase C overpower errorRead
Phase C overvoltage errorRead
Phase C overcurrent errorRead
Total active energy accumulated for all phases - perpetual countkWhRead
Total active returned energy accumulated for all phases - perpetual countkWhRead
Phase A total active energykWhRead
Phase A fundamental active energykWhRead
Phase A total active returned energykWhRead
Phase A fundamental active returned energykWhRead
Phase A lagging reactive energyVARhRead
Phase A leading reactive energyVARhRead
Phase A total active energy - perpetual countkWhRead
Phase A total active returned energy - perpetual countkWhRead
Phase B total active energykWhRead
Phase B fundamental active energykWhRead
Phase B total active returned energykWhRead
Phase B fundamental active returned energykWhRead
Phase B lagging reactive energyVARhRead
Phase B leading reactive energyVARhRead
Phase B total active energy - perpetual countkWhRead
Phase B total active returned energy - perpetual countkWhRead
Phase C total active energykWhRead
Phase C fundamental active energykWhRead
Phase C total active returned energykWhRead
Phase C fundamental active returned energykWhRead
Phase C lagging reactive energyVARhRead
Phase C leading reactive energyVARhRead
Phase C total active energy - perpetual countkWhRead
Phase C total active returned energy - perpetual countkWhRead

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.

Number of installations (optional)

Use cases

  • Monitor three-phase voltage, current, and power on a live dashboard for your customer's main distribution board.
  • Track total accumulated energy consumption over time to support billing or energy audits.
  • Create an alert when power factor on any phase drops below a defined threshold for more than five minutes.
  • Compare per-phase load distribution to identify imbalance issues in commercial installations.
  • Log active and apparent power data to generate monthly energy reports for facility managers.
  • Detect metering errors remotely by monitoring the per-phase and total error status registers.

Installation

  1. Mount the Shelly Pro 3EM on the DIN rail inside the distribution board and connect the current transformers and voltage references according to the Shelly wiring guide.

  2. Connect the Shelly Pro 3EM to the local network via Ethernet or Wi-Fi, then assign it a static IP address or a DHCP reservation.

  3. Open the Shelly web interface or app, navigate to the Modbus TCP settings, and enable the Modbus TCP server on the default port 502.

  4. Update the Shelly Pro 3EM firmware to the latest version (1.0 or higher) to ensure all register values are available.

  5. In the ModbusCloud portal, add a new Modbus TCP device on your gateway, enter the meter's IP address and port, and import the Shelly Pro 3EM template.

  6. Verify that all registers return valid data in the ModbusCloud live view before finalizing the installation.

Things to watch for

Some registers return zero or no data. What should I check?

Update the Shelly Pro 3EM firmware to version 1.0 or later. Earlier firmware versions were missing certain register values. After the update, power-cycle the device and re-read the registers.

What data encoding do the registers use?

All measurement registers use float32 encoding, meaning each value spans two consecutive 16-bit Modbus registers. The template already accounts for this, so no manual byte-order configuration is needed.

Do I need RS-485 wiring between the gateway and the meter?

No. The Shelly Pro 3EM uses Modbus TCP over Ethernet or Wi-Fi. The ModbusCloud gateway and the meter only need to be on the same IP network.

Can I use this template with other Shelly energy meters?

The template is based on the Shelly EM and EMData register specification and has been tested on the Shelly Pro 3EM. Other Shelly meters sharing the same register map may work, but verify against the official Shelly documentation before deploying.

More TCP templates

Want to see how it works?

Electrician working in an open distribution board