ioBroker.vis-2-widgets-sigenergy

Tests:

vis-2-widgets-sigenergy adapter for ioBroker

VIS-2 widget set for the Sigenergy energy storage adapter (ioBroker.sigenergy). Contains 8 widgets for visualisation and control of energy flow, battery status, real-time power, daily statistics, AC charger, DC charger, inverter and SigenMicro micro-inverter overview.

Requirements

• ioBroker with the sigenergy adapter installed and configured
• ioBroker VIS-2 adapter (≥ 2.0.0)

Widgets

Energy Flow Diagram

Displays the current energy flow between solar panels, battery, grid and house as an animated SVG diagram. Animated arrows visualise active connections in real time.

OIDs: pvPower, essPower, gridActivePower, housePower, essSoc

Flow directions

| Data point | Value > 0 | Value < 0 | |---|---|---| | essPower | Battery charging → arrow from centre to battery | Battery discharging → arrow from battery to centre | | gridActivePower | Grid consumption → arrow from grid to centre | Grid feed-in → arrow from centre to grid | | pvPower | PV producing → arrow from PV to centre | — | | housePower | House consuming → arrow from centre to house | — |

Battery Status & Forecasts

Displays SOC, SOH, charging power and forecasts for time to full charge, remaining runtime, self-consumption and autarky rate.

OIDs: essSoc, essSoh, essPower, batteryTimeToFull, batteryTimeRemaining, selfConsumptionRate, autarkyRate

Real-Time Power

Compact list view of all current power values with colour-coded direction indicators.

OIDs: pvPower, essPower, gridActivePower, housePower, essSoc

Energy Statistics

Daily overview with autarky rate, self-consumption, SOC history, charge/discharge energy and battery coverage.

OIDs: autarkyRate, selfConsumptionRate, dayMaxSoc, dayMinSoc, essDailyChargeEnergy, essDailyDischargeEnergy, batteryCoverageToday, batteryDailyChargeTime

AC Charger (Sigen EVAC)

Monitoring and control of the Sigenergy AC charger (EVAC). Shows charging power, system state, rated power, rated current and total energy consumed. Alarms are highlighted in colour. The charging current can be set directly via a slider (6–32 A).

OIDs: acCharger.systemState, acCharger.chargingPower, acCharger.totalEnergyConsumed, acCharger.ratedPower, acCharger.ratedCurrent, acCharger.alarm1/2/3, acCharger.control.startStop, acCharger.control.outputCurrent

DC Charger

Monitoring and control of the Sigenergy DC charger. Shows output power, vehicle SOC with progress bar, vehicle battery voltage, charging current and the energy and duration of the current charging session.

OIDs: dcCharger.outputPower, dcCharger.vehicleSoc, dcCharger.vehicleBatteryVoltage, dcCharger.chargingCurrent, dcCharger.currentChargingCapacity, dcCharger.currentChargingDuration, dcCharger.control.startStop

Inverter

Comprehensive monitoring and control of the inverter with tab navigation. Displays operating state, power data, battery temperatures, phase voltages, all 5 alarm registers and device information (model, serial number, firmware).

| Tab | Content | |---|---| | Power | Active power, PV power, battery charge/discharge power, power share slider (−100 % to +100 %) | | Battery | SOC & SOH with bars, avg. cell temperature/voltage, max./min. temperature | | Grid | Phase voltages L1/L2/L3, grid frequency, power factor, PCS internal temperature | | Alarms | 5 alarm registers (PCS ×2, ESS, gateway, DC charger) with hex code and colour marking | | Info | Model type, serial number, firmware version, Remote-EMS toggle |

OIDs: inverter.activePower, inverter.pvPower, inverter.essChargeDischargePower, inverter.runningState, inverter.essBatterySoc/Soh, inverter.essAvgCellTemperature/Voltage, inverter.phaseA/B/CVoltage, inverter.gridFrequency, inverter.pcsInternalTemp, inverter.alarm1–5, inverter.firmwareVersion, inverter.modelType, inverter.serialNumber, inverter.control.startStop, inverter.control.remoteEmsDispatchEnable, inverter.control.activePowerPercent

PV Power

Display of up to 3 PV strings with live power values and animated flow arrows leading to the hybrid inverter. Arrow colours change dynamically based on power level (orange <1 kW, yellow <2 kW, green >2 kW).

Widget settings

| Parameter | Type | Default | Description | |---|---|---|---| | oid_pv1 … oid_pv3 | OID | sigenergy.0.plant.pv1Power … pv3Power | PV string power OIDs | | oid_pvtotal | OID | sigenergy.0.plant.pvPower | Total PV power OID | | sig_title | text | PV Power | Widget title | | sig_name1 … sig_name3 | text | String 1 … String 3 | Configurable names per string | | sig_darkmode | checkbox | true | Dark / Light mode |

OIDs: plant.pv1Power, plant.pv2Power, plant.pv3Power, plant.pvPower

