Skip to main content

Changelog for BLU+ZB devices

The major changes to Shelly BLU+ZB Devices API Docs will be reflected here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

For BLU devices, refer to Changelog

[BLU_FW 1.2.14] 2026-03-19​

Added​

[BLU_FW 1.2.12] 2026-03-04​

Added​

  • Button1 Zigbee can now be enabled or disabled via BLE setting
  • Wall EU Zigbee can now be enabled or disabled via BLE setting
  • Wall US Zigbee can now be enabled or disabled via BLE setting
  • Button1 Battery percentage included in button press BLE advertisements
  • Button1 Unicast find-and-bind when Zigbee group is set to 0
  • Zigbee poll on single button click for faster event delivery
  • 5-click now also enables Zigbee if it was previously disabled

Changed​

  • Zigbee long poll interval increased from 30 to 60 seconds
  • Encryption key BLE characteristic now requires encrypted connection instead of bonding

Fixed​

  • Button1 Removed parasitic BTHome item that appeared during BLE pairing
  • Wall EU Removed parasitic BTHome item that appeared during BLE pairing
  • Wall US Removed parasitic BTHome item that appeared during BLE pairing

[1.4.0] 2026-04-22​

Changed​

  • TRV Implemented a new adaptive heating control algorithm with improved temperature stability and efficient valve control

Fixed​

  • TRV Fixed a rare issue where the TRV could occasionally report an incorrect current temperature for a short period.
  • TRV The control algorithm now reacts immediately when the target temperature is adjusted using the TRV knob.

[1.3.2] 2025-01-14​

Added​

  • TRV Official ZigBee support, with Custom cluster for manual mode
  • TRV ZigBee rejoin policy
  • TRV Silent mode with motor noise reduction

Fixed​

  • TRV Improved stability when using multiple schedules

[1.2.11] 2025-10-24​

Added​

[1.2.8-hotfix2] 2025-09-25​

Fixed​

  • SBRC Set bonding policy to reuse bonding table after 10 bondings

Added​

  • SBRC Add Identify client Zigbee cluster and 3 clicks button combination to activate it

[1.2.10] 2025-08-20​

Fixed​

  • TRV Resolved a problem causing random reboots.
  • TRV Optimized internal memory handling for better performance.

Added​

  • TRV Position set in Manual mode is now saved after reboot.

[1.2.8] 2025-09-25​

Added​

  • SBRC Inital firmware for Blu Remote

[1.2.6] 2025-05-19​

Fixed​

  • TRV Correct manual position setting. Fix set blinking function for reentrance

Added​

  • TRV Add schedule command for valve position when TRV is disabled
  • TRV Init external temperature timeout on start up and on floor heating mode change
  • TRV Add external temperature timeout of 30 minutes when underfloor heating is active
  • TRV Add extended temperature missing error flags
  • TRV Show remotely set valve percent on display in manual mode
  • TRV Add manual position cotrol with the knob if TRV is disabled

Changed​

  • TRV Remove blinking during manual position set. Make manual boost to only set percent
  • TRV Run trv algorith immediately when target changes
  • TRV Do not reset trv algorithm when max position reaced
  • TRV Terminate boost mode when switching to manual control
  • TRV Increase stepper maximum steps to 3800
  • TRV Make boost setting from knob in manual mode to go to 100 and to 0%

[1.2.1] 2024-02-28​

Fixed​

  • TRV Fixed an issue where the BLU TRV did not properly use external temperature data in underfloor heating mode.

Added​

  • TRV Added error flag "disabled" in the temperature component status when the trv component is in underfloor heating mode ("floor_heading" flag is up).

[1.2.0] 2024-02-19​

Changed​

  • TRV Increased max steps for the stepper.
  • TRV Activate/Deactivate Zigbee Identify by long button press

Fixed​

  • TRV Fixed missing state change after setting an external temperature.
  • TRV Disable all-time calibration correction if the minimum valve position > 0.
  • TRV Fix TRV Lock. Now it fully restricts knob control, showing only the battery level.
  • TRV Fixed temperature discrepancy between the TRV display and Web/App UI.
  • TRV Fixed temperature compensation for small values.
  • TRV Fixed TRV Display freeze when activating boost mode.
  • TRV Fixed entering BLE pairing with button.

Added​

  • TRV Added TRV error flag: battery_low.
  • TRV Added power_save flag setting to choose regulation algorithm. On by default.

