openhab/openhab-distro 5.2.0

openHAB 5.2.0

on GitHub

This is the official release of openHAB 5.2.0.

The binaries are available on our download page and via "Stable" on our APT repository.

New and Noteworthy

The openHAB 5.2 release is a feature release that contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons. You can find the most relevant ones listed in detail below.

Please also note our release blog post, which describes the major new features in depth.

openHAB 5.2 is backward compatible to openHAB 5.x setups, though there are a few exceptions where manual action is required to adapt an existing setup, so please carefully check the section on breaking changes. It is especially important to know that openHAB 5.x requires Java 21, so in case you are coming from a 4.x installation and haven't yet upgraded, this is mandatory.

Quick links:

• Notes about new add-ons
• Notes about the core runtime
• Notes about the UIs
• Notes about the add-ons
• Upgrade Process for openHABian, APT, RPM, Manual Installations
• Breaking Changes that require manual interaction after the upgrade.

Relevant Changes

New Add-ons

The following add-ons are newly introduced:

Runtime

The following improvements were made to the core and the distro:

User Interfaces

Add-ons

Upgrade Process

Backup your configuration

If you are on openHABian, sudo openhabian-config menu option 50 will do for you,
else use sudo openhab-cli backup. Get the resulting file from $OPENHAB_USERDATA/backups, $OPENHAB_USERDATA is accessible as a Samba share. Using SSH it is /var/lib/openhab/ on your system.

If you run a Raspberry, get another SD card (an "Endurance" labelled one) and create a mirror copy.
openhabian-config menu option 54 will do for you on the live system, else there's tools such as dd or WinDiskImager.
Should you ever need to revert to your old openHAB system or to redo the upgrade process, simply change SD cards and start over from where you had started.

openHABian

If you are working with an openHABian setup,

check for compatibility

openHABian will refuse to install or upgrade to openHAB 5.2 when it detects a 32 bit operating system.
This is because openHAB needs Java 21 but as of today, there is no JVM 21 package available known to work on 32 bit ARM platforms.
Note: this is not about the processor type but about 32/64 bitness of the operating system.
There have been both types of openHABian images for Raspberries and many of you users will still be on the 32 bit OS.
Check the output of getconf LONG_BIT to see what you're on.

If you are on 64 bit, proceed to

upgrade

1. Use SSH to connect to the command line and run sudo openhabian-config.
2. When being asked, answer that you want to update openHABian (note that’s not about openHAB itself).
3. If on Raspberry, it's optional but recommended to create an image copy of your SD card using menu option 54.
4. Switching to openHAB 5.2.0 release depends on what version you’re upgrading from:
   
   a) If you have been running a 4.x or 5.x release version, select menu entry 03 “Install or upgrade to latest openHAB” option.
   
   b) If you have been running a snapshot or milestone release of 5.x, select the first entry in menu option 41 (“Release”).

If you are still on 32 bit OS, you can stay with your current openHAB 4 setup or do the upgrade to 64 bit as described in the openHAB 5.0.0 Release Notes.

Package-based Installations

APT (Debian / Ubuntu and derivatives)

Make sure that openHAB is sourced from the latest location, has the correct GPG signing key and that your system can download .deb packages via HTTPS by following the instructions for a stable installation in the docs.

If the above is correct, simply upgrade by using:

sudo apt-get update
sudo apt-get upgrade

Alternatively, you can force apt to install 5.2.0 and its optional add-ons with:

sudo apt-get install openhab=5.2.0-1

## optional add-ons for offline installation ##
sudo apt-get install openhab-addons=5.2.0-1

RPM

openHAB is also distributed in RPM packages. To use them, make sure that openHAB is sourced from the latest location, and has the correct GPG signing key for verification by following the stable installation instructions outlined in the docs.

If the above is correct, then simply upgrade using your systems package manager (yum, dnf, etc.)

sudo yum update

Alternatively, you can force apt to install 5.2.0 and its optional add-ons with:

sudo yum install openhab-5.2.0-1

## optional add-ons for offline installation ##
sudo yum install openhab-addons-5.2.0-1

Manual Installations

Official update scripts are available that let you update your 5.x installation to version 5.2:

Linux/macOS

1. Change to your openHAB root directory (e.g. cd /opt/openhab)
2. Create a backup by calling sudo ./runtime/bin/backup.
3. Run the update command:

sudo ./runtime/bin/update 5.2.0

Windows

1. Make a backup of your openHAB installation folder.
2. Run PowerShell as administrator and change to your openHAB root directory (e.g. cd C:\openHAB)
3. Run the update command:

. .\runtime\bin\update.ps1
Update-openHAB -OHVersion 5.2.0

Breaking Changes that Require Manual Interaction after the Upgrade

Changes in Core

• Persistence extensions with QuantityType as input now return results in the item unit or logically derived unit instead of the system unit. This may require changes to rules if you relied on the return values to be in the system unit.

Changes in Main UI

• oh-canvas-items now use 100% of the height their bounding box and center vertically in that bounding box. While this fixes incorrect behaviour, it might change the appearance of your oh-canvas-layout pages. In that case, you need to adjust the bounding boxes through their resize handles.
• oh-category-axis startOnSunday parameter has been removed. For chartType = week, the chart will either start on Sunday or on Monday depending on your locale. For chartType = isoWeek, the chart will always start on Monday.

Changes in Add-ons

AhaWasteCollection Binding

• A typo was corrected in the lightweight channel id, you may need to correct your configuration.

AirParif Binding

• Due to API evolutions pollens related information have been removed. They are now provided by Atmo France Binding.

Corona Stats Binding

• Due to EOL of the website, this add-on has been removed.

Matter Binding

• Contact sensors have now a contact-statevalue (mapping to Contact items) instead of the previous booleanstate-statevalue (mapping to Switch items).

Xiaomi Wifi devices (Mi IO) Binding

• Cloud login details have been depreciated at binding level. Add a new Cloud Connector Thing to to login with QR or userId.

MongoDB Persistence

• Support for database 3.6.x has been dropped. The add-on requires database version 4.0 or later.

MyBMW Binding

• Due to BMW security changes, this add-on does not work anymore and has been removed.

Piper TTS Voice

• Voice UIDs now contain the model quality. You need to setup your default voice again and adjust your rules & scripts for the changed voice UIDs.

Teleinfo Binding

• This binding has been rewritten to support the D2L ERL dongle. As a result, channels and channel types have changed, so you may need to recreate your Things and update your configuration.