# Change Log

## V2.9.0 - Feb.13 2026

This release expands eWeLink Smart Home Add-on compatibility and device support, with notable improvements to Zigbee reliability, automation stability, and device control flexibility. Please take a moment to read through the notes before updating to this version.

### **What's New?** <a href="#id-91770f03" id="id-91770f03"></a>

1. **Expanded eWeLink Smart Home Add-on Device Support**

* Added support for syncing eligible air quality monitors to CUBE via eWeLink Smart Home Add-on, including:
  * **SONOFF SAWF-07P**
  * **SONOFF SAWF-08P**
* Added support for SONOFF SNZB-04PR2 Door/Window Sensor.

2. **Sensor Accuracy & Calibration Enhancements**

* Added an option to adjust temperature and humidity offsets for **SONOFF SNZB-02P** to improve reading accuracy.

3. **SONOFF TRVZB Enhancements**

* Boost Mode and Temp. Override Mode can now be enabled or disabled directly from **CUBE CAST.**
* **SONOFF SNZB-02LD** can now be used as an external sensor for more accurate room temperature and humidity measurements.

4. **Zigbee Reliability Improvements**

* Optimized Zigbee offline detection logic to identify device disconnections faster and improve overall control reliability. (Note: Due to reporting interval limitations, legacy **SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04** sensors are excluded from this optimization)

5. **Device Control & Calibration Enhancements**

* Added an option to configure extra travel time for **SONOFF MINI-ZBRBS** to ensure blinds fully open and close during manual calibration.
* Added stepping control support for **SONOFF MINI-ZB2GS**, allowing external switch presses to cycle through predefined relay states for more flexible multi-state control scenarios.
* Added a manual calibration option to **SONOFF MINI-ZBDIM** dimming calibration.

### **Bug Fixes** <a href="#osbzz" id="osbzz"></a>

1. Fixed a bug where input capability of **Frient IOMZB-110** module was missing in eWeLink CUBE.
2. Resolved a control issue with **Tuya/Moes AM43-0.45/40-ES-EZ** curtain motor.
3. Fixed an issue where **Paulmann Gen2 RGB Remote** could not be used as a scene trigger.
4. Corrected an issue where the **SONOFF R5 remote** did not trigger automations as expected after restoring from a backup.
5. Fixed an issue where scenes had to be re-enabled after an eWeLink CUBE reboot to run again.
6. Fixed an intermittent issue where the **Matter Bridge** could become unresponsive on third-party platforms when synchronizing a large number of devices.
7. Optimized the logic for synchronizing water leak sensors via the **Matter Bridge**.

***

## V2.8.1 - Nov.27 2025

We're excited to announce that **CUBE OS has now transitioned from beta to its official release version**. From this version onward, **CUBE OS version numbers will stay aligned with iHost releases** for consistent updates and feature improvements.

This update expands Matter Bridge and eWeLink Smart Home Add-on support, introduces new features for SONOFF TRVZB, enhances scene organization, and improves overall usability. Please take a moment to read through the notes before updating to this version.

### What's New? <a href="#ufpq2" id="ufpq2"></a>

1. **Expanded Matter Bridge Device Support**

* Added support for syncing additional Matter-defined device types via Matter Bridge, including:
  * Light Sensor
  * Smoke & CO Alarm (covering smoke and carbon monoxide sensors)
  * Air Quality Sensor
  * Room Air-conditioner
  * Fan

2. **New Features for SONOFF TRVZB**

* Added two new temporary modes for SONOFF TRVZB:
  * Boost Mode: heats the room quickly for a short period.
  * Temp. Override Mode: temporarily maintains a set temperature.

3. **Scene Enhancements**

* Easily create custom labels and assign scenes to existing labels.

4. **New features for ONVIF compatible Cameras**

* ONVIF-compatible cameras now support using "Motion Detected" and "Occupancy Detected" as scene triggers.

5. **Expanded eWeLink Smart Home Add-on**

* Added support for syncing eligible devices to CUBE via eWeLink Smart Home Add-on, including:
  * SONOFF Mini-RBS
  * Virtual Devices (covering switches and buttons)
  * Sub-devices from ZBBridge-U: SONOFF S60ZB, SNZB-02LD/SNZB-02WD, Mini-ZBRBS, SWV

6. **Device List Enhancements**

* You can now hide offline devices from the Home page device list for a cleaner, more focused view.

7. **Data Visualization Enhancements**

* Temperature and humidity graphs now support minute-level data for more detailed insights.

### Bug Fixes <a href="#fbhve" id="fbhve"></a>

1. Fixed an issue where scene notifications were not received via CUBE CAST during remote access.
2. Fixed compatibility issues with Tuya TS0001 Fingerbot.
3. Fixed Matter Bridge issues:

* Fixed an issue where the Matter Bridge repeatedly went offline.
* Fixed a problem where adding more than 10 devices prevented newly added devices from being synchronized through Matter Bridge.
* Fixed an issue where the Matter Fabric displayed as empty.
* Fixed an issue where deleting a device from CUBE did not correctly remove the corresponding device from the third-party Matter platform.

4. Fixed SONOFF TRVZB issues:

