Shelly offers two kinds of metering hardware, each with its own protocol in the EMS.
Meters with CT clamps that measure a whole circuit. Select the Shelly Energy Meter API protocol.
| Device Type | Local API |
|---|---|
| Shelly Pro 3 EM (400) | ✅ |
| Shelly 3EM |
Switches with a built-in power meter, which measure the load wired to their relay output. Select the Shelly energy meter via switch (relay) component protocol: it only reads the metering values and never switches the relay. Use the Shelly relay integration instead when the EMS must be able to switch the load on and off.
| Device Type | Local API |
|---|---|
| Shelly Plus 1PM | ✅ |
| Shelly Plus 2PM | |
| Shelly Plus PM Mini | |
| Shelly Pro 1PM | |
| Shelly Pro 2PM | |
| Shelly Pro 4PM | |
| Shelly Plus Plug S | |
| Shelly 1PM Gen3 | |
| Shelly 1PM Mini Gen3 | |
| Shelly 2PM Gen3 |
Every switch with power metering is added as a separate meter, so a Shelly Pro 4PM results in four meters.
This integration has not been tested with all the devices listed above, however, since they all use the same communication protocol, they should work without issues.
The communication between the EMS and the Shelly relay is established via Local API (over TCP/IP). For proper Ethernet wiring, please follow the Ethernet wiring guidelines.
Power Supply Connections
Device Diagram
Refer to the diagram printed on the device for detailed wiring instructions. Ensure all connections match the diagram.
Wire the Device
Ensure the device is wired according to the provided wiring diagram and connect the Ethernet cable securely.
Access the Shelly Interface
Locate the Ethernet Settings
Note: Do not modify any settings while locating the Ethernet IP address.
By following these steps, you will retrieve the required IP address for integrating the Shelly relay with the EMS. For further details and comprehensive documentation, please refer to the official Shelly Installation Guides.