This page is mainly for Home Assistant users with an Elveta-branded real-time dongle, for example one bought in the Elveta shop. If you got your real-time dongle from your electricity company, contact them to have the local real-time data port enabled for Home Assistant.
Elveta real-time dongle ES32 (P1 and HAN meters) and ES3K (Kamstrup OMNIPOWER®) have a local real-time data port. When it is enabled, the dongle streams meter data directly over your own Wi-Fi network, and Home Assistant reads it using its built-in DSMR Smart Meter integration. No Elveta portal, app, or internet connection is involved while it runs.
The dongle always sends P1 ASCII data on the local port, regardless of whether your electricity meter has a P1 port or a HAN port. The dongle reads the meter's HAN data and converts it to P1 format. That's why Home Assistant can read HAN meters, including Kamstrup OMNIPOWER®, through an Elveta real-time dongle, even though the DSMR integration can't read HAN ports directly.
You can buy the dongle directly from Picofrost in the Elveta shop, for 995 SEK with free shipping within Sweden.
Open Elveta Connect, tap the gear icon on the start screen, and turn on Advanced setup. This adds an extra step to onboarding where you configure the local data port.
Tap "Next" in Elveta Connect. When your phone asks, allow the app to use the camera, to scan the QR code, and nearby devices, to connect to the dongle over Bluetooth. Then scan the QR code printed on the dongle's label. If the camera can't read it, tap "Or enter the code manually" and type in the Device ID and PIN code from the label.
When the app asks you to plug in the dongle, install it in the electricity meter as described below for your model.
Connect the real-time dongle to the electricity meter's customer port with the supplied cable: the RJ12 cable if the meter has a P1 port, or the RJ45 cable if it has a HAN port. The real-time dongle is normally powered by the electricity meter. If its LED stays off, the meter can't supply enough power; connect a USB-C charger to the real-time dongle.
Remove the plastic cover over the module slot at the top of the Kamstrup OMNIPOWER® meter. If the cover is sealed, ask your local electricity network operator for permission before you remove it. Slide the real-time dongle carefully into the slot so that it connects to the meter's internal connector, as shown in the picture. When inserted, give it an extra push to make sure it is fully inserted into the slot. The real-time dongle is powered by the electricity meter, so no cable is needed.
Wait for a steady blue light, which means the dongle is ready to pair, and tap "Next". It can take up to two minutes before the blue light turns on; until then, the dongle lights up yellow. You can mount the dongle on the wall inside the electrical cabinet; strong magnets keep it in place. Place it with as few objects as possible between the dongle and your Wi-Fi access point, and turn the antenna so that its long side "points" toward the access point. If the meter is in a metal cabinet, see Reliable Wi-Fi From a Metal Meter Cabinet and How to Point Your Antenna. More details about each meter are on Connecting to Electricity Meters.
The app tells you that your phone will ask to pair with the dongle. Tap "Next". The app then looks for the dongle and connects to it, which can take up to 20 seconds. If your phone shows a pop-up asking to pair with the dongle, accept it; setup cannot continue without it.
Right after pairing, the app shows the Local data port step. Turn on Enable local data port and enter a port number, or keep the default, 2001. Make a note of the port number; you need it in Home Assistant.
Choose your 2.4 GHz Wi-Fi network and enter the password. The dongle restarts and joins your network; keep the app open until it shows "Setup done". The port setting is stored in the dongle and is kept when it restarts.
Until Home Assistant connects, the LED shows steady purple if the dongle has joined your Wi-Fi. The LED shows steady green when data is coming from the meter and Home Assistant is connected to the dongle. If the LED is blinking green, Home Assistant is connected but there is no data from the electricity meter, usually because the customer port is not activated yet. See Status Indications for more information about the LED status.
Look up the dongle in your router's list of connected devices and note its IP address, for example 192.168.1.100. IMPORTANT: Create a DHCP reservation for it so the address stays the same over time.
| Setting | Value |
|---|---|
| Connection type | Network |
| Host | The dongle's IP address, for example 192.168.1.100 |
| Port | The port number from step 6 (default 2001) |
| DSMR version | 5S (Nordic countries), for both P1 and HAN meters. For other countries, see the Home Assistant installation guide. |
Alternatively, choose Serial as the connection type, select Enter manually, and enter a connection string in the format socket://<IP address>:<port>, for example socket://192.168.1.100:2001.
Home Assistant creates the sensors and starts updating them as the meter sends new data. If the dongle or Home Assistant restarts, Home Assistant reconnects to the dongle by itself.
Home Assistant disables some of the DSMR sensors by default, so it can look as if some meter data is missing. Go to Settings > Devices & services > DSMR Smart Meter and open the list of entities. Disabled sensors are marked as disabled; to enable one, select it, open its settings, and turn on Enabled.
When you have enabled the sensors you need, restart Home Assistant completely under Settings > System, using the power button at the top right. Reloading only the DSMR integration is not enough. The real-time dongle does not need to be restarted.
Under Settings > Dashboards > Energy, add the imported energy sensor as grid consumption and the exported energy sensor as return to grid.
| Problem | Solution |
|---|---|
| The LED stays off | The meter can't supply enough power to the ES32. Connect a USB-C charger to the real-time dongle. |
| The LED is steady purple | Home Assistant is not connected. Check the host and port in the DSMR integration (steps 6 and 8), and that Home Assistant and the dongle are on the same network, not a guest network or separate VLAN. |
| The LED is blinking green | No data is coming from the electricity meter. Usually the customer port is not activated yet; contact your local electricity network operator. Also check the connection to the meter (step 3). |
| Home Assistant can't connect, or stops getting data after you change the integration | The local data port accepts only one connection. Restart the dongle by disconnecting its power and connecting it again. |
| Some sensors seem to be missing | Home Assistant disables some DSMR sensors by default. Enable the ones you need and restart Home Assistant (step 10). |
| Total sensors stop updating while the per-phase sensors keep updating | Restart Home Assistant completely under Settings > System. Reloading the DSMR integration may not be enough, and the dongle does not need to be restarted. |
For what the other LED colors mean, see Status Indications.
All data values sent from the electricity meter are presented on the local real-time data port. No values are filtered out. Exactly which values you get therefore depends on your meter and your local electricity network operator. Swedish meters typically send the values below, usually every 10 seconds.
| Value | OBIS code | Unit |
|---|---|---|
| Meter date and time | 0-0:1.0.0 | - |
| Accumulated imported active energy | 1-0:1.8.0 | kWh |
| Accumulated exported active energy | 1-0:2.8.0 | kWh |
| Accumulated imported / exported reactive energy | 1-0:3.8.0 / 1-0:4.8.0 | kvarh |
| Current imported / exported active power | 1-0:1.7.0 / 1-0:2.7.0 | kW |
| Current imported / exported reactive power | 1-0:3.7.0 / 1-0:4.7.0 | kvar |
| Imported / exported active power per phase (L1, L2, L3) | 1-0:21.7.0, 41.7.0, 61.7.0 / 1-0:22.7.0, 42.7.0, 62.7.0 | kW |
| Imported / exported reactive power per phase (L1, L2, L3) | 1-0:23.7.0, 43.7.0, 63.7.0 / 1-0:24.7.0, 44.7.0, 64.7.0 | kvar |
| Voltage per phase (L1, L2, L3) | 1-0:32.7.0, 52.7.0, 72.7.0 | V |
| Current per phase (L1, L2, L3) | 1-0:31.7.0, 51.7.0, 71.7.0 | A |
Home Assistant creates sensors for the values the DSMR integration recognizes for version 5S. These include accumulated imported and exported energy, current power import and export, and voltage, current, and power per phase.
To see the raw data, connect to the port from a computer on the same network, for example with nc 192.168.1.100 2001. Every telegram starts with a line beginning with / and ends with ! followed by a checksum. A shortened example (the identification line and values differ between meters):
/ELL5\253833635_A 0-0:1.0.0(261012101530S) 1-0:1.8.0(00006678.394*kWh) 1-0:2.8.0(00000000.000*kWh) 1-0:1.7.0(0001.727*kW) 1-0:2.7.0(0000.000*kW) 1-0:21.7.0(0001.023*kW) 1-0:32.7.0(0230.4*V) 1-0:31.7.0(004.4*A) !7945
When you enable the local data port in Elveta Connect, the dongle stops sending meter data to the Elveta cloud: the readings from your electricity meter (energy, power, voltage, current, and so on) only go to Home Assistant on your local network. The dongle still keeps in touch with the Elveta cloud server, so that it can receive firmware updates and report how it is doing. All traffic to the cloud is encrypted (HTTPS). This is exactly what it sends:
A short status report, sent after each start and then about every 10 minutes, containing:
Short text messages when something noteworthy happens, for example when a firmware update fails. Each one carries the dongle's device ID.
There is one exception where meter data can reach the cloud: if the dongle receives a message from the meter that has a correct checksum but that it cannot decode, it sends that message as is, so that support for the meter's format can be added. Such a message contains the meter's readings at that moment. This only happens with meter data formats the dongle does not recognize.
You can buy the Elveta real-time dongle directly from Picofrost in the Elveta shop (elveta.se/shop): ES32-1-RJ12 for P1 meters, ES32-1-RJ45 for HAN meters, and ES3K-1 for Kamstrup OMNIPOWER® meters. Private customers pay 995 SEK including VAT, with free shipping; business customers pay 995 SEK excluding VAT, plus 69 SEK shipping. The shop currently ships to Sweden only, and sells the dongle for use with Home Assistant only. For any other use, the dongle is sold through electricity companies.
When the local data port is enabled, no electricity consumption data from the meter is sent to the Elveta cloud, and local reading keeps working even if you block the dongle's internet access. The local data port setting is stored in the dongle, so it starts streaming again by itself after a restart, and Home Assistant reconnects automatically. The dongle keeps working when the internet connection is lost. Internet access for the dongle is not required when local port is enabled but is strongly recommended in order to receive firmware upgrades. The dongle does still send status reports and log messages to the Elveta cloud; see What the Dongle Sends to the Cloud for exactly what they contain.
More questions? See Questions & Answers or contact us.
Would you like to know more? Please contact us below.
Elveta is developed and operated by Picofrost AB. Read more at www.picofrost.com
+46 10-430 03 14
Täby, Sweden