ioBroker.iometer

iometer adapter for ioBroker

This adapter requires at least Node.js 22.x!

Connects ioBroker to the IOmeter smart metering device and provides real-time electricity readings via Server-Sent Events (SSE). Meter readings and device status are updated live as soon as the device reports them.

Install

Install this adapter via ioBroker Admin:

Open the adapter list and search for IOmeter
Click Install
Create an instance of the IOmeter adapter
Enter the IP address of your IOmeter device and save
The connection to the device is established automatically and the data is stored in the corresponding chanels

Configuration

IOmeter IP Address

The local IP address of your IOmeter device (e.g. 192.168.1.100). This can be found in the device infos in the IOmeter app.

The adapter connects to http://<ip>/v1/reading and http://<ip>/v1/status via SSE. Both streams reconnect automatically if the connection is lost.

States

The adapter creates state objects dynamically on the first received event. The meter number reported by the device is used as a channel prefix to distinguish in case of multiple instances for diiferent meters.

State IDs follow the format:

iometer.<instance>.<channel>-<meterNumber>.<state>

<instance> — ioBroker adapter instance index (usually 0)
<channel> — either reading (meter data), device (hardware status) or info (connection status)
<meterNumber> — the meter serial number as reported by the device (e.g. 1ISK04051904)
<state> — the individual data point (see below)

Reading channel (`reading-<meterNumber>`)

Populated from the /v1/reading SSE stream (event type readingEvent).

State	Type	Unit	Role	Description
`power`	number	W	`value.power.active`	Current total active power. Uses the sum OBIS value when available, falls back to Phase 1 for single-phase meters.
`power_phase1`	number	W	`value.power.active`	Active power on Phase L1
`power_phase2`	number	W	`value.power.active`	Active power on Phase L2
`power_phase3`	number	W	`value.power.active`	Active power on Phase L3
`energy_imported`	number	kWh	`value.energy.consumed`	Total imported energy
`energy_exported`	number	kWh	`value.energy.produced`	Total exported energy
`energy_imported_t1`	number	kWh	`value.energy.consumed`	Imported energy — Tariff 1
`energy_imported_t2`	number	kWh	`value.energy.consumed`	Imported energy — Tariff 2

Device channel (`device-<meterNumber>`)

Populated from the /v1/status SSE stream (event type statusEvent).

State	Type	Unit	Role	Description
`id`	string	—	`info.serial`	Unique device ID
`meter_number`	string	—	`info.serial`	Meter serial number
`bridge_rssi`	number	dBm	`value`	WiFi signal strength of the bridge module
`bridge_firmware`	string	—	`info.firmware`	Firmware version of the bridge module
`core_rssi`	number	dBm	`value`	RF signal strength between core and bridge
`core_firmware`	string	—	`info.firmware`	Firmware version of the core module
`battery_level`	number	%	`value.battery`	Battery level of the core module
`power_status`	string	—	`info.status`	Power supply status (e.g. `wired`, `battery`)
`attachment_status`	string	—	`info.status`	Attachment status of the core module

Connection state

State	Description
`info.connection`	`true` when the reading stream is receiving data, `false` otherwise

Changelog

0.0.6 (2026-08-20)

(torben-iometer) Fixed the adapter crashing on startup with ERR_PACKAGE_PATH_NOT_EXPORTED on installations where an older @iobroker/adapter-core version got hoisted into node_modules.

0.0.5 (2026-08-19)

(torben-iometer) Sanitized meter numbers before using them in object IDs to prevent invalid states when the device reports characters that are not allowed in ioBroker IDs.
(torben-iometer) Tightened the IP address validator in the adapter settings to reject invalid octets (e.g. 999.999.999.999).
(torben-iometer) Improved error logging for the reading/status streams to show the actual error message instead of an unhelpful JSON dump.
(torben-iometer) Added missing translations for the adapter description.
(torben-iometer) Removed the unused visualization widget stub.

0.0.4 (2026-08-10)

(torben-iometer) Changed the state role for bridge_rssi and core_rssi from the non-existent value.rssi to the generic value role.

0.0.3 (2026-08-07)

(torben-iometer) Fixed the release workflow (removed the broken Sentry release step, corrected the repository URL format) and the outdated Node.js version requirement in the README.

0.0.2 (2026-08-07)

(ioBroker-Bot) Adapter requires admin >= 7.8.23 now.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

IOmeter