npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

iobroker.solintec

v0.1.0

Published

ioBroker adapter for Solinteg MHT-25~50K-100 hybrid inverters with Dyness STACK100 battery, via local Modbus TCP.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

bluefoxbluefoxbuestebueste

Keywords

ioBrokersolintegdynessstack100modbusinvertersolarphotovoltaikpvbattery

Readme

Logo

ioBroker.solintec

NPM version Downloads Test and Release

Reads PV, grid/meter and battery data from a Solinteg MHT-25~50K-100 hybrid inverter (25-50 kW, three-phase) with a Dyness STACK100 battery (51.2 kWh, connected to the inverter via CAN/RS485) over local Modbus TCP. No cloud account, no internet access required.

Table of contents

Why this adapter?

There is no generic "Solinteg" support in ioBroker. The Solinteg WR speaks openly documented Modbus TCP, so it could in principle be read out with the generic ioBroker.modbus adapter and a manually entered register list - but that means re-entering 50+ registers by hand in the admin UI, with no code-level control over scaling, data types or object structure. This adapter instead talks Modbus TCP directly (via modbus-serial), the same way ioBroker.zeptrion, ioBroker.goodwe-sems and ioBroker.husqvarna-automower-connect each talk directly to their respective device/cloud API, giving full control over register mapping, scaling and the resulting object tree - plus the option to actively control the inverter/battery (EMS write access, off by default).

Register source and limitations (please read)

Register addresses in lib/registers.js are sourced from the official Solinteg Modbus TCP protocol documentation, cross-checked against wills106/homeassistant-solax-modbus (custom_components/solax_modbus/plugin_solinteg.py), which documents the identical INTEG-M register family also used by Wattsonic and M-TEC Energy Butler rebrands.

These addresses have not yet been verified against real hardware. Before relying on this adapter, check the first poll's results carefully, in particular:

  • Byte/word order for u32/s32 registers (PV power, AC power, battery power, energy totals)
  • The exact location and effect of the EMS control registers (50xxx/52xxx block) before enabling EMS write access

Dyness battery cell-level detail beyond min/max cell voltage (16 individual cell voltages per module) is not available over Modbus at the inverter - only min/max cell voltage and their cell IDs are exposed there. Full per-cell detail requires the separate Dyness Cloud API/MQTT (ems.dyness.com Developer Center), which this adapter does not implement.

Installation

Once this adapter is listed in the official ioBroker adapter repository, install it the normal way: Admin -> Adapters -> search for "solintec" -> install.

Until then, an ioBroker administrator can add it manually on the ioBroker host:

iobroker url iobroker.solintec

Configuration

| Tab | Setting | Description | | --- | --- | --- | | Connection | Host / IP address | IP or hostname of the inverter (or Modbus TCP/RTU gateway) | | Connection | Port | Modbus TCP port, usually 502 | | Connection | Unit ID | Modbus slave/unit ID, usually 1 | | Connection | Request timeout | Timeout per Modbus request, in seconds | | Polling | Fast poll interval | How often power/flow values (PV, grid, battery) are read (default 5s) | | Polling | Slow poll interval | How often energy counters and diagnostics are read (default 30s) | | EMS control | Enable EMS write access | Off by default - see EMS write access |

Object/state structure

solintec.0.info.connection                 Inverter reachable (bool)
solintec.0.info.lastSuccess                Timestamp of the last successful poll
solintec.0.info.lastError                  Last error message

solintec.0.info.serialNumber / .firmwareVersion
solintec.0.diag.inverterStatus / .faultFlags1-3 / .radiatorTemperature

solintec.0.pv.string1-4.voltage / .current / .power
solintec.0.pv.totalPower

solintec.0.grid.acPower / .frequency
solintec.0.grid.voltageL1-3 / .currentL1-3

solintec.0.meter.power / .powerL1-3
solintec.0.meter.gridImportTotal / .gridExportTotal

solintec.0.battery.voltage / .current / .power / .soc / .soh / .temperature
solintec.0.battery.minCellVoltage / .maxCellVoltage (+ their cell IDs)
solintec.0.battery.chargeLimit / .dischargeLimit
solintec.0.battery.chargeToday / .chargeTotal / .dischargeToday / .dischargeTotal
solintec.0.battery.manufacturer / .ratedCapacity

solintec.0.energy.pvGenerationToday / .pvGenerationTotal
solintec.0.energy.houseConsumptionToday / .houseConsumptionTotal

solintec.0.ems.*                           EMS control registers, see below

All PV/grid/meter/battery power-flow states are polled at the fast interval; energy counters, diagnostics and EMS registers are polled at the slow interval.

EMS write access (controlling the inverter/battery)

The ems.* states (working mode, charge/discharge power target, import/export limits, battery SOC protection limits, ...) are always read, so you can see the inverter's current EMS configuration regardless of this setting. Writing to them is disabled by default: any attempted write is logged and ignored until "Enable EMS write access" is turned on in the instance configuration.

Only enable this if you actively want to control the inverter/battery (e.g. schedule charge/discharge power, cap grid export). Getting a register or scaling wrong here can put the inverter into an unintended operating mode - see Register source and limitations.

Polling and efficient reads

lib/blocks.js merges adjacent (or near-adjacent, small-gap) registers into as few readHoldingRegisters() calls as possible per poll cycle, instead of one Modbus request per register. Fast-group and slow-group registers are blocked independently and polled on their own interval.

Security & privacy

  • The adapter performs Modbus TCP against a device on your local network - no cloud account, no external API, no credentials to store.
  • EMS write access (the only functionality that can change the inverter's behavior) is disabled by default and must be explicitly enabled.
  • Written values are range-checked against each register's documented min/max before being sent.

Development

npm install
npm run lint
npm test          # unit tests (lib/registers.js, lib/modbusClient.js, lib/blocks.js) + package consistency check

Recommended additionally before every release:

npx @iobroker/repochecker@latest .

Pull requests are welcome, especially to verify/correct register addresses against real hardware, or to improve translations (currently English/German are complete; the other 9 languages use English text as a placeholder).

Changelog

0.1.0 (2026-08-15)

  • Initial release: reads PV, grid/meter and battery values from a Solinteg MHT-25~50K-100 hybrid inverter (Dyness STACK100 battery via CAN/RS485) over local Modbus TCP. Optional EMS write access is disabled by default.

License

MIT License

Copyright (c) 2026 Stefan Bühler

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.