Skip to content

Repository files navigation

DESS Monitor — Home Assistant integration

Cloud-backed integration for inverters / hybrid solar systems sold under the SmartESS, EnergyMate, Fronus Solar mobile apps, and the dessmonitor.com / eybond.com web monitor.

It talks to the cloud over REST + WebSocket and exposes:

  • Canonical sensors — battery / grid / PV / load / energy totals, normalized across firmwares.
  • Direct-protocol sensors — Axpert (PI30), InfiniSolar PI18, and SMG2 Modbus RTU, relayed through the cloud's HEX transport.
  • Writable settings — output priority, max charging current, voltage thresholds, etc. (Number / Select entities).
  • Virtual battery — Coulomb-counting SoC for inverters that don't publish capacity directly.
  • Optional WebSocket push — sub-cadence updates for power sensors when the account has the paid "fast data" add-on.

📚 Documentation

  • Wiki — supported devices, FAQ, troubleshooting, recipes.
  • Configuration guide — every option in the config / options flow, recommended profiles, virtual-battery tuning, migration notes.

Installation via HACS (recommended)

🎉 The repository is in the HACS default community store.

Search for DESS Monitor in HACS and install it directly.

If it isn't listed, add the repo manually:

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Or for HACS 2.0+:

  1. Open the HACS panel.
  2. Three-dot menu → Custom Repositories.
  3. Add:
    • URL: https://github.com/Antoxa1081/home-assistant-dess-monitor
    • Type: Integration
  4. Click Add, then install DESS Monitor from the store.
  5. Restart Home Assistant.

Then Settings → Devices & Services → Add Integration → DESS Monitor.

Minimum Home Assistant version: 2024.11


Features at a glance

Area What you get
Cloud REST polling Live data + energy flow + parameter catalog (queryDeviceParsEs) on configurable cadence.
WebSocket push Optional push updates for power sensors (paid "fast data" account add-on required).
Direct protocols axpert (PI30 ASCII) · pi18 (InfiniSolar) · smg2_modbus (RTU). Selectable per entry.
Dynamic settings Writable Number / Select entities for inverter configuration values.
Virtual battery Per-device capacity (Ah), full voltage, chemistry → SoC + power sensors.
Diagnostics Built-in HA diagnostics download (auto-redacted). Optional freshness sensors (Last Sample Time, WebSocket Last Frame At).

See the Configuration guide for every option and recommended profile.


Tested devcodes

2341, 2376, 2428 and others reported by the community — see the Wiki for the up-to-date list.

If your inverter isn't recognized or a value looks wrong, please open an issue with a diagnostics file attached (Settings → Devices & Services → Dess Monitor → ⋮ → Download diagnostics). Include the inverter model and devcode (visible on the device page).


Want true local polling? — sister integration

This integration goes through the dessmonitor.com cloud. If you want to bypass the cloud and poll the inverter directly over the local network / serial link:

Speaks the native protocols (Axpert / PI18 / SMG2 Modbus) locally — no account, no rate limits, sub-second updates. Both integrations can coexist.


Related projects


About

Home Assistant integration for monitoring DESS inverters

Topics

Resources

Stars

74 stars

Watchers

8 watching

Forks

Releases

Packages

Used by

Contributors

Languages