* Fixed an issue where Boost Mode and Temp. Override Mode failed to execute correctly.
* Fixed an issue where scene actions incorrectly allowed selecting Temp. Override Mode.
* Fixed an issue where adjusting the Boost Time while in Boost Mode caused inconsistent or incorrect timing.
* Fixed a bug where minute-level data of temperature and humidity graphs could not be properly displayed.
* Fixed an issue where the target temperature displayed in CAST exceeded the allowed range.
* Fixed an issue where the TRV's target temperature for Boost/Temp. Override Mode could not be synchronized or displayed correctly.

***

## V0.5 - Aug.27 2025

This update brings extended Zigbee dongle compatibility, ONVIF camera enhancements, and notable improvements for CUBE CAST. Please take a moment to read through the notes before updating to this version.

### What's New?

1. **Expanded Zigbee Dongle Compatibility**

* Added support for SONOFF ZBDongle-P and SMLIGHT SLZB-06 Zigbee Coordinator.
* Currently tested and verified compatible dongles:
  * SONOFF ZBDongle-E / P
  * SMLIGHT SLZB-06 / 06M
  * SkyConnect Zigbee (EZSP)

2. **ONVIF Camera Support**

* Added automatic discovery of ONVIF-compatible cameras.
* Supported PTZ (Pan-Tilt-Zoom) control.
* Tested and verified compatible devices (with required firmware versions):
  * SONOFF CAM-PT2: FW ≥ 1.0.6
  * SONOFF CAM-B1P: FW ≥ 1.0.2

3. **CAST Enhancements**

* Extended CAST pad layouts for a more flexible dashboard experience.

### Bug Fixes

1. Fixed an issue where CUBE OS failed to boot on Raspberry Pi 5 and could not perform OTA updates.
2. Corrected inaccurate data display in thermostatic radiator valves' trend graphs.
3. Fixed a bug where scenes triggered by power thresholds failed to execute properly.
4. Fixed an issue where device status updates on CAST required a manual browser refresh.

***

## V0.4 - Jun.19 2025

### What’s New?

1. Standalone installation support for:

* Raspberry Pi 4B / 5
* -x86\_64 Virtual Machines (e.g., VirtualBox, VMware)
* NAS devices (compatible models)

2. Zigbee device support via USB dongles (e.g., SONOFF ZBDongle-E)
3. Matter Hub & Matter Bridge
4. Remote Access/Push Notifications via PWA
5. Docker & Add-ons support
6. Scenes, Groups, OTA, CAST Dashboards, and more\
   For more details:\
   <https://forum.ewelink.cc/t/ewelink-cube-os-v0-4-beta-self-hosted-ewelink-server-public-testing-now-open/198406>

### How to Try

1. Download the image that fits your environment (Raspberry Pi / VM / NAS)\
   `raspberrypi4_64_prod.img.xz` for Raspberry Pi\
   `sdcard.vdi.xz/sdcard.vmdk.xz` for VMs, NAS devices
2. Flash and install by following these guides:\
   <https://github.com/eWeLinkCUBE/CUBE-OS/tree/master/Installation%20%26%20User%20Guide>
3. Join our [Discord server](https://discord.gg/67Ybdn23rS) to get support and share feedback

***

## V0.2 - Dec. 31, 2024

### What’s New?

* Remote Access rolls out for Pilot Features. When enabled, it allows remote access to CubeOS' web console and CAST via secured links.
* CAST can be installed as a web app with remote links. The app enables notifications for scene executions, Smart Security events, switch and plug toggles, and sensor triggers, including:&#x20;
  * Motion detection
  * Presence detection
  * Open window detection
  * Gas detection
  * Water leakage detection
  * Smoke detection
  * Press actions
* Users can now change the password for the web console.
* A new MQTT Broker settings page is available, supporting adding accounts and passwords. It allows connection to the broker using those credentials to subscribe to MQTT messages.
* Cameras now support simultaneous viewing of multiple streams.

**New Platform:**

* Raspberry Pi 5 (unverified).

**Optimizations:**

* Optimized the Tasmota add-on by using the built-in Mosquitto broker, retiring the need for extra broker installation.
* Improved the display format of Matter setup codes for better readability.

**Bug Fixes:**

* Resolved an issue where version 0.1 could not handle updates via OTA.

**Known Issues:**

The following known issues exist with version 0.2 and remain to be fixed in future updates:

* When accessing the web for the first time, virtual machines and Raspberry Pi might occasionally show a disconnection prompt.
* Raspberry Pi installation does not support adding fresh new or factory resetting Matter devices. Please use alternative Matter platforms and share them with CubeOS.
* Matter Hub sometimes crashes and restarts continuously.
* Remote notifications are unstable; users may not receive system pushes, potentially related to the network environment, browser issues, or backend process closures.
* Camera streaming may fail for Raspberry Pi installation via remote links.
* Matter Bridges won't show sub-devices on the devices' control page. And for sub-devices connected to a Matter Bridge on the settings page, the information of the Connected Bridge is missing.
* Matter fabric with Vendor ID "1286" can not be removed on CubeOS. If the system promotes a device that is full of fabric, please remove one from the other Matter platforms it is connected to.
* OTA is unsupported for Raspberry Pi 5 installation.