SigenMicro Overview

Overview and detail view of all SigenMicro micro-inverters connected via Modbus. Tab 1 shows all devices as an animated network segment (Ethernet bus topology with vertical drop lines). Each additional tab shows all 15 registers of the respective device in ascending order.

| Tab | Content | |---|---| | Overview | All devices as animated bus topology, aggregate tiles (total power, daily yield, lifetime yield, online count) | | Device 01–20 | Device image top-left (10 px offset), model/serial/firmware/status badge, all 15 registers (01–15) with value, unit and OID path |

Network segment animation

The horizontal backbone line and the vertical drop lines show animated dashes that flow along the cables when a device is active (Running). Inactive devices (Standby/Fault) show only the dark base line without animation.

Dynamic layout

| Devices | Rows | Image size | |---|---|---| | 1–5 | 1 row | 80 × 90 px | | 6–10 | 1 row | 52 × 60 px | | 11–15 | 2 rows | 46 × 52 px | | 16–20 | 2 rows | 40 × 46 px |

Widget settings

| Parameter | Type | Default | Description | |---|---|---|---| | micro_count | number (1–20) | 3 | Number of micro-inverters to display | | sig_title | text | SigenMicro Micro-Inverter | Widget title | | sig_darkmode | checkbox | true | Dark / Light mode | | oid_micro1 … oid_micro20 | OID | — | Anchor OID per device (e.g. sigenergy.0.sigenmicro.11.outputPower) |

OIDs (per device, prefix sigenergy.0.sigenmicro.): modelType, serialNumber, firmwareVersion, runningState, outputPower, gridFrequency, temperature, mppt1Voltage, mppt1Current, mppt1Power, mppt2Voltage, mppt2Current, mppt2Power, dailyYield, totalYield

Vehicle Charge Level (EV SOC)

Displays a configurable vehicle image (e.g. Fiat 500e) as the central visual element. A colour-coded badge in the top-right corner shows a lightning bolt, the current charge level in percent and the label "LADESTAND". A progress bar at the bottom reflects the current SOC. When the optional charging state is active, the badge emits a pulsing green glow.

Colour logic

| Charge level | Colour | |---|---| | ≤ 15 % | Red (#f87171) | | ≤ 35 % | Yellow (#fbbf24) | | > 35 % | Green (#4ade80) |

Widget settings

| Parameter | Type | Default | Description | |---|---|---|---| | oid_ev_soc | OID | — | State of Charge 0–100 | | oid_charging | OID | — | Charging state (optional) — green glow when active | | sig_title | text | Fahrzeug-Ladestand | Vehicle name shown below the image | | sig_car_image | image | — | Vehicle image from ioBroker file browser (e.g. /vis-2/img/) | | sig_darkmode | checkbox | true | Dark / Light mode |

OIDs: oid_ev_soc, oid_charging

Appearance

All widgets support a light and dark mode, switchable via the widget setting Dark mode.

Changelog

1.8.2 (2026-06-28)

• (ssbingo) Updated CI actions: actions/checkout to v7.0.0, ioBroker/testing-action-deploy to v1.5.0

1.8.1 (2026-06-08)

• (ssbingo) Fixed JSON syntax error in io-package.json; added widget screenshot to documentation

1.8.0 (2026-06-08)

• (ssbingo) New widget: "Fahrzeug-Ladestand" — shows a configurable EV image with animated SOC bar, color-coded charge level (red/yellow/green), and optional blinking charging badge

1.7.9 (2026-05-27)

• (ssbingo) Removed obsolete .eslintrc.json and .prettierignore

1.7.8 (2026-05-27)

• (ssbingo) Added ESLint linting, updated CI to Node.js 24; adapter requires node.js >= 22

1.7.7 (2026-04-20)

• (ssbingo) Text no longer distorts under non-uniform scaling — letters keep their proportions while containers continue to fill the widget area

1.7.6 (2026-04-20)

• (ssbingo) Scaling is now non-uniform: width and height react independently to container changes, keeping both axes individually adjustable

1.7.5 (2026-04-20)

• (ssbingo) Widget scaling now also reacts to height changes — content scales proportionally on both axes and is centered within the widget

1.7.4 (2026-04-20)

• (ssbingo) All 9 widgets now scale their content responsively with the widget size (fonts, padding, SVG, images)

1.7.3 (2026-04-20)

• (ssbingo) All 9 widgets now share a unified background based on the PV-Power widget design

Older changelog entries can be found in CHANGELOG_OLD.md

Older changelogs can be found there

Documentation

• 🇬🇧 English — this file
• 🇩🇪 Deutsch
• 🇷🇺 Русский
• 🇳🇱 Nederlands
• 🇫🇷 Français
• 🇮🇹 Italiano
• 🇪🇸 Español
• 🇵🇱 Polski
• 🇵🇹 Português

License

MIT License

Copyright (c) 2026 ssbingo [email protected]

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.