Tests: 
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.
- ioBroker with the
sigenergyadapter installed and configured - ioBroker VIS-2 adapter (≥ 2.0.0)
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
| 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 | — |
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
Compact list view of all current power values with colour-coded direction indicators.
OIDs: pvPower, essPower, gridActivePower, housePower, essSoc
Daily overview with autarky rate, self-consumption, SOC history, charge/discharge energy and battery coverage.
OIDs: autarkyRate, selfConsumptionRate, dayMaxSoc, dayMinSoc, essDailyChargeEnergy, essDailyDischargeEnergy, batteryCoverageToday, batteryDailyChargeTime
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
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
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
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).
| 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
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 |
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.
| 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 |
| 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
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.
| Charge level | Colour |
|---|---|
| ≤ 15 % | Red (#f87171) |
| ≤ 35 % | Yellow (#fbbf24) |
| > 35 % | Green (#4ade80) |
| 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
All widgets support a light and dark mode, switchable via the widget setting Dark mode.
- (ssbingo) Declared minimum requirements: js-controller >=6.0.11, admin >=8.0.0, Node.js >=22
- (ssbingo) Updated dependencies: actions/checkout 7.0.1, ioBroker/testing-action-deploy 1.5.2, @iobroker/testing 5.3.0
- (ssbingo) Updated CI actions: actions/checkout to v7.0.0, ioBroker/testing-action-deploy to v1.5.0
- (ssbingo) Fixed JSON syntax error in io-package.json; added widget screenshot to documentation
- (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
- (ssbingo) Removed obsolete .eslintrc.json and .prettierignore
- (ssbingo) Added ESLint linting, updated CI to Node.js 24; adapter requires node.js >= 22
- (ssbingo) Text no longer distorts under non-uniform scaling — letters keep their proportions while containers continue to fill the widget area
- (ssbingo) Scaling is now non-uniform: width and height react independently to container changes, keeping both axes individually adjustable
- (ssbingo) Widget scaling now also reacts to height changes — content scales proportionally on both axes and is centered within the widget
- (ssbingo) All 9 widgets now scale their content responsively with the widget size (fonts, padding, SVG, images)
- (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
- 🇬🇧 English — this file
- 🇩🇪 Deutsch
- 🇷🇺 Русский
- 🇳🇱 Nederlands
- 🇫🇷 Français
- 🇮🇹 Italiano
- 🇪🇸 Español
- 🇵🇱 Polski
- 🇵🇹 Português
MIT License
Copyright (c) 2026 ssbingo s.sternitzke@online.de
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.