# Changelog
{% updates format="full" %}
{% update date="2026-04-28" %}
## Release Notes - April
### Security
#### New
* **Two-factor authentication (2FA)** is now available for added account security.
* We strongly recommend enabling it for all users.
***
### Reporting & insights
#### New consumption report
Available via the Energy Meters dashboard.
Includes:
* Totals and peak values per energy meter
* Totals per PV inverter
* Project-level totals
* Date range filtering
* Tariff scheme filtering (day/night)
* Export functionality
* Minute-level export for detailed internal settlement
***
### EMS Dashboard
#### New
* **Per-minute measurements** in daily view for more accurate visibility of peaks and fluctuations.
* New graph for:
* energy prices
* grid power
* New KPI blocks:
* **Self-supply rate**
* **Self-consumption rate**
#### Improved
* Updated graph UI for better readability.
* Smoother chart rendering.
* Filters moved closer to graphs.
* Improved labels for:
* Consumption
* Grid import
* Grid export
* Each battery now shows **SOC** in the energy flow diagram.
***
### Energy Management
#### New
* New battery load balancing strategies:
* Cascade
* Pro Rata
* Configurable in project settings.
* Grid capacity / contract power changes can now be:
* Applied immediately
* Scheduled for later execution
* Scheduled changes are automatically applied.
* Detection of deviations between battery setpoint and actual battery power.
* On each device, you can now configure whether the TCP connection must be exclusive or may be shared.
* Imbalance prices are now fully logged for all prices published by Elia in the context of market pricing.
* Purpose: market analysis to support development of proprietary control strategies.
***
### Incident Management
#### New
* Incidents now include severity levels:
* Info
* Warning
* Critical
* Open incidents can now be manually marked as resolved.
#### Improved
* Status icons better reflect open, muted, and severe incidents.
***
### Device Management
#### New support
* ABB EV chargers
* Fluvius P1 energy meters
* Sunny Tripower PV models
* Expanded support for SunSpec-compatible PV inverters
#### New
* Energy meter can be set as **main meter** directly during setup.
* Battery setup now requires minimum and maximum SOC values.
* Clear distinction between virtual and physical devices in the setup form.
#### Improved
* Additional tooltips added to input fields.
***
### Project Management
#### Improved
* Projects without devices are now more clearly highlighted in the project list.
* Net connection references / meter point IDs can now be managed.
* Improved validation and country-specific guidance added.
***
### PV & Energy Data
#### Improved
More consistent and accurate calculations for:
* battery state of charge
* PV production
* quarter-hour peaks
* consumption totals
* PV dashboard now correctly retains inverter selection between combined and individual views.
***
### API & Integrations
#### New
New integration API for partners and energy providers:
* Retrieve projects
* Energy meter data per quarter-hour
* Peak and interval values for external reporting and integrations
{% endupdate %}
{% update date="2026-03-31" %}
## Release Notes - March
### Partner Portal & Management
#### New
* New **Partner Portal** for improved collaboration and management.
* Partner information visible in the sidebar.
* Partner logo shown in the menu.
* Users can be invited via email to access the partner environment.
* Partner settings available per project.
* Website link added to partner profile.
#### Billing
* Overview of invoices.
* Overview of subscriptions.
* Export/download of subscription data.
* Partner billing details are now automatically prefilled during subscription checkout.
* Mandatory user consent checkbox when activating subscriptions.
***
### Project Management
#### New
* Direct navigation from project status icon to incidents.
* Firmware update prompt may appear when creating a new project.
* API key management moved to project settings.
#### Improved
* Grid settings in project configuration are now better structured.
***
### Device Management
#### New
* New **All Devices** page.
* Direct link to device settings.
* Filters by type + model.
* Per-device telecontrol can now be enabled/disabled individually.
* Manual device overrides with full history tracking.
#### New supported devices / brands
* PowerVault
* Eastron SDM630
* Etrel
* Siemens
* Growatt
* Risen Storage
#### Improved
* Reduced number of required fields when adding devices.
* Better prevention of duplicate devices.
***
### EMS Dashboard & Monitoring
#### New
* New **control mode** view.
* New **EV Charging Pro dashboard** for charging stations.
* Live data on dashboards:
* battery status
* real-time solar production
* charging status
* Daily PV forecast now visible in dashboards.
#### Improved
* Redesigned energy flow diagram.
* Improved layout.
* Better handling of long names.
* Battery State of Charge added.
* Higher refresh rate for the energy flow diagram.
***
### Solar / PV
#### New
* Incident created when PV production is missing for 2 hours while production is expected.
* Smarter PV forecasting using weather data and historical data.
* Nominal power and production capacity added to configuration.
* PV curtailment visualization in graphs.
* Display of total curtailed energy.
#### Improved
* More accurate solar forecasting.
* Inverter power is now taken into account in predictions.
* Nominal power can be auto-filled when adding PV installations.
* Improved fallback when weather or prediction data is unavailable.
***
### Energy Management
#### New
* Manual consumption planning input now available.
* Peak power split into:
* consumption
* injection
#### Improved
* Better handling of negative values in imbalance graphs.
* Clearer explanation for consumption planning inputs.
***
### API & Integrations
#### New
* Introduction of a general API with API key authentication.
* API endpoints for:
* devices
* curtailment
* calibration
* overrides
* incidents
* manual overrides
* Full API documentation available.
#### Improved
* Trevi integration now uses a separate certificate per project.
* Fix for ENTSO-E day-ahead prices when quarters are missing.
***
### General Improvements
* Faster user experience due to background controller updates.
* More reliable tooltips and graphs.
* Improved error messages for invalid email addresses.
* Grafana Pro dashboards are now refreshed daily to ensure the latest version is always available.
{% endupdate %}
{% update date="2026-02-20" %}
## Release Notes - February
#### EV Charger Support
* **New EV Charger module**: full support for EV chargers in the platform.
* **EV dashboard**: new overview page with charging stations and connectors, real-time power, donut chart, and SoC column.
* **Charging priority**: priority can be set per connector; changes are processed in a queue.
* **Integration**: EV chargers included in the EMS dashboard (block) and in consumption planning.
* In project settings, a **power boost reserve** can be configured. This buffer is built up to smooth peak loads from DC fast chargers.
#### Subscriptions and Invoicing
* **Subscription flow**: new “activate-subscription” structure with subscription plans.
* Management page to handle subscriptions and invoices.
* Possibility to adjust billing details for upcoming invoices.
#### EMS Dashboard and BMS Dashboard
* **Dashboard redesign**: renewed EMS dashboard with line chart and improved battery visualization.
* **Energy meters**: “show unmeasured” option for energy meters; device type calculator now uses active power.
* **EMS dashboard optimization**
#### Consumption Planning
* Interface to manually enter consumption planning.
* Plan additional consumption as recurring. For example, for machines that switch on at fixed times where sufficient energy must be buffered to smooth this consumption peak.
#### Incidents and Monitoring
* **Muted incidents**: incidents can be muted; muted incidents no longer count toward status/badges in the project overview.
* **New triggers**: incident for negative consumption; command that verifies whether PV production is actually generating when it should.
#### Device Support and Management
* **New brands/models**: Hite (PCS/BMS), Solis, Growatt, Socomec (energy meter), Schneider IEM3555 energy meter. Sunspec generic PV device; SCU BRES reverse PCS adapter; proxy for Gres BMS; Hite combiner box.
* **Adding devices**: wizard redesigned:
* Device properties are read live from the device.
* Check if the device is reachable during setup.
* Child devices are detected and offered for automatic addition (e.g., hybrid inverters).
* Support for multiple BMS devices per inverter.
* Improved validation and device configuration.
#### MCP (Model Context Protocol)
* **MCP server**: new MCP server with device search and resources. Currently in beta.
#### Strategy and Trading
* **Project strategy**: deadband as a project strategy setting.
#### Minor Adjustments and Improvements
* **UI/UX**: small design and padding fixes; horizontal scrolling on battery components (no mouse wheel); fixed scrolling in charts; copy-to-clipboard for hardware ID (HTTPS); phone number no longer required/unique in profile.
* **Forms**: improvements to General Settings, add device form, and user profile (including precognition, password saving); tooltips and visibility logic in device settings.
* **Charts**: hidden series filtered from tooltip; tooltip rendering fixed when first series is disabled; minimum y-axis set to 0; adjusted line width; check added when chart element is not found (no mount).
{% endupdate %}
{% update date="2026-01-31" %}
## **Release Notes – Web Application**
* Rework of the EMS dashboard
* Filter muted incidents from project overviews and the incidents item in the project menu
* Project filtering based on incidents now takes the muted status of incidents into account
* Project configuration: new fields added — power boost reserve (%) and deadband (kW)
* Fix for negative production values on the EMS dashboard
* Google Chat notification when creating new projects
* Data update: `total(Dis)ChargedWattHours` replaced by `consumptionWh` and `productionWh`
* Energy flow diagram now uses kW values read directly from the PCS, instead of V × A × cos φ
* Extended input validation for imbalance provider configuration
* Profile update: phone number is no longer required and no longer needs to be unique
* Fix for negative values on the EMS dashboard and energy meters
***
{% endupdate %}
{% update date="2026-01-06" %}
## Firmware versie 0.0.192
#### PV Curtailment Optimization
* Grid export limit is now implemented directly in PV inverter setpoint calculations.
* Improved curtailment handling for edge cases:
* negative injection price, positive consumption price
* negative injection price and negative consumption price
#### Battery Scheduling
* Added a new **“Charge at max power”** action type to the battery schedule.
* Introduced an explicit action to charge the battery at maximum available power.
* `compensate_pv_surplus` is now actively scheduled instead of defaulting to idle behavior.
#### Control Logic Improvements
* Added a dead zone to self-supply control to prevent unnecessary oscillations.
* Improved trading logic to prevent unintended battery charging from the grid when trading is enabled.
### Controller Debugger UI – Enhancements
#### Activity Logs
* Important system events are now logged locally on the controller, improving diagnostics and troubleshooting.
#### Extended Controller Dashboard
The dashboard now includes additional system-level information:
* System information
* Memory usage
* Storage status
* Network details
* Complete list of incidents
#### Configuration Tab
* API authentication token is now displayed in a readable format for secure server communication.
#### Forecast Page Improvements
* Added date filtering (from–until).
* Improved graph layout and readability.
* Updated styling of statistics summary blocks.
#### Controllers Overview
* Added a new controller type: **BatteryScheduleController**.
### Forecast API & Data Processing
#### Forecast API Update
* Forecast API migrated from **v1 to v2**.
* Power values are now returned in **Watts (W)** instead of **Watt-hours (Wh)**.
#### Internal Data Handling
* All forecast data is automatically converted from **W to kW** for processing and visualization, including:
* Consumption
* Total PV generation
* PV generation per inverter
#### Debug Enhancements
* Debug server now exposes historical forecast data up to **48 hours** in the past.
* Forecast visualizations in the debugger have been improved for clarity and usability.
### New Features
* Provisioning flow added for new EMS controllers.
* Sites dashboard extended with search and filter functionality.
* Support added for **Schneider PAS600**.
* Gateway device information added to the device communication overview.
* Option added to enable or disable advanced logging to reduce data usage.
* Project settings now display controller information and include an **EMS controller update** button.
* Project name, time zone, and project ID are now included in controller configuration.
### Improvements & Fixes
#### ESS, PV & Data Accuracy
* Corrected consumption and production calculations in the ESS graph.
* PV dashboard data corrected.
* Battery performance email values corrected.
* Peak power information removed from battery performance emails.
#### UI & UX
* Device override interface improved.
* Tooltip corrected in the projects table when a controller is offline.
* Changelog table updated.
* Improved translations of algorithms.
#### Incidents & Monitoring
* Added new incident type: **“unknown”** for unidentified keys.
* Improved handling of unknown incident types.
* Removed duplicate incident detection.
* Chat notification added for fire alarm incidents.
* Additional checks added to hide battery temperature or DC breaker statistics when not available.
### User Permissions & Visibility
* Both customers and installers now have access to the pro dashboards.
* Manual override is hidden for non-connectable inverters.
* Pro dashboard variables extended with `project_id`.
### Stability & Reliability
* Various internal optimizations and stability improvements across the system.
***
{% endupdate %}
{% update date="2025-11-15" %}
## Firmware Version 0.0.191
This single update consolidates all functional, structural, and integration changes implemented across all intermediate versions.
### Device, Adapter and Integration Support
A major expansion of supported hardware.
#### Newly Supported Devices
* Huawei Smartlogger
* SMA inverters (Sunny Tripower, Sunny Boy and related models)
* Fronius inverters
* ABB inverters
* Goodwe inverters
* Sungrow inverters
* Carlo Gavazzi EM24 energy meter
* Fluvius AMR digital meter
* Virtual PV adapter
#### PCS, Battery and BMS Improvements
* New adapters for:
* Liquid-cooled BMS
* EP Energy EPES233 PCS
* SCU BRES BMS and PCS
* EnjoyPower PCS
* Poweroad PMS PCS
* Corrected register mappings for all PCS types
* Added DC-side max charge and discharge current readouts
* Added battery production and consumption channels
* Added calibration command and calibration state handling
* Added derating coefficient support
* Added unmanaged device mode for read-only operation
* Improved device health evaluation using severity classification
#### Metering Enhancements
* Added auxiliary energy meters for PV and PCS
* Corrected inverted metering direction
* Improved active-power accuracy
* Added production capacity configuration
### Trading, Forecasting and Imbalance Logic
#### Trevi
* Full implementation of Trevi battery trading provider
* Added Trevi imbalance signal support
* Added persistent trading state management
* Improved trading signal mapping and decision logic
* Added calibration lockout to prevent usage during automatic calibration
* Integrated Trevi metadata and measurements into process image logging
#### Yuso
* Full Yuso optimization integration
* Added Yuso imbalance signal support
* Fixed maxSiteOfftakeActivePower reporting
* Added logic to prevent charging from grid when operating in Yuso local mode
* Updated standby behaviour and local-mode optimizations
#### Forecasting
* Added complete forecast provider (API and static fallback mode)
* Added retry logic for forecast updates
* Fixed interval clearing issues
* Improved W→kW conversion accuracy
* Added fallback to self-supply when forecast data is insufficient
* Improved alignment of forecast data with 15-minute intervals
### Algorithms, Control and Optimization
#### Cost Optimization
* Fully rewritten charging and discharging algorithm
* Proportional power distribution based on energy headroom
* Battery grouping logic based on pricing differences
* Improved PV buffering and oversupply handling
* Improved consumption reconstruction and calculation logic
* Enhanced load scheduling with minimum runtime rules
#### Oscillation Prevention
* Redesigned oscillation prevention controller
* Per-device measurement latency handling
* Controlled minTimeBetweenChanges
* Decision history tracking with persistent storage
* Integrated into main control cycle
* Removed legacy deadzone controller
#### Grid Logic
* Added grid limit exceeded incident
* Added grid power feedback correction logic
* Improved grid limit controller integration
* Corrected grid export calculations
#### Self-Supply Logic
* Migrated to algorithm-based architecture
* Updated fallback behaviour using forecast data
* Improved PV curtailment handling
### Monitoring, Debugging and Process Image
#### Debugger Enhancements
* Added full control decision viewer
* Added forecast inspector
* Added device channel viewer
* Added project information (name, ID, URL)
* Added local and public IP display
* Added modbus REPL for device testing
* Added connectivity test command
* Added calibration status preview
* Added raw configuration view
* Improved stale data detection and tooltips
#### Logging and Process Image
* Added logging of:
* Battery power
* Grid power
* PV production
* Process image snapshots
* Trading provider states
* Control decisions
* Forecast data
* Enabled structured cloning of controller calls
* Added per-cycle logging of control cycles
### Simulator and Development Tools
#### Simulator
* Full energy flow simulator added
* Timeline representation of consumption, PV and battery behaviour
* Integration with forecast data
* Simulation of cost with and without optimization
* Multiple bug fixes related to data models, paths and build process
* Major redesign of simulation data structures
#### Mockbus
* Added editable registers
* Simplified simulation behaviour
#### Developer Tooling
* Added build pipeline for both bytecode and bundled builds
* Added prerelease checking
* Added Docker mount improvements
* Added health monitor to terminate unhealthy processes
* Added extended developer documentation
### Configuration and User Interface
#### Configuration Improvements
* Added import/export of JSON configuration
* Added override file support
* Improved parsing of optional arrays and nested config
* Added flags such as canBeUsedForEnergyTrading
* Updated battery settings (power limits, initial SoC)
* Improved SoC calculation and distribution logic
* Differentiated system configuration from process image
#### UI and Visualization
* Updated graphs to step-type with improved clarity
* Added horizontal reference lines
* Updated PV disabled state visibility
* Added scenario selection support
* Improved 24-hour views
### Refactoring and Structural Improvements
* Reorganized algorithms and controllers into shared modules
* Removed unused controllers and dead code
* Simplified utility functions and naming
* Unified control logic for battery power distribution
* Cleaned formatting across major code sections
* Consolidated duplicated logic
* Improved fallback behaviour and error handling
***
### Bug Fixes
Key issues resolved:
* Negative PV production values
* Incorrect unit conversions
* Unhealthy device handling bugs
* Forecast data mapping errors
* PMS and BMS register mapping issues
* Incorrect energy meter inversion
* Forecast and simulation alignment issues
* Influx logging inconsistencies
* Build failures and bundling issues
* Misreported power in Yuso integrations
* Oscillation prevention deadlocks
* Incorrect PV limit behaviour
* Missing trading state persistence
{% endupdate %}
{% endupdates %}
***
## Full Consolidated Changelog (0.118 → 0.166)
This single update consolidates all functional, structural, and integration changes implemented across all intermediate versions.
### Device, Adapter and Integration Support
A major expansion of supported hardware.
#### Newly Supported Devices
* Huawei Smartlogger
* SMA inverters (Sunny Tripower, Sunny Boy and related models)
* Fronius inverters
* ABB inverters
* Goodwe inverters
* Sungrow inverters
* Carlo Gavazzi EM24 energy meter
* Fluvius AMR digital meter
* Virtual PV adapter
#### PCS, Battery and BMS Improvements
* New adapters for:
* Liquid-cooled BMS
* EP Energy EPES233 PCS
* SCU BRES BMS and PCS
* EnjoyPower PCS
* Poweroad PMS PCS
* Corrected register mappings for all PCS types
* Added DC-side max charge and discharge current readouts
* Added battery production and consumption channels
* Added calibration command and calibration state handling
* Added derating coefficient support
* Added unmanaged device mode for read-only operation
* Improved device health evaluation using severity classification
#### Metering Enhancements
* Added auxiliary energy meters for PV and PCS
* Corrected inverted metering direction
* Improved active-power accuracy
* Added production capacity configuration
### Trading, Forecasting and Imbalance Logic
#### Trevi
* Full implementation of Trevi battery trading provider
* Added Trevi imbalance signal support
* Added persistent trading state management
* Improved trading signal mapping and decision logic
* Added calibration lockout to prevent usage during automatic calibration
* Integrated Trevi metadata and measurements into process image logging
#### Yuso
* Full Yuso optimization integration
* Added Yuso imbalance signal support
* Fixed maxSiteOfftakeActivePower reporting
* Added logic to prevent charging from grid when operating in Yuso local mode
* Updated standby behaviour and local-mode optimizations
#### Forecasting
* Added complete forecast provider (API and static fallback mode)
* Added retry logic for forecast updates
* Fixed interval clearing issues
* Improved W→kW conversion accuracy
* Added fallback to self-supply when forecast data is insufficient
* Improved alignment of forecast data with 15-minute intervals
### Algorithms, Control and Optimization
#### Cost Optimization
* Fully rewritten charging and discharging algorithm
* Proportional power distribution based on energy headroom
* Battery grouping logic based on pricing differences
* Improved PV buffering and oversupply handling
* Improved consumption reconstruction and calculation logic
* Enhanced load scheduling with minimum runtime rules
#### Oscillation Prevention
* Redesigned oscillation prevention controller
* Per-device measurement latency handling
* Controlled minTimeBetweenChanges
* Decision history tracking with persistent storage
* Integrated into main control cycle
* Removed legacy deadzone controller
#### Grid Logic
* Added grid limit exceeded incident
* Added grid power feedback correction logic
* Improved grid limit controller integration
* Corrected grid export calculations
#### Self-Supply Logic
* Migrated to algorithm-based architecture
* Updated fallback behaviour using forecast data
* Improved PV curtailment handling
### Monitoring, Debugging and Process Image
#### Debugger Enhancements
* Added full control decision viewer
* Added forecast inspector
* Added device channel viewer
* Added project information (name, ID, URL)
* Added local and public IP display
* Added modbus REPL for device testing
* Added connectivity test command
* Added calibration status preview
* Added raw configuration view
* Improved stale data detection and tooltips
#### Logging and Process Image
* Added logging of:
* Battery power
* Grid power
* PV production
* Process image snapshots
* Trading provider states
* Control decisions
* Forecast data
* Enabled structured cloning of controller calls
* Added per-cycle logging of control cycles
### Simulator and Development Tools
#### Simulator
* Full energy flow simulator added
* Timeline representation of consumption, PV and battery behaviour
* Integration with forecast data
* Simulation of cost with and without optimization
* Multiple bug fixes related to data models, paths and build process
* Major redesign of simulation data structures
#### Mockbus
* Added editable registers
* Simplified simulation behaviour
#### Developer Tooling
* Added build pipeline for both bytecode and bundled builds
* Added prerelease checking
* Added Docker mount improvements
* Added health monitor to terminate unhealthy processes
* Added extended developer documentation
### Configuration and User Interface
#### Configuration Improvements
* Added import/export of JSON configuration
* Added override file support
* Improved parsing of optional arrays and nested config
* Added flags such as canBeUsedForEnergyTrading
* Updated battery settings (power limits, initial SoC)
* Improved SoC calculation and distribution logic
* Differentiated system configuration from process image
#### UI and Visualization
* Updated graphs to step-type with improved clarity
* Added horizontal reference lines
* Updated PV disabled state visibility
* Added scenario selection support
* Improved 24-hour views
### Refactoring and Structural Improvements
* Reorganized algorithms and controllers into shared modules
* Removed unused controllers and dead code
* Simplified utility functions and naming
* Unified control logic for battery power distribution
* Cleaned formatting across major code sections
* Consolidated duplicated logic
* Improved fallback behaviour and error handling
### Bug Fixes
Key issues resolved:
* Negative PV production values
* Incorrect unit conversions
* Unhealthy device handling bugs
* Forecast data mapping errors
* PMS and BMS register mapping issues
* Incorrect energy meter inversion
* Forecast and simulation alignment issues
* Influx logging inconsistencies
* Build failures and bundling issues
* Misreported power in Yuso integrations
* Oscillation prevention deadlocks
* Incorrect PV limit behaviour
* Missing trading state persistence
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.voltmasters.io/changelog/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.