[1.1.3] 2024-12-23​

Changed​

  • TRV Revert change for stepper motor speed-up

Fixed​

  • TRV Correct the behavior for automatic close position correction

[1.1.2] 2024-12-19​

Changed​

  • TRV Increased battery life through optimizations
  • TRV Faster manual temperature changes in Fahrenheit mode for low-speed rotations
  • TRV Identify Action: Changed trigger from a single button press to a long press (5 seconds)(ZigBee)

Fixed​

  • TRV Occasionally fails to use the external sensor for current temperature and instead uses the built-in sensor.
  • TRV Too many repetitions of Clog Prevention movements when activated

[1.1.1] 2024-11-25​

Fixed​

  • TRV Fix setting of target temperature with low speed ring rotation.

[1.1.0] 2024-11-22​

Changed​

  • TRV Rise the threshold for detecting stepper motor endpoints
  • TRV More agressive calibration correction when enabled
  • TRV Correct display of ZB network status in user menu
  • TRV Retry joining ZB network with small delay. Correct Zigbee display messages
  • TRV Set max MTU size for GATT to 250
  • TRV Update Shelly.GetDeviceInfo to version CFG_VERSION 2
  • TRV Set default OVERRIDE_ENABLE on top of CFG_VERSION 1
  • TRV Don't read internal t sensor if FLOOR_HEATING_EN

Added​

  • TRV Display all segments on at boot
  • TRV Make automatic calibration of closed position always enabled, and add correction to 100% position
  • TRV Joining ZB combined with Leaving operation if needed
  • TRV Add ZB Groups cluster server side
  • TRV Add not_mounted error in trv flags
  • TRV Add ZB display status
  • TRV Make target setting speed exponential for F
  • TRV Change public device name. Short device name from advertising includes 4 digits of mac address.
  • TRV Make entering user menu more smooth

Fixed​

  • TRV Fix trv target constraints
  • TRV Fix rotary encoder Fahrenheit targets
  • TRV Fix some conversions to farenheit

[1.0.1] 2024-10-11​

Changed​

  • TRV Factory test mode - start with all LEDs on
  • TRV ZB: Change paring/Leaving button action to tripple press
  • TRV Restart pairing if button is pressed and not in BLE menu

Added​

  • TRV Use valve min position and the same for valve min report position from the settings
  • TRV Force status report in valve open to close or vice versa
  • TRV Add default_boost_duration and defaul_override_duration in trv config
  • TRV Add trv override_enable setting
  • TRV ZB setting target temperature using Thermostat cluster

[1.0.0] 2024-09-26​

Changed​

  • TRV Add -0.1C correction on power LEDs instead of skip t measure
  • TRV Do not add temperature[2] in adv packet if to external temperature is not available
  • TRV Remove blocking of rotary encoder operation during pairing
  • TRV Make trv.SetBoost duration optional, 30min default
  • TRV Stop both Override and Boost mode on manual target temperature set
  • TRV Rollover state_rev to 1, minor fixes
  • TRV Use prediction correction for displayed temperature
  • TRV Update ListScheduleRules with rev
  • TRV Fine tune timings for entering settings from ring rotation
  • TRV Change advertisin timing to 333 / 5
  • TRV Slow down entering set target menu from rotary encoder
  • TRV Correct total steps calculation and reset the counter on back plate opening
  • TRV Move schedule_rev to trv.getstatus
  • TRV Simplify bonding and rebonding
  • TRV Optimize setting boost mode manually
  • TRV Enable beacons while connection is opened and suggest using 1M phy
  • TRV Load cron only when systime is valid

Added​

  • TRV Prevent accidentally entering boost mode of user menu while setting target temperature
  • TRV Force reading battery and temperature in app init
  • TRV Add long press for 5 sec to use for ZB Joining
  • TRV Display pairing when pressing the button and block manual control in pairing mode
  • TRV Add shelly device ID from response to advertising. Add device type name to GATT device name
  • TRV Add total steps counter in RPC trv status
  • TRV System sanity check added. Resets to factory defaults if pairing mode did not finished the first time

Fixed​

  • TRV Fix suncron deadloop
  • TRV Bootloader v5 - fix shelly device type length in adv packet
  • TRV Fix clear trv boost
  • TRV Smooth up the user menu

[0.0.9] 2022-09-11​

  • First version released to public