Skip to content

openHAB 3.2 Release Notes

Kai Kreuzer edited this page Dec 19, 2021 · 1 revision

This is the official release of openHAB 3.2.0.

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

New and Noteworthy

The openHAB 3.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.

openHAB 3.2 is fully backward compatibility to openHAB 3.1 setups - there are only a few exceptions where manual action is required to adapt an existing setup, so please carefully check the section on breaking changes.

Quick links:

Relevant Changes

The following add-ons are newly introduced with the 3.2 release:

Add-on Type Issue
amplipi Binding #10983
anel Binding #10952
dbquery Binding #8780
deutschebahn Binding #11384
dominoswiss Binding #11585
ekey Binding #10996
ipobserver Binding #10567
mikrotik Binding #10014
orbitbhyve Binding #10426
proteusecometer Binding #11333
pushsafer Binding #10790
renault Binding #11467
SNCF Binding #11607
souliss Binding #11083
Tapocontrol Binding #11111
Twitter Binding #10241
wolfsmartset Binding #10751
jrubyscripting Automation #11538

The following improvements were made:

Type Issue Change
Enhancements 2405 Community Marketplace Add-on Service
2428 Add semantics to default system channel types
2437 Consistent ordering of entries in jsondb
2456 Make ScriptLibraryWatcher accessible for other languages than JS
2459 Implement a listener for ScriptEngineFactory changes
2477 Refine Rest Auth config parameters
2502 ChartServlet bug fixes and improvements
2519 Add ser2net mDNS USB serial discovery
2531 Prevent shutdown of shared thread pool
2533 Align item endpoint with items endpoint
2540 Log item name in warnings of ItemStateConditionHandler
2547 mDNS / UPnP discovery internationalization
2549 New exception class that incorporates support for internationalization
2567 Add variable 'triggeringChannel' to DSL rules
2570 Add Timer.isCancelled() method
2587 Add basic time-related classes for usage in script and rules
Bug Fixes 2435 Allow UoM in 'ItemStateCondition'
2470 Handle IP v6 in X-Forwarded-Host header
2486 Metrics improvements and fixes
2493 Prevent NSEE when there is no AddonService
2508 Fix add-on type inconsistencies
2563 Fix NPE in WatchQueueReader
2577 Fix IllegalStateException in IconServlet
2579 Fix ConcurrentModificationException in ExpiringUserSecurityContextCache
2602 Use Accept-Language header for locale in ConfigurableServiceResource
UI Type Issue Change
Basic UI Bug Fixes 1132 Fix handling of buttons when only 1 button
1139 Fix color selector placement
Main UI Enhancements 1100 Plan layout for floorplan-like pages with system/custom widgets
1145 Update alexa integration with new metadata syntax
1158 Replace Add-on Management UI with Add-on Store
1173 Add rule template support
1175 Add click action to oh-gauge-card
1179 Expand Blockly with new blocks (part 1) & update to latest version
1187 Addition of graphical layer management for canvas layouts
1209 Add a Blockly block to define key/value dictionaries
1212 Blockly enhancements - scripts, ephemeris, persistence
1220 Update alexa blind and channel attributes
1222 Update alexa thermostat hold attribute
1223 Update alexa position state and tilt angle attributes
1225 Add Block Libraries
1226 Add missing homekit configurations
1230 Update position state action mappings default value
Bug Fixes 1148 Fix detection of protected user API operations
1149 oh-icon component improvements, Iconify icon support
1151 Correct mimetype for disabling/enabling things call
1156 Fix oh-icon's f7/material icons on mobile
1167 Fix oh-icon not updating
1177 Fix home page initialization logic
1202 Fix addons details serviceId
1208 Remove alexa camera stream basic auth parameters
1231 Fix add link "compatible item" logic
1232 Add link: add semantic tags from channel/channel type
1233 Add missing style parameter to oh-icon
1236 Fix Blockly timer code
1240 JSScripting tern fixes
1243 Check config before allowing oh-icon style customization
Add-on Type Issue Change
AirQuality Enhancements 11192 Tagging channels, prepared for Crowdin, dynamic channels
airthings Enhancements 11052 Add support for Airthings Wave Gen 1
automower Enhancements 11323 Support for GPS coordinates provided by API
avmfritz Enhancements 11348 Add support for DECT500 and HAN-FUN bulbs
11682 Exclude other Powerline products from discovery
11723 Add support for HAN-FUN Color and Dimmable bulbs
Bug Fixes 11640 Add representation-property to bridge type definitions
11773 Fix update of data for blinds
11790 Prevent attempt to set brightness of blinds
benqprojector Bug Fixes 11140 Fix equalsIgnoreCase issue
bluetooth.bluegiga Bug Fixes 11179 Fix CompareObjectsWithEquals findings regression causing all devices to be beacons
bluetooth.enoceanble Bug Fixes 11381 Prevent that channels are triggered multiple times per click
BMWConnectedDrive Enhancements 11264 Authorization fix + channel enhancements
boschshc Enhancements 11134 Parental Controls for Thermostats; Wall Thermostats; Internal refactoring
bsblan Bug Fixes 11226 Several configuration parameters are not visible in Main UI
11229 Support quantity types for "number-value" channel
caddx Enhancements 10923 Add new channels and support for ignoring zone status transitions
chamberlainmyq Enhancements 11115 Add new Close Error and Open Error Switch channels
chromecast Enhancements 11510 Add support for next command
11689 Add configuration flag to disable background discovery
11694 Add pattern for DateTime channel types
danfossairunit Enhancements 11121 Change Humidity channel type from Number to Number:Dimensionless
11129 Add channel descriptions and categories
11147 Rename channel manual_fan_speed to manual_fan_step for consistency
11371 Add filter period channel
Bug Fixes 11172 Fix network reliability issues and setting of all channel values to zero
deconz Enhancements 10950 Use ChannelBuilder created by ThingHandlerCallback
Bug Fixes 11036 Change default color mode for color commands to XY
denonmarantz Bug Fixes 11766 Fix xml unmarshalling exception
digitalstrom Bug Fixes 11433 Fix remove excessive log statements for unknown Application Groups
11434 Fix NoSuchElementException when no functional groups set
doorbird Bug Fixes 11190 Fix controller id
dsmr Enhancements 11458 Add support for Austrian meters, Fix for channel id detection
Bug Fixes 11328 Fix payload length calculation for Smarty meters
ecotouch Bug Fixes 10989 Fix decimal values being truncated
enocean Enhancements 10769 Add second action for two rocker switches
10949 Add support for the D2_06_50 EEP type
11009 Standardize config URI
11230 Add support for Soda Handles (EEP D2-06-01)
Bug Fixes 11408 Fix concurrency exception on startup
epsonprojector Enhancements 10988 Add configurable volume channel range
Bug Fixes 11141 Fix equalsIgnoreCase issue
espmilight Enhancements 11047 Add color channels ability to trigger white LEDs
feed Enhancements 11345 Add channel for enclosure link on latest entry
fmiweather Bug Fixes 11025 Fix UNDEF observations in corner case situations.
fronius Enhancements 10757 Add inverter power, battery state of charge and PV solar yield
fsinternetradio Enhancements 11045 Add further supported devices
gardena Bug Fixes 10924 Fix OutOfMemory error if initializing fails
groovyscripting Enhancements 11251 Update Groovy to 3.0.9
haywardomnilogic Bug Fixes 11028 Remove erroneous chlorinator code from filterhandler
hdpowerview Enhancements 11155 Add new battery voltage channel
11198 Add new signal strength channel
11206 Add new battery level channel
11260 Add Hub configuration option hardRefreshBatteryLevel
11534 Add support for scene groups
11637 Add support for enabling/disabling automations
Bug Fixes 11201 Fix low battery when no battery status available
11552 Secondary shade position was inverted
11707 Fix initialization of shade handler
11779 Fix deprecated channels on reinitialization
homeconnect Enhancements 10914 Show response code in request details modal and JS code cleanup
10953 Predefined temp / spin speeds options for unsupported washer programs
11071 Add two channels for washer appliance
11706 Add oven control
Bug Fixes 10929 Catch exception when appropriate
10990 Fix update of channels linked to program options
homekit Enhancements 10936 Add support for group item type to window covering
Bug Fixes 11717 Make min/max values for Color Temperature configurable
11720 Restart HomeKit bridge on network changes
11731 Add setting to block homekit user/pairing deletion
homematic Enhancements 11186 Remove double press events and improve long press events for button trigger
11429 Improve (re)connect handling to Homematic gateways
Bug Fixes 10907 Fix UI enumeration of HM-MOD-EM-8 channels
10942 Update property files
10965 Provide additional null pointer checks
11493 Fix "Channel not found for Datapoint" errors
homewizard Bug Fixes 11666 Fix issue with missing gas values
hpprinter Enhancements 11739 Change status channel from hash map values to state description options
hue Enhancements 11452 Add LightActions to Hue light groups
11535 Factorize thing configurations
11572 Add workaround for LK Wiser products
Bug Fixes 11289 Make sure bridge status is set when returning from initialize
11519 Fix unicode character in translation
hueemulation Bug Fixes 10692 Fix xy change response
hydrawise Bug Fixes 10947 Migrate to new GraphQL based API
icalendar Bug Fixes 11178 Fix internal calculation for retrieving events for command tags
icloud Bug Fixes 11600 iCloud response invalid: null (second time)
ihc Bug Fixes 10895 Improve command handling when controller is not ready
influxdb Bug Fixes 10937 Fix queries with InfluxDB 2.0 with data migrated from InfluxDB1 without item tags
insteon Enhancements 10908 Add representation property for devices
ipcamera Enhancements 11067 Improve FFmpeg motion detection to support wider FPS range
11160 Move to using port 8080 servlet not Netty.
11419 Improvements and fix 503 errors go to offline with Hik
11748 Add new channel lastEventData for detailed extra data on alarms
Bug Fixes 11089 Fix bugs, IndexOutOfBoundsException and remove sleep
11300 Fix ipcamera.jpg can return an old picture
11457 Fix Hikvision digest stopping ipcamera.mjpeg
irobot Enhancements 11783 Add zone support
jdbc Enhancements 11023 Select the proper schema when retrieving the item tables
11091 Add support for TimescaleDB (#11090)
js-transform Enhancements 10901 Introduce support for additional parameters
11473 Inline java script support
jsscripting Enhancements 11437 Update GraalJS to 21.3 to allow method selection via JavaScript
11656 openhab-js integration
11693 Add simple Shared Cache into scope
11719 GraalJS now uses automation/js
Bug Fixes 11400 Tell the script context to use the classloader of the current class
kaleidescape Enhancements 11231 Add configuration option to auto load metadata channels without rules
11258 Improve discovery service
knx Enhancements 11759 Upgrade Calimero library to release 2.5
kodi Enhancements 11181 Add channel for KODI JSON-RPC call Input.ButtonEvent
kostalinverter Bug Fixes 11002 Fix using binding together with z-wave binding
lgtvserial Bug Fixes 11776 Fix sending commands using serial port
lgwebos Enhancements 10971 Switch to default system channel types
Bug Fixes 11461 Fix a setting description
lifx Enhancements 11262 Support HEV clean cycle
11309 Add channels for controlling absolute color temperature in Kelvin
11405 Add missing products
Bug Fixes 11180 Add missing color feature to a few products
11653 Improve InterruptedException handling
linky Enhancements 11647 Few debug logs added
Bug Fixes 11406 Correct authentication bug
logreader Enhancements 11681 Add pattern for DateTime channel types
loxone Enhancements 11240 Support for SHA-256
11270 Sauna controller implementation
lutron Enhancements 11726 Explicitly enable proper monitoring types for HomeWorks connections
Luxtronik Bug Fixes 11318 Fix possible out of bound error for older heatpumps
LuxtronikHeatpump Enhancements 11135 Fix/update channels for setting hot water target temperature
11273 Add channel for heating limit temperature
magentatv Bug Fixes 11238  Fix start UPNP listener to catch power off button, thing id in log
mail Enhancements 11307 Add support for e-mail headers
mcp23017 Enhancements 11010 Standardize config URI
MeteoAlerte Enhancements 10993 Small code enhancements
metrics Enhancements 11249 Add Java Management Extensions (JMX) metrics exporter
Bug Fixes 11280 Fix configuration PID and add file based configuration example
miele Enhancements 11298 Add new power and water consumption channels for dishwashers and washing machines
11329 Temperature channel improvements: UoM, categories and descriptions
11341 State/program/phase: Add raw channels and improve text channels
11603 Localization of state, program and phase
11782 Reduce log level to TRACE for request/response logging
Bug Fixes 11218 Fix broken things file support
11244 Fix multicast and multi-protocol support (ZigBee/Wi-Fi)
11287 Fix IllegalArgumentException when using oven channel 'type'
11302 Fix coffee machine auto-discovery
11321 Fix supercool/superfreeze for fridges/fridge-freezers
11417 Fix reading of water/power consumption on some appliance models/configurations
11423 Clean up properties and improve reliability and performance
mielecloud Bug Fixes 10928 Less strict e-mail validation
11073 Remove e-mail parameter validation
miio Enhancements 10951 Change deviceID to Xiaomi used string
10957 Add new custom refresh methods and improve response to channel matching
10984 Improve yeelight RGB with brightness, introduce substitutions
11097 Add moppath & carpet area to robomap
11106 Add support for Mi Smart Standing Fan 2 (dmaker.fan.p18)
11110 Map improvement cropping and customizable colors/parameters
11118 Improve/add properties for qmi powerstrip
11142 Add support for mi airfryers (careli.fryer.maf01,2&3)
11149 Automatic create experimental support for (unsupported) miot devices
11164 Add support for Smartmi Fresh Air System (zhimi.airfresh.va4&va2)
11241 Add support for Yeelight Jade Smart LED Ceiling Light
11464 Save last msgId and misc minor updates
11475 Sending device in MiIoSendCommand
11477 Support contact type in basic channel json
11492 Add support 3 yeelights
11568 Move (remaining) channel details to json files
11576 i18n translation handling for basic channels
11577 Add support Mi Smart Humidifier deerma.humidifier.jsq5
11579 Add support Mi Fresh Air Ventilator C1-80 zhimi.airfresh.ua1
11581 Support sending openclose commands
11657 Add support for BT Gateway switch on chuangmi.plug.212a01
11659 Add new vacuum status codes
11669 Add support for new dreame vacuum models (p2027,p2028,p2059)
11687 Add support for Mi Smart Humidifer S (deerma.humidifier.jsqs)
11715 Add BT Devices channel to chuangmi plug
11727 Add support for Roidmi EVE roidmi.vacuum.v60
11763 Improve Viomi vacuums, add docking and route channel & mapping
Bug Fixes 10960 Fix color lights sending numbers as strings
11166 Avoid shutting down shared executor service
11420 Avoid NPE in discovery in case of unexpected response cloud
11455 Avoid excessive MessageSenderThread
11459 Force start cloudconnector after credentials are updated
11658 Fix Error parsing miot data null for new miot devices
11722 Fix zhimi.airpurifier.vb2 channel unit
11794 Fix action channel miot for empty input with parameters
miio/ntp Bug Fixes 11699 Fix wrong "Date" channel category
mikrotik Enhancements 11395 Basic PPP/LTE interface support
Bug Fixes 11386 WiFi client logging and presence problem fix
milight Bug Fixes 11367 Fix minimum value for parameter repeat
misc Bug Fixes 11313 Fix/remove outdated "Default Tags"
11643 Bump jsoup from 1.8.3 to 1.14.3
modbus Enhancements 11292 Clarify error messages with invalid configuration
Bug Fixes 11281 Remove helioseasycontrols binding.xml causing binding identification issues
mqtt Bug Fixes 9851 Fix availability topics subscription after Brige Restart
10566 Discovery services shall not unsubscribe unless they have already subscribed
mqtt.espmilighthub Enhancements 11098 Sematic tags added.
mqtt.homeassistant Enhancements 11216 Implement Vacuum discovery for Homeassistant MQTT
11562 Make the mqtt.vacuum compliant
Bug Fixes 11315 Discovery exceptions processing
myq Bug Fixes 11183 Switch to using OAuth for logins
11343 Fix a serious issue that could wipe out all OH cookies
11601 Fix breaking API changes to the MyQ binding
11765 Fix for controlling lights
nanoleaf Enhancements 11133 Reimplement touch detection based on SSE, stabilize behavior, add swipe support
network Enhancements 11199 Add possiblity to send WOL Requests to configured Hostname
networkupstools Enhancements 11082 Add missing status
nikobus Enhancements 11011 Standardize config URI
11548 Add option to set rollershutter position
nikohomecontrol Enhancements 11319 Prepare for translation
Bug Fixes 11737 Fix dimmer control sequence
11751 Add ability to directly use virtual flags as switches
nuki Enhancements 10672 Add opener support and discovery
nuvo Bug Fixes 11511 Fix protocol errors when connecting via an MPS4
nzwateralerts Bug Fixes 11734 Fix smart water alert level
ojelectronics Bug Fixes 11555 Fix server timeout is stopping the extension
omnikinverter Enhancements 11645 Add channels for voltage and current
OmniLink Bug Fixes 11005 Fix zone bypass/restore commands
openhabcloud Bug Fixes 11153 Reconnect on connection errors
11404 Spelling fix ("Notificaton" -> "Notification")
opensprinkler Enhancements 9869 Fix bugs and warnings
openweathermap Bug Fixes 11086 Fix ozone mapping in DTO
11255 Fix NPE on OneCall-API and reduce min refreshInterval to support paid plans
11360 Bridge status set to ONLINE when no attached things
openwebnet Enhancements 11398 Add support for CEN/CEN+ scenarios (WHO=15/25)
11747 Add support for Dry Contact and IR interfaces for WHO=25
Bug Fixes 10934 Fix messages flooding BUS on reboot
11644 Fix discovery of devices on local bus.
11705 Reduced log messages during UPnP bridge discovery
phc Bug Fixes 11554 Fix bug and add support for multiple commands
pidcontroller Enhancements 11312 Improve logging
pjlinkdevice Bug Fixes 11472 Fix authentication
plugwise Bug Fixes 11746 Fix 'power' channel not correctly updated with power production
powermax Enhancements 10624 Introduce some new channels for better status reporting
11275 Add null annotations
pulseaudio Enhancements 11055 Move the binding config in file binding.xml
11631 Add reencoding to play more audio formats
Bug Fixes 11171 Fix playing time with pulseaudio sink
11276 Fix sink-input configuration and other
pushover Enhancements 11027 Add support to send an Image URL directly
radiothermostat Bug Fixes 11635 Fix JSON thermostat data parsing error
rfxcom Enhancements 10940 Add ability to properly receive configured command ids, deprecate hard-coded guesses
robonect Enhancements 11014 Standardize config URI
11137 Channel for distance from charging station on remote start
roku Enhancements 11087 Add additional functionality for Roku TVs
rotel Enhancements 10969 Add semantics to channel types
rrd4j Enhancements 11355 Upgrade rrd4j, improve exception handling
sagercaster Enhancements 11295 Enhance binding internals
11665 Reintroducing timestamp channel
samsungtv Bug Fixes 11487 Fix reconnect after first connection to TV is lost
semsportal Bug Fixes 11127 Fix lastUpdate parse format to accept the format provided by the inverter
sleepiq Bug Fixes 11700 Use constructor injection for ClientBuilder
smhi Bug Fixes 11113 Fix IndexOutOfBoundsException in aggregator function
11353 Ensure trailing zeroes are removed before updating channels
somfytahoma Bug Fixes 11254 Fixed rssi channels creation & properties updating
sonos Enhancements 10979 Add new channel codec for several models
Bug Fixes 10925 Filter Sonos Sub from discovery
sonyprojector Enhancements 10970 Switch to the default system channel type for power channel
spotify Enhancements 11370 Various enhancements and fixes
squeezebox Bug Fixes 11151 Fixes volume parsing when volume string is a float
surepetcare Bug Fixes 11235 Check for null before updating pet location channels
systeminfo Enhancements 11016 Standardize config URI
11274 Upgrade OSHI dependency for latest fixes/improvements
11322 Add 2 new channels for Java heap
Bug Fixes 11351 Fix heap graph too high on axis.
telegram Enhancements 9251 Add event channels and Answer overload
11125 Send message if a file download fails
Bug Fixes 11215 Fixes exceptions that stop rules/actions from finishing
teleinfo Enhancements 11375 Add support for Standard tic mode
tivo Bug Fixes 10902 Fix thing staying offline after connection refresh
tplinksmarthome Enhancements 11015 Standardize config URI
11282 Added new devices EP10, EP40, KL125, and KL135
Bug Fixes 11680 Fixed invalid channels in KL125/KL135 definition.
tr064 Enhancements 10959 Add Wifi Signal Strength & Wifi Speed channels to LAN Subdevice
Bug Fixes 11337 Fix incorrectly reported decibel values for DSL Noise Margin and Attenuation
unifi Bug Fixes 11411 Fix thing configuration reload after changes
11451 Fix online/blocked channels after client is disconnected
upb Enhancements 11012 Standardize config URI
11352 Handle device state reports
Bug Fixes 11342 Fix retry logic
velbus Bug Fixes 11553 Fix typo in the Counter Channel name for VMB7IN
venstarthermostat Enhancements 11305 Add more channels provided by the local API
verisure Enhancements 11265 Adapted to new authentication process and support for non MFA activated user
Bug Fixes 11108 Fix Binding not working properly HANDLER_REGISTERING_ERROR
11397 Keep refreshing after RuntimeException
VigiCrues Enhancements 10992 Adding localization and a bit of code cleansing
volvooncall Enhancements 10991 Extend battery channels
wemo Enhancements 11208 Add dimensions for power/energy channel types for Insight Switch
Bug Fixes 11385 Fix wrong brightness value for dimmer switch
11679 Fix receiving empty binary state during poll
wled Enhancements 11509 Abstract json api for better segment support
11785 Add configuration to sort state options of channels
Bug Fixes 11389 Fix Nightlight sleep timer to use default time
11786 Fix two events being logged when light is off
11797 Fix global OFF blocks lights turning on via the masterControls
XMLTV Enhancements 11594 Preparing for Crowdin and code refining
xmppclient Enhancements 11247 Add send image throught HTTP
11418 Set dependencies in the pom.xml to provided
yamahareceiver Enhancements 11063 Add possiblity to switch HDMI outputs on and off on Yamaha receivers
Bug Fixes 11471 Handle 'No Preset' tuner preset response properly
yeelight Enhancements 11013 Standardize config URI
Zigbee Enhancements 659 Allow Zigbee channel to be set on running system
667 Ensure metering data is handled as floating point
668 Update Instantaneous Demand channel to use floating point
674 Add neighbors console command
678 Add firmware update command to console
689 Add device type to label in LevelControl and OnOff converters
692 Start Ember statistics polling after completion of initialisation
693 Avoid running multiple polling threads per device
695 Add support for listening to group addresses on Ember coordinator
697 Provide option to invert level control and level reports
698 Add configuration for FanControl cluster
700 Simplify mechanism to detect thermostat channels
708 Treat DefaultResponse SUCCESS as confirmation of device state being updated
710 Hue control selection
713 Remove ZigBee library deprecations from a number of converters
714 Remove deprecations and monitor color command responses
715 Monitor responses to commands on several channel converters
Bug Fixes 658 Ensure coordinator IEEE address is set on startup
662 Change type of summation for reporting configuration
663 Fix cluster definition for electrical metering channels
666 Fix metering data type
669 Fix SmartThings motionv4 channels - add temperature
677 Fix incorrectly named temperature channel in SmartThings motionv4
687 Ensure consistent use of LOCKSTATE for door lock channel
719 Ensure node descriptor is not null when setting properties
zoneminder Bug Fixes 11159 Fixes API structural change relating to the location of event counts
11463 Fix calls to set state options
ZWave Enhancements 1675 Support raw String color definition
zway Enhancements 11122 Change minimum polling interval to 1 second.

If you are working with an openHABian setup, the upgrade is quite easy. Regardless of if you are currently using the openHAB 2.5 or 3.x stable release or one of the latest 3.2.0 SNAPSHOT or milestone builds, switching to openHAB 3.2.0 stable is done in just a few steps:

  1. Connect to the SSH command line and execute: sudo openhabian-config
  2. When being asked, answer that you want to update.
  3. Select the menu entry"03 - Install openHAB" option.
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 3.2.0 and its optional add-ons with:

sudo apt-get install openhab=3.2.0-1

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

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 3.2.0 and its optional add-ons with:

sudo yum install openhab-3.2.0-1

## optional addons for offline installation ##
sudo yum install openhab-addons-3.2.0-1

Official update scripts are available that let you update your 3.x installation to version 3.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 3.2.0

Windows

  1. Make a backup of your openHAB installation folder.
  2. Run PowerShell as an 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 3.2.0

Air Quality Binding

Full refactoring of things and channels. Please read the updated documentation and start with new things.

DanfossAirUnit Binding

The channel 'manual_fan_speed' has been deprecated and replaced by channel 'manual_fan_step'. Items should be relinked to the new channel.

EnOcean Binding

The RockerSwitch channels do not longer react if two buttons of a rocker switch are pressed simultaneously. If needed, the new channel RockerSwitchAction can be used instead.

Homematic Binding

The DOUBLE_PRESSED trigger event was removed from the BUTTON channel. If needed, it can be replaced by a rule triggered by the SHORT_PRESSED event which employs a timer to check for double presses.

Hunter Douglas (Luxaflex) PowerView Binding

Channel groups have been introduced for the PowerView Hub thing. Scene channels should be relinked to the new channels for channel group 'Scenes'.

IpCamera Binding

The URLs that serve the files have changed to now be on port 8080 and the serverPort config is no longer needed. Update any widget and rules if you have hard coded the URLs into them.

LG webOS Binding

The type of the channels 'power', 'mute', 'volume' and 'mediaPlayer' was updated. You may need to remove and create again your things in case your things were previously created using UI and you want to use one of these channels.

Miele Binding

The temperature channels have been converted from Number to Number:Temperature.

The channels 'state', 'program' and 'phase' are improved with better and possibly localized texts. Rules should use the new channels 'rawState', 'rawProgram' and 'rawPhase' for reliability. Please see the binding documentation for details.

RFXCOM Binding

Lighting4 default command ids are deprecated and will be removed in a future version. You must specify command ids in the thing configuration for Lighting4 devices.

Sager Weathercaster Binding

The type of the channels 'pressure', 'temperature' and 'wind-angle' was updated. You may need to remove and create again your things in case your things were previously created using UI and you want to use one of these channels.

Sony Projector Binding

The type of the channel 'power' was updated. You may need to remove and create again your things in case your things were previously created using UI and you want to use this channel.