# Release notes {% hint style="success" %} MClimate is devoted to keeping our products up to date with the latest advances in the space of IoT. Thus, we push updates for the purpose of introducing New Features or in order to improve Existing Functionality. We are committed to making our products better! We have made the option to update the firmware of your device (check improvements each version brings below) via a remote update. Learn on how to initiate the update in the [FUOTA section](https://docs.mclimate.eu/mclimate-lorawan-devices/firmware-upgrade-over-the-air-fuota) of our documentation. {% endhint %} **Would you like to receive news about new firmware updates for our products?**\ **Subscribe to our newsletter via the link below.** {% embed url="" fullWidth="false" %} ### Firmware version 4.7 **Release date:** \ 02.02.2026 * Bug fix - issue with force-attach functionality that affects FW 4.5 and 4.6 devices where it caused a calibration loop. ### Firmware version 4.6 **Release date:**\ 05.11.2025 Short Video Summary below: {% embed url="" %} 1. **New major features:** * [**0-5 Scale**](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/vicki-lorawan-device-communication-protocol/temperature-control/control-units-celsius-fahrenheit-scale#scale-0-5-conventional-thermostat) * Instead of target temperature selection on the LED display - similar to a conventional thermostat. In the background, you assign each level of the scale a target temperature setting. * [**Heating schedules** ](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/heating-schedules) * Up to 20 individual timers running internally. * [**Automatic setback temperature**](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/vicki-lorawan-device-communication-protocol/temperature-control/automatic-setback-temperature#automatic-setback-temperature-manual-boost) * Ability to set a timeout for manual target temperature changes. After the timeout, the thermostat goes back to the previous target temperature. * Custom target temperature if device goes offline. 2. **Other new features and improvements:** * [Configurable duration of LED indication](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/vicki-lorawan-device-communication-protocol/others#new-setpoint-led-indication-duration) when target temperature is changed by hand. * Default minimum valve openness is now 5%. * Added possibility to [temporary forbid device internal algorithm](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/temperature-control/internal-algorithm-temporary-state) with radio command until a next downlink or manual change of the target temperature. * [Communications Watch-Dog](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/vicki-lorawan-device-communication-protocol/network-related-settings#communication-watch-dog) - when working with unconfirmed uplinks, device now sends a confirmed uplink before it re-joins the network. If the confirmed uplink is acknowledged, the device doesn't rejoin the network. * [Manual target temperature change notification](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/temperature-control/manual-target-temp-change) is now sent with confirmed uplink. * The motor starts moving after at least 5s after manual target temperature change to allow more time for end-users to select the desired temperature. * Motor calibration logic optimised, so the motor is rotated less, resulting in even better battery life. * Improved MAC command battery level response. * Low motor current flag no more leads to permanent open valve. * When working with an external temperature sensor and the Vicki's internal temperature sensor has been broken, the temperature control algorithm now continues working. * When a radio command for device reset is sent, the device now first sends a response and then restarts. This prevents a join-loop if confirmed downlink is used to reset the device. * Too low battery for device operation is now reported in the keep-alive. * In previous firmwares, in rare cases valve closing was performed with multiple rotations a few seconds apart. * Preserve prev. configured values for target setpoint, allowed min. and max. temp., after FUOTA, when updating from version below 4.3. You can check all new commands in the [Commands cheat sheet](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/command-cheat-sheet)! {% hint style="warning" %} Found issues:\ \- Force-attach feature doesn't work properly, do not use it. {% endhint %} ### Firmware version 4.5 **Release date:** \ 17.07.2025 * Bug fix - S1 button (back of Vicki head) being stuck no longer results in functionality and Watch-dog issues. This bug was only present for devices with Hardware version older than 2.8. {% hint style="warning" %} Found issues:\ \- Force-attach feature doesn't work properly, do not use it. {% endhint %} ### Firmware version 4.4 **Release date:** \ 10.02.2025 * NEW - Command to SET/GET LED display temperature units (Fahrenheit or Celsius) * NEW - Command to SET target temperature in Fahrenheit * Changed default value of thys (temperature hysteresis) to 0 degrees C. ### Firmware version 4.3 **Release date:** \ 01.03.2024 {% hint style="info" %} If your devices are running firmware version 4.0 or higher, they are eligible for FUOTA upgrade to 4.3. Read more [here](https://docs.mclimate.eu/mclimate-lorawan-devices/firmware-upgrade-over-the-air-fuota). {% endhint %} * Further improvements on calibration mechanism. * Temperature measurement can now reach -5 degrees C - previously the lowest value was 5 degrees C. * [Introduced anti-freeze functionality.](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/anti-freeze-functionality) * Each time the device is powered, it briefly rotates the motor to verify the fully open position. * [Added SET/GET command for PI's anti wind-up value.](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm/algorithm-3-proportional-integral#maximum-allowed-integral-value) * [Added a SET command to set valve openness in percentages.](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/set-motor-position-and-update-target-temperature-command-explanation#set-valve-openness-in-percentage) * Added a "valve openness" property in the decoder to indicate what's the current valve openness in percentages. * [Added SET/GET for the MIN/MAX valve openness - e.g. you can set it so that the valve opens to max 60% or min 10% - useful for hydraulic balancing.](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/set-motor-position-and-update-target-temperature-command-explanation#valve-openness-range-in-percentage) * After the device joins the network, it sends the first 5 uplinks as soon as possible (depending on the Spreading Factor that the LNS has set) * [Added a new SET command for the target temperature with accuracy 0.1 degrees - e.g. you can now set target temperature of 22.3 degrees. ](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/set-motor-position-and-update-target-temperature-command-explanation#target-temperature-with-resolution-0.1-c) * When the temperature is changed through the device, it switches back to whole values - e.g. 23, 24... * When the target temperature is with a decimal point, e.g. 22.3, the device includes this target temperature with each uplink. * [Discontinued the algorithm 2 - "Proportional control", as the algorithm 3 - "Proportional Integral control" delivers better results.](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm/algorithm-2-proportional-control) * [Added SET/GET commands for measured temperature offset.](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/external-temperature-measurement-and-internal-temperature-offset#internal-temperature-offset) * When the device is removed from the backplate, it sends immediate uplink. * Bugfixes implemented for the issues found in firmware 4.2 (read below). ### Firmware version 4.2 **Release date:**\ 26 July 2023 * Further improvements on the new micro/half stepping motor driver, resulting in better battery consumption. * Maximum motorRange increased from 800 steps to 860 steps * The first temperature control algorithm, called [Equal Direction Control](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm/algorithm-1-equal-directional-control) is removed. * A [new PI algorithm](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm/algorithm-3-proportional-integral) is introduced and is now the default algorithm. * New command for [ext. temp measurement](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/external-temperature-measurement-and-internal-temperature-offset#set-external-temperature-sensor-value-with-accuracy-0.1) setting with accuracy 0.1 (previous accuracy was 1.0, old command is preserved). * New command to [GET the ext. temp measurement value](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/external-temperature-measurement-and-internal-temperature-offset#get-external-temperature-sensor-value-with-accuracy-0.1) is implemented. * When the device is in operational mode with ext. temperature sensor, the ext. temperature value in the memory in the device is reported with each keepalive. * New command for [open window detection](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/open-window-detection#open-window-commands-with-delta-t-0.1-accuracy) with delta accuracy of 0.1 (previous accuracy was 1.0, old command is preserved). * The device now does not reply immediately to a downlink unless it contains a GET command. * The device now replies immediately to a downlink command for new target temperature. * [Force-attach](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/force-close#force-attach-a-vicki) a valve - overwrite of the button that the backplate presses to indicate the device is mounted. If you send this command, Vicki will try to calibrate even if it's not correctly installed on a backplate. If there's no backplate and valve at all, calibration will not be successful. * This command can be used in cases when an already installed device starts reporting motorRange of 0. * Keep in mind that the 5th bit in the 8th byte of the keepalive indicates whether the backplate button is pressed at all. {% hint style="info" %} If your devices are running firmware version 4.0 or higher, they are eligible for FUOTA upgrade to 4.2. Please get in touch with us at to coordinate the process. {% endhint %} {% hint style="warning" %} Known issues: * If device is frequently recalibrated, motorRange might decrease. * Workaround: Avoid recalibrating frequently. motorRange is fixed when the device is manually removed from the backplate and mounted again. * Additional advise: When you send recalibration downlink, use unconfirmed downlink. When using confirmed downlink for recalibration, it increases the chance of the issue occurrence. * When the device is removed from the backplate during motor rotation, it is possible that the motor pushes indefinitely. * When the device is working in ext. temp sensor mode and no ext. temp value is sent through a downlink, the PI algorithm might not work optimally, but still continues to control the valve based on the target temperature. {% endhint %} ### Firmware version 4.1 **Release date:**\ 23 February 2023 {% embed url="" %} * Use microstepping/halfstepping (dependent on the hardware version) to drive the motor. This decreases very significantly the sound that Vicki generates during motor rotation. * Added command to [change AppEUI & AppKey](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/network-related-settings#change-appeui-and-appkey). * Added a [command to control whether child-lock is disabled when device goes offline](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/child-lock#child-lock-behavior-when-device-goes-offline). * Added a bit to the [keepalive](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/keep-alive) to report whether Vicki is attached to a backplate or not. * Added a bit to the [keepalive](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/keep-alive) to report whether Vicki thinks it’s online or offline. Refer to [Network-related settings](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/network-related-settings) for more information how Vicki undestands if it's online or offline. * Change default re-join period from 3 to 10 minutes. Remove full device reboot in case it has not connected to a LoRaWAN network for the last 10 tries. * Proportional algorithm now closes the valve with single movement when target temperature is exceeded. * Enriched the diagnostics information – added info on the humidity and temperature IC. * Allow motor recalibration after initial unsuccessful calibration. * Make it harder to enter functional test mode (88 showing on the display). * Bugfix: Device now processes WDP \[confirmed] correctly. * Bugfix: After Watch-Dog reset, the device retains its operational mode. * Bugfix: Improve rotary encoder’s logic, so the display of Vicki is not randomly activated. * Bugfix: Resolve issue with LoRaWAN MAC Layer freezing from f.w. 4.0 {% hint style="info" %} If your devices are running firmware version 4.0, they are eligible for FUOTA upgrade to 4.1. Please get in touch with us at to coordinate the process. {% endhint %} ### Firmware version 4.0 **Release date:** \ 12 April 2022 * FUOTA mechanism released {% hint style="info" %} The FUOTA functionality differs from the FUOTA that's being used by the LoRa Alliance. In order to update the firmware version of devices, they should be connected to MClimate's cloud. It takes around 1500 downlinks to perform FUOTA. Due to duty-cycle limitations of the gateways, we recommend staging the FUOTA in smaller batches in case your installation is sizeable. Feel free to reach out to to acquire more details on the process. {% endhint %} * Force-close functionality improved. Improved over-voltage detection when valve is near fully closed position. * Devices now send full configuration information with the first uplink after the Join procedure. * Downlink for [remote device reset](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/network-related-settings#remote-reset-the-device) is implemented * Downlink for [setting only the motorPosition](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/set-motor-position-and-update-target-temperature-command-explanation#set-motor-position-only) is implemented * Updated section of documentation - ["Operational modes, temperature control algorithms, target temperature and motor control"](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm) * Introduced commands to [get/set the temperature control algorithm being used](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm#temperature-control-algorithm-selection-and-retrieval). * Additional temperature control algorithm introduced - called "Proportional control" * Default temperature control algorithm in f.w. >= 4.0 * [Get/set commands for the parameters of the algorithm - proportional gain and period](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm/algorithm-2-proportional-control#proportional-temperature-control-algorithm-parameters) * Bugfix - Device now retains operational mode "Automatic with external temperature sensor" after reset. * Bugfix - Manual target temperature change command is sent only when the target temperature is changed manually by rotating the Vicki (by hand). {% hint style="warning" %} Known issues * The device may stop sending periodic uplinks due to the MAC layer of the LoRaWAN Stack freezing. The device is affected only if it works with unconfirmed uplink type. The device re-joins the network once the Watch-Dog period elapses and device realises it's offline. * **Suggested resolution:** * You can minimise the downtime of the device by re-configuring the WDP for unconfirmed uplinks to e.g. 2h. * You MUST alter the DevStatusReq period in your LNS to at least once every hour. * When changing the keepalive period, the WDP \[unconfirmed] does not refresh. * **Resolution** * With one downlink, first change the keepalive period, then set the WDP again. {% endhint %} ### Firmware version 3.6 **Release date:**\ 12 December 2021 * Minor bugfixes and updates * If pFirstLast or pNext is less than 17 steps, move the motor with 17 steps. * If one wants to move the motor with less than 17 steps, move the motor with 17 steps. * Preparation for FUOTA mechanism release Known issues: * When device is in operational mode "Automatic with external temperature sensor" and it restarts due to power-off or Communications watch-dog, the device backs off to "Automatic" operational mode. * Suggested fix on production: When you send the external temperature measurement to Vicki, always append the command to switch to operational mode "automatic with external temperature sensor" - "0D02" * [Manual target temperature change command](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/manual-target-temperature-change) is sent whenever the target temperature is changed, even through a downlink command. ### Firmware version 3.5 **Release date:**\ 02 December 2021 * **Improved temperature measurement resolution from 0.62 to 0.18 degrees Celsius** * **Special command if the** [**target temperature has been changed manually**](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/manual-target-temperature-change) **by the customer (by hand).** * [**Open Window function**](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/pre-46-vicki-lorawan-device-communication-protocol/open-window-detection) **change - Vicki fully closes the valve, regardless of motorPosition specified.** * **Changed default parameters:** * **Operational mode** - changed from manual to **automatic** * **Keepalive interval** - changed from 3 to **10 minutes** * **tDiff (open/close)** - changed from 1 to **0 degrees** * **Uplink type** - changed from confirmed to **unconfirmed** * Send first keepalive packet as soon as the device completes Join procedure. * Added support for [Advanced Motor Force Control](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/broken-reference) of Vicki. * Improvement of the calibration mechanism * Bugfix - in previous firmware device reported -40 degrees after the communication watch-dog has restarted it. * Bugfix - report battery voltage values above 3.5VDC correctly Known issues: * If pFirstLast or pNext is less than 17 steps, the device misbehaves * If one moves the motor with less than 17 steps in either directions, the device misbehaves * When device is in operational mode "Automatic with external temperature sensor" and it restarts due to power-off or Communications watch-dog, the device backs off to "Automatic" operational mode. ### Firmware version 3.4 **Release date:** \ 07 January 2021 * Minor bugfixes * Allow keepalive interval to be greater than 21 minutes * The internal temperature control algorithm now uses force close to close the valve. * Introduce WDP (Communication Watch-Dog Parameters); [Set WDP parameters](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/network-related-settings#set-device-radio-communication-watch-dog-parameters-command-explanation); [Get WDP parameters](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/network-related-settings#get-device-radio-communication-watch-dog-parameters-command-explanation) Known issues: * When the WDP activates and restarts the device, the first reading of the temperature is -40. * If battery voltage is > 3.5VDC, the device reports 2VDC. The device continues working correctly. * When device is in operational mode "Automatic with external temperature sensor" and it restarts due to power-off or Communications watch-dog, the device backs off to "Automatic" operational mode. ### Firmware version 3.3 **Release date:** \ 27 October 2020 * Add Cooling mode as primary operational mode; [Set device primary operational mode](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm#set-device-primary-operational-mode); [Get device primary operational mode](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/pre-46-vicki-lorawan-device-communication-protocol/operational-modes-and-temperature-control-algorithm#get-device-primary-operational-mode) * Minor bugfixes Known issues: * Keepalive interval cannot exceed 21 minutes * When device is in operational mode "Automatic with external temperature sensor" and it restarts due to power-off or Communications watch-dog, the device backs off to "Automatic" operational mode. ### Firmware version 3.2 **Release date:** \ 28 September 2020 * Initial release of Vicki LoRaWAN --- # 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.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/release-notes.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.