Skip to content

openHAB 3.4 Release Notes

Kai Kreuzer edited this page Dec 19, 2022 · 2 revisions

This is the official release of openHAB 3.4.0.

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

New and Noteworthy

The openHAB 3.4 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.4 is fully backward compatible to openHAB 3.3 setups - there are only a few exceptions in certain bindings 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:

Add-on Type Issue
Bond Home Binding #13459
Easee Binding #12954
EchonetLite Binding #11999
Ecowatt Binding #13404
JuiceNet Binding #10768
MCD Binding #13051
MEATER Binding #13400
MercedesMe Binding #13044
Mimic Text-to-Speech Voice #13045
NoboHub Binding #12937
Philips Somneo Binding #12321
Qolsys IQ Binding #13699
SMSModem Binding #12250
SolarMax Binding #10414
TP-Link Router Binding #13369
Vizio Binding #13309
WebexTeams Binding #13492

The following improvements were made:

Type Issue Change
Enhancements 2887 Add an access-tracking cache to be used in rules
2891 Add WebSocket for receiving events
2970 Add REST support for deleting links and removing orphaned links
2981 Wait for thing-type available in PersistentInbox
2984 Allow bulk deletion of metadata
2985 Add semantics query endpoint to item resource
3007 Log a warning when item for trigger/condition is missing or removed
3022 Improve UID error message
3024 Normalize thing configuration before initialization
3027 Add missing & refactor existing button toggle profiles
3036 Enhance transformation configuration
3045 Enrich distribution add-on with configDescriptionURI
3051 Add "time only"-Option for DateTimeTrigger in rules
3068 Add additional MqttBrokerConnectionConfig options
3075 Add visibility and color parameters to UI sitemap provider
3078 Rethrow 'IOException' instead of swallowing it
3079 Add default channel types for electrical energy
3086 Support sending a keepalive packet to SSE item state connections
3100 Allow stop single dialogs and start dialog on an existing processor
3106 Grant implicit user role by network
3108 Support mired units
3111 Implement command completion in console for openhab command
3113 Add more basic time-related classes for usage in script and rules
3115 Allow sending QuantityType to NumberItem
3116 Allow sending IncreaseDecreaseType directly to DimmerItem
3129 Update system.color-temperature-abs channel type to be a Number:Temperature
3138 Add DateTime handling to ItemStateConditionHandler
3139 Add actions/commands to synthesize melodies and add configurable melody to the dialog processor
3145 Add countSince/countBetween to persistence extensions
3147 Upgrade Californium to 2.7.4
3151 Allow profiles to access the entire context of the link they're applied to
3155 Refactor ScriptExecution to plain Java ScriptExtension
3156 Add unmanaged scripts to rule registry
3160 Allow running rules with context
3165 Add hsb/rgb format rendering for HSBType
3170 Tweak ScriptedRuleProvider slightly
3176 Log full exception information when calling JSR223 scripts
3177 Add QuantityType.toUnitRelative
3187 DSL support for sharedCache/privateCache
3201 Improve UoM handling
3211 Add countStateChangesSince/countStateChangesBetween to persistence extensions
Bug Fixes 2958 Normalize Metadata configuration from managed provider
3023 Fix symlinks not followed
3042 Fix marketplace add-on uninstall
3049 Improve FeatureInstaller
3053 Prevent crash on invalid entry in ManagedThingProvider
3060 Adjust to system timezone
3066 Migrate usage of LocalDateTime to Instant
3069 Use configured locale for SSE displayState
3072 Fix missing initial thing status event
3080 Check for an existing thing handler before updating config
3083 Fix access token serialization/deserialization
3092 Fix StartLevelService "hanging" if config is changed.
3094 Add swp to ignored extensions in FileTransformationProvider
3095 Use identifier when rescheduling the timer
3099 Sort JSR223 scripts by start level before filename
3110 Fix AuthFilter crash if trusted network not configured
3124 Properly process retained messages
3134 Fix invertible unit conversions when sent via a binding
3136 Fix ItemStateCondition for PercentType values
3137 Avoid parallel streams with common thread pool to avoid deadlocks
3143 Add default units for all dimensions
3144 Fix missing stateDescriptionProvider in Group items
3153 Strip unit if NumberItem has no dimension
3154 Fix wrong parameter on AuthorizePageServlet
3157 Fix config normalization in ThingUpdatedEvent
3162 Fix bug in migrateThingType to not call managed thing provider directly
3168 Refactor script dependency tracking
3178 Fix transformRaw validation errors in DSL rules
3182 Return the precise scheduled execution time for timers
3185 Fix ScriptFileWatcher for entire directories
3188 Fix CME when creating SCRIPT transformations
3190 Fix start dialog with non default voice (broken recently)
3202 Fix AVG calculation in GroupFunction
3204 Fix timer cancellation in automation cache
3208 Fix DataAmount dimension units
3215 Fix NPE in PersistentInbox
3216 Fix AbstractScriptFileWatcher missing deletes on Windows
3219 Fix BasicAuthentication for websockets
3223 Fix wrong websocket topics
UI Type Issue Change
Basic UI Enhancements 1426 Add support for webaudio
Bug Fixes 1547 Consider item state for the color picker
1548 Fix the color picker
CometVisu Bug Fixes 1535 Various fixes for the CometVisu-manager backend
HABot Enhancements 1445 Add default translations for WebPushNotificationAction
HABPanel Enhancements 1572 New Crowdin updates
Main UI Enhancements 1422 Add support for webaudio
1444 Item expire metadata: clarify ignore state update reset rules
1450 Allow loading file-based ruby scripts in rule editor
1453 New SIP client component & widget
1454 Use the new foregroundService for the image widget
1469 Add poster image option to video widget
1470 Use concurrent lazy loading for images
1474 Refactor ring & ring back tone to catch exception in sip-client
1487 Add missing sitemap attributes
1489 Readd alexa camera stream basic auth parameters
1495 Fix date comparison
1496 Finally the right implementation for parsing date formats
1498 Thing "actions" config param handling made generic
1499 Monitor SSE Connection Health
1510 Access screen info in expressions context
1519 Evaluate expressions in configuration Arrays & Update actionPhotos docs
1521 Use a custom servlet for serving files to support caching of files
1522 Update widget expression capabilities
1524 Put boxes arround addons cards for better seperation
1539 Update GA metadata to current state
1540 Filter rules/scripts by id and rule status
1543 add support for further HomeKit parameters
1544 Update alexa camera stream basic auth parameters
1545 New sub-component for oh-cards footers to allow several text layouts
1549 Add new list, item, persistence, text blocks
1554 Fix canvas layout display in full screen.
1556 Add possibility to edit JSON variable keys in widgets
1557 Add robots.txt to disallow search crawler
1558 Extend default standalone/item/cell widget selection
1582 Add context parameter to rule action
Bug Fixes 1435 Hide 'NULL' group labels in oh-label-item, second take.
1436 Revert equipment accordion link styling.
1447 Fix running the dev server
1458 Fix identification of ruby scripts in editor
1459 Fix foreground service with modal pop-ups
1462 Fix the stepper from making phantom commands when a value is outside of the min/max
1472 Fix z-index of oh-masonry component
1490 Allow overview page to be a fixed layout page (unsupported feature)
1501 Fix config sheet & parameter group padding
1525 Input elements fix datetime-local and add datepicker time
1527 Temporarily remove state options check in analyzer
1530 Improve sitemap validation
1531 Fix evaluating arrays - cached expressions can be overwritten
1559 Fix items disappear from model if stateDescription is added
1564 Fix oh-trend sampling property
1574 Improve sitemap handling
1575 oh-sipclient: Fix microphone access stays active when foreground is left on iOS
1578 Normalize channel label before suggesting it as item name
1583 Fix inconsistent cell max-width
Add-on Type Issue Change
ahawastecollection Enhancements 13342 Upgrade jsoup from 1.14.3 to 1.15.3
amazonechocontrol Enhancements 13067 Add channels to thermostatController
androiddebugbridge Enhancements 13462 Add mDNS discovery for android tv
Bug Fixes 13390 Fix get current package and get MAC address.
13828 Fix volume channel for android 11/12
astro Bug Fixes 13884 Fix IllegalArgumentException in debug message
atlona Bug Fixes 13215 Fix NPE on shutdown when Thing disabled
automower Bug Fixes 13263 Adapt login due to Husqvarna API change
avmfritz Enhancements 13672 Decode alarm state for blinds
Bug Fixes 13317 Allow to set every userdefined color
awattar Bug Fixes 13730 Fix that allows bridge to be added via UI.
benqprojector Bug Fixes 13549 Log invalid number when expecting numeric response from projector
bluetooth Enhancements 10278 Add support for service data
bluetooth.ruuvitag Bug Fixes 13279 Correctly parse NA temperature & acceleration
boschindego Enhancements 12989 Add channels for last/next cutting time
13034 Add support for new status codes
13040 Add battery and garden channels (including map)
13058 Add missing specialized text for unreachable device
13065 Add support for SpotMow status code
13081 Optimize coexistence with mobile app/other clients
13179 Plot location on map
13192 Provide faster channel updates
boschshc Enhancements 13533 Support for Compact Smart Plugs
13631 Support obtaining battery states
13725 Support smart light bulbs
13760 Support smoke detector
broadlinkthermostat Enhancements 13412 Aesthetic rename and add RM Mini
caddx Bug Fixes 13521 Correct status initialization of the things after a restart
daikin Bug Fixes 13206 Fix switching specialmode to NORMAL
dali Enhancements 12955 Implement DT8 (single-channel RGB & color temperature) device type
dsmr Enhancements 13359 Made additional key for smarty meter an option
Bug Fixes 13076 Fix incorrect deriving of sub channel names when updating channels
ecobee Enhancements 13705 Add air quality channels for Ecobee Smart Thermostat Premium
enocean Bug Fixes 13792 Fix messages with MSC RORG
epsonprojector Bug Fixes 13550 Log invalid number when expecting numeric response from projector
evcc Enhancements 13795 Extend accepted types for commands & Handle quantity types of commands
Bug Fixes 13710 Fix data type issues in DTO
fineoffsetweatherstation Enhancements 13138 Add support for ELV protocol
13283 Add support for the new GW2001 weather station
13284 Add channel for the sensors battery voltage
Bug Fixes 13139 Fix conversion of pressure
13381 Fix measurands
freebox Enhancements 13591 Console command completion
ftpupload Enhancements 12693 Upgrade dependencies
gardena Enhancements 13016 Improve API rate limit handling
13050 Adapt the login for API version 1.1
Bug Fixes 13238 Eliminate frequent web service re-starting
gce Bug Fixes 13526 Avoid conflicts with things file defined
13545 File based items are not updated
goecharger Enhancements 13105 Add transaction API key
Bug Fixes 13052 Fix data type for energy (nrg)
13927 Consider correct channel ID (maxCurrentTemp)
googlestt Enhancements 13491 Upgrade protobuf-java from 3.19.2 to 3.19.6
Bug Fixes 13043 Fix authorization from returning null refresh token
googletts Bug Fixes 13042 Fix authorization from returning null refresh token
groheondus Enhancements 11955 Fix missing automatic refresh ++
13665 Upgrade dependencies
groovyscripting Enhancements 13822 Update Groovy to 3.0.13
groupepsa Enhancements 13386 Consider TimeZoneProvider to build states for time-stamp channels
Bug Fixes 13083 Handle 'JsonSyntaxException' when parsing error messages
harmonyhub Bug Fixes 13702 Fix reliability issues
haywardomnilogic Enhancements 13164 Add http timeout retry
Bug Fixes 13146 Empty XML Response Handling
hccrubbishcollection Bug Fixes 13306 Update API URL
hdpowerview Enhancements 13096 Add shade RF RSSI channels for hub/repeater
13110 Add support for Vignette and Duette Architella
13174 Add additional hub properties
13275 Channels are visible depending on shade capabilities
13324 Battery channels visible only when required
13330 Correct shade capabilities information
13571 Add support for Skyline Panels
13574 Add support for Duette and Applause Skylift shades
13615 Add console extension for showing IDs
Bug Fixes 13031 Fix missing shade capabilities on v1 hubs
13155 Fix excessive firmware version updates
13169 Fix tilt support for vertical slats
homeconnect Bug Fixes 13653 Fix login for simulator environment
homekit Enhancements 12985 Target Fan state - add support for Switch Item
13226 Allow multiple bridge instances to break the 150 limit
13228 Support actual booleans in metadata config
13236 Allow group items of the correct type anywhere that type is needed
13449 Allow NumberItems for BatteryLowStatus
13484 Persist all known accessories, to prevent loss of homekit information
13504 Allow RelativeHumidity as an optional characteristic on Thermostat
13507 Fix BooleanItemReader to work with DimmerItems
13508 Allow configuring maxValue on VOCDensity
13509 Allow Long type in configuration for numbers
13510 Get min/max/step values from state description if possible
13538 Increase flexibility of ColorTemperature
13564 Add BasicFan accessory
13566 Improve bundle deactivation time
13569 Improve output of console's homekit show command
13741 Simplify settings page, resize doc images
13788 Support stop for blinds
13878 Implement basic command completion
Bug Fixes 13122 Fix potential null pointer exceptions
13232 Fix window coverings based on groups of rollershutters
13233 Fix collecting characteristics that don't belong to a complex accessory
homematic Bug Fixes 13168 Allow default value that is less than allowed minimum
13626 Some HM devices are using relative humidity (% rH/rF) as units
13821 Fix min/max values for rollershutters
http Bug Fixes 13191 Fix rollershutter return as position always undef
hue Enhancements 11842 Change discovery to mDNS; added HTTPS handling; refactor HTTPClient to use jetty shared client
13597 Console command completion
Hydrawise Bug Fixes 13268 Fix concurrent error
13965 Fix null pointer error for some sprinkler controllers
iaqualink Bug Fixes 13073 Fix to work with recent API changes to the iAqualink cloud service
icloud Bug Fixes 13117 Fix COMMUNICATION_ERROR iCloud response invalid: null (Jul…
13691 Rework authentication to reflect changes in iCloud API
insteon Bug Fixes 13030 Set network to ONLINE after driver is initialized
intesis Enhancements 13244 Add Wi-Fi signal strength channel to intesisHome and fix some NPEs
ipcamera Enhancements 13446 FFmpeg based alarms now auto restart if stopped
13773 Improve support for newer 2k+ Instar cameras
13805 Instar API updates for new 2k+ range
Bug Fixes 13035 Add URL encoding fix for passwords that contains special characters.
13396 Fix ONVIF fails to reconnect
13502 Fix ipcamera.mjpeg won't open multiples when port not 80
13606 Fix multiple WARNs when HIK camera does not support alarm inputs
13896 Add a check to see if FFmpeg is frozen for mjpeg creation
ipobserver Enhancements 13343 Upgrade jsoup from 1.14.3 to 1.15.3
jablotron Enhancements 13361 Add thermometers support for JA100F alarms
jdbc Enhancements 13038 Upgrade derby from 10.12.1.1 to 10.14.2.0
13242 Upgrade MySQL JDBC driver to 8.0.30
13429 Fix warnings and apply null annotations
13483 Consolidate and optimize datetime conversions
13544 Add support for case sensitive table names reflecting item names 1:1
13659 Upgrade MariaDB JDBC driver to 3.0.8
13662 Add console maintenance commands
13726 Improve error handling safety
13733 Add console command for reloading index/schema
13737 Make itemsManageTable configurable
13765 Add console command for checking/repairing schema integrity
13770 Update PostgreSQL JDBC driver to 42.4.3
13797 Add safety valve for suspicious migrations
Bug Fixes 13660 Fix MySQL deprecation notice on startup
13728 Fix possible index corruption when uninitialized
13734 Fix date filter to be inclusive
13745 Fix PostgreSQL query for storing timestamps
13817 Fix Derby/H2/HSQLDB/SQLite queries for storing timestamps
13843 Fix date filter to be inclusive (PostgreSQL)
13850 Fix date filter to be inclusive (Derby)
jellyfin Enhancements 13389 Add play by id channels and update sdk
13436 Add URL path support
Bug Fixes 13572 Upgrade sdk, fixes json parse error
jinja Enhancements 13344 Upgrade jsoup from 1.14.3 to 1.15.3
jpa Enhancements 13516 Add dynamic import, upgrade dependencies, add UI config
Bug Fixes 13532 Fix Derby driver no longer included
jrubyscripting Enhancements 13151 Check if gems are installed before installing them
13280 Update to jruby 9.3.7.0 to fix BootstrapMethodError
13548 Don't manually filter presets.
13778 Log Ruby stacktrace on exception from JRuby
13779 Allow multiple version specifiers for gems
13810 Implement dependency tracking
Bug Fixes 13328 Avoid polluting environment when auto-installing gems
jsscripting Enhancements 13576 Name timers created by polyfills
13623 Reimplement timer polyfills to conform standard JS
13695 Reimplement timer creation method of ScriptExecution
13844 Refactor log formatting & Respect toString polyfills
13851 Add an alternative MIME type/alias
13908 Upgrade openhab-js & Remove SharedCache
Bug Fixes 13565 Upgrade openhab-js to 2.0.4
13582 Fix multi-thread access
13714 Fix failure on some platforms & JDKs
13749 Fix the console.trace polyfill to log a stack trace & Stringify JS Error
13756 Refactor dependency tracking
13824 Fix memory leak that crashes openHAB
13924 Extend synchronization to common ScriptEngine methods
km200 Bug Fixes 13152 Fix for KM100 with Firmware 04.08.02
knx Enhancements 12709 Add support for KNX IP Secure
13293 Improve localization
Bug Fixes 13897 Improve handling of serial gateways
konnected Enhancements 13180 Add support for Konnected Pro
13251 Add base URL to config to allow for manually adding thing
13295 Set auto discovered callback URL in configuration
Bug Fixes 13329 Fix null pointer exception on state update with missing state
13333 Remove defaults for zone configuration parameter from the channels
13354 Use default onvalue if configured is null
13360 Take configured onValue into account when sending status to actuator
13380 Configure zone on panel even if the channel is not yet linked
kostalinverter Enhancements 13490 Fix for the Kostal inverter binding to work with different firmware releases regarded to PIKO 10-20 V. 221004
KVV Bug Fixes 13186 Replace underlying API
lcn Enhancements 13056 Add shutter positioning/angle, operating hours counters, tunable white, regulator mode, beeping
13460 Improve logging
Bug Fixes 13690 Fix setting of variables
lgwebos Enhancements 13590 Console command completion
13618 Action sendKeyboard added, sendButton updated, sendRCButton removed
lifx Bug Fixes 13744 Set tagged flag accordingly for unicast and broadcast messages
linky Enhancements 13589 Console command completion
Bug Fixes 13482 Avoid internal server error (getting power peak early in the morning)
linuxinput Bug Fixes 13632 Handle keys not known by libevdev
lutron Enhancements 13299 Add mDNS discovery for RadioRA 3 processor
LuxtronikHeatpump Enhancements 11907 Add discovery service
mail Bug Fixes 13108 Fix sending HTML/Multipart mails
MAP Enhancements 13560 Add fallback to original value when input not found
miele Enhancements 13071 Fix auto-update for stop channel and synchronize switch channel with appliance state
13147 Allow hostname as gateway network address
13393 Migrate start channel to full DateTime channel and add end channel
13841 Migrate time channels from DateTime to Number:Time
Bug Fixes 13930 Fix dimension for powerConsumption channel
mielecloud Bug Fixes 13613 Fix missing web resource unregistration
miio Enhancements 12723 Add support for Xiaomi Vacuum Mop 2S
12803 Add support for Dreame L10 Pro vacuum cleaner (p2029)
13717 add support Xiaomi Smart Air Purifier 4 (modelId: zhimi.airp.mb5)
13806 Add support Xiaomi Smart Air Purifier 4 Compact
Bug Fixes 13111 Fix warning messages and discovery on newer robots
13262 Fix Qingping Air Monitor (cgllc.airmonitor.s1) support
13554 Correct channel ambientBrightness to type Dimmer for Yeelight Screen Light Bar
13715 Improve cloud login issues
13724 Fix dimming channels for several yeelights
mqtt Enhancements 13303 Add missing broker connection configuration parameters
13575 Support mired<->Kelvin unit conversion
13604 Set the proper unit in the state description
Bug Fixes 13621 Avoid parallel streams with common thread pool to avoid deadlocks
mqtt.espmilight Enhancements 13578 Automatically convert color values to color temp
mqtt.generic Bug Fixes 13426 Fix range of RGB values
mqtt.homeassistant Enhancements 13397 Support availability_templates
13401 Stable jsondb discovery result
13402 More readable label for discovered things
13413 Support non-RGB lights
Bug Fixes 13398 Sensors with a state_class are numeric
13466 Ensure availability topics get subscribed
13518 Fix binding crash when home assistant discovery topics update with content
mybmw Enhancements 13093 Add home-distance channel
myq Bug Fixes 13189 Catch json parsing errors when getting login token.
myStrom Enhancements 13201 Add motion sensor and API token
Nanoleaf Enhancements 13552 Add channel for visualizing layout
13746 Add new channel: State
13865 Add LONG_PRESSED tap detection
13881 Support lines in visualization
13893 More color for less network calls
neohub Enhancements 12915 Add support for WebSocket connection to hub
netatmo Enhancements 13489 Buffer last event requests per child modules
13494 Add a request counter
13503 Add Door/Window sensor
13555 Add console command to show all devices/modules ids
13587 Console command completion
Bug Fixes 13257 Support one decimal for pressure values
13467 Room-Thing offline after restart
13487 Handle camera ping timeouts
13500 Handle properly UNKNOWN module types in discovery
13620 No restriction on max value for rain quantity
13636 Fix potential loss of events when more than 1 home
13854 Improve bridge status messages in case of service outage
network Bug Fixes 13519 Fix wake-on-lan functions in DSL rules
networkupstools Enhancements 13729 Add missing status
nibeheatpump Enhancements 13125 Add new channels for F1x45 heat pumps
13190 Add PRODINo ESP32 Ethernet v1 board support
Bug Fixes 13752 Support 16-bit addressing
nuki Enhancements 13331 Disabled warning for things created from textual config
Bug Fixes 13470 Fix nukiId migration for devices with shorter nukiId
nuvo Enhancements 12042 Add NuvoNet source communication capabilities
13498 Add Image channel for album art
13658 Add zone actions for rules
Bug Fixes 13345 Fix MPS4 flag and online status reporting
13535 Ignore NuvoNet events for sources not managed by openHAB
onkyo Enhancements 13006 Add support for TX-NR807
13082 Add support for HT-RC440
openhabcloud Enhancements 12430 Improve logging for troubleshooting purposes
13559 Remove content encoding when proxing.
Bug Fixes 13421 Fix sleepSocketIO(long delay) halts entire io.socket thread
openuv Enhancements 13130 Add scheduled reconnection on timeout
openweathermap Enhancements 13414 onecall api version - property for setting API version to use.
openwebnet Enhancements 13473 Add support for basic Scenarios (WHO=0)
13694 Add support for Alarm (WHO=5)
Bug Fixes 13803 Thermo: zone/CU address set correctly during discovery
paradoxalarm Bug Fixes 13629 Fix issue that the config of paradox bridge handler gets overwritten when there are more than one bridge
13641 Handle multiple panels
pidcontroller Enhancements 13003 Implement previous state recovery on startup
plugwiseha Enhancements 13833 Add channel return temp
Bug Fixes 13832 Fix set the scene for a zone
powermax Enhancements 13588 Console command completion
pulseaudio Bug Fixes 13338 Apply real disconnection when needed
pwm Enhancements 13755 Fix NPE when disabling and improve logging
Bug Fixes 12197 Fix handling of "maxDutyCycle" parameter value
radiothermostat Bug Fixes 13394 Ignore updates if thermostat data is invalid
regoheatpump Bug Fixes 13685 Fix polling stops problem if there is an unhandled runtime exception
remoteopenhab Enhancements 13008 Avoid unexpected log for ALIVE SSE message
13432 Optimize filtering of ALIVE events
Bug Fixes 13349 Fix the pattern to parse DateTime
13350 Handle REFRESH command as any command
resol Bug Fixes 13753 Fix handling of WeekTime fields on vbus
rotel Enhancements 13060 Add support for models M8 and S5 (Michi)
13136 Add support of multiple zones (models C8 and C8+)
13165 Add new channels to control random mode and repeat mode (CD players)
13183 New channel for other commands provided by the API
13197 Add missed command to switch between ProLogic modes
13203 Add new command to toggle between stereo and bypass
13223 Add other commands for RSP-1576, RSP-1582, RAP-1580, RDD-1580, RA-1592, RC-1590
13240 Set model and firmware properties
13285 Add new channel to select FM/DAB/iRadio preset
Bug Fixes 13133 Fix handling of balance command feedback
13148 Fix request of play status and track number
rrd4j Bug Fixes 13332 Use RrdDbPool to prevent ClosedByInterruptException
13955 Error handling for broken rrd4j files
serial Bug Fixes 13265 Allow custom baudrate and add option 2400
shelly Enhancements 13066 Auto-numbering for channel labels & bugfixes
13227 Improve TRV profile support (selectable list)
13439  Add Plus/Pro support, some bugfixes
13520 Plus 1/1PM Add-On support; fix roller pos on open/close state
siemensrds Bug Fixes 13888 Binding no longer fails if thermostat does not use optional features
somfytahoma Enhancements 13411 Add support for the control over the LAN (local mode)
13598 Console command completion
sonos Enhancements 13235 Add support for RadioApp music service
13551 New codec id 61 for Dolby Atmos
Bug Fixes 13241 Ignore TRANSITIONING device state when updating channels
SunSpec Enhancements 13480 Add missing Inverter Status, Add Channel for Vendor-Specific Status
systeminfo Enhancements 13292 Add CPU load channel, update dependencies
13562 Add dynamic channels
13804 QuantityTypes and state descriptions cleanup
tado Enhancements 13301 Channels are visible depending on device type and capabilities
Bug Fixes 13272 Fix AC target temperature reading and writing bugs
tapocontrol Enhancements 13225 Add support for P115 smart-socket
13814 Add support for L610, L630 and L930
Bug Fixes 13468 Fix API Rate limit exceeded error
13677 Fix configuration error
Telegram Bug Fixes 13758 Can't send message with underscore character
tellstick Bug Fixes 13479 Avoid updates duplication after communication errors
Tesla Enhancements 13116 Add event stream & handling post new authentication process
13337 Add options to control polling frequency and sleep
13704 Add steering wheel heater command support for Model 3/Y
tibber Enhancements 13416 Add channel for tomorrows prices and timestamps as JSON array
Bug Fixes 13537 Fix Websocket reconnect after server failure
13680 Updates for breaking API changes
touchwand Enhancements 13440 Add port configuration to websocket
Bug Fixes 13427 Fix thermostat target temperature command
tplinksmarthome Enhancements 13818 Add support for TP-Link KP401 Smart WiFi Outdoor Plug
TR064 Bug Fixes 13894 Fix pattern excluding some valid ip-addresses
unifi Enhancements 13827 Migrate uptime channels to Number:Time
Bug Fixes 13362 Fix portoverride to not remove any other data
13455 Detect all PoE ports, and set PoE thing offline if no data could be found
13539 Fix PoE port mode for 24V
velux Enhancements 12618 Add support for vane/slat position
13199 Add an action to simultaneously set main and vane positions
13212 Implement new API, and log critical device errors
13271 Vane position channel is visible when required
13406 Bridge status shows offline when communication fails
venstarthermostat Bug Fixes 13046 Split away and schedule settings calls (resolves bug exiting away mode)
verisure Bug Fixes 13652 Avoid updates duplication after communication errors
vitotronic Enhancements 13739 Add channel "currentmode" to thing "circuit"
13898 Fix few thing/channel labels/descriptions
vosk Enhancements 13391 Upgrade sdk and handle UnsatisfiedLinkError exceptions
voskstt Bug Fixes 13536 Fix sdk update and disable internal info logs
13556 Fix load on linux arm
wemo Enhancements 13319 Add Wemo Outdoor plug
wled Bug Fixes 13543 Fix presets and playlists won't load the correct position.
wundergroundupdatereceiver Bug Fixes 13327 Regenerate trigger channel with proper type and more metadata and normalize channel names
Zigbee Enhancements 767 Add ZigBee firmware provider backed by GitHub repository

If you are working with an openHABian setup, switching to openHAB 3.4.0 stable depends on what version you’re upgrading from:

  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 needed check which version you run via menu option 00.
  4. a) If you have been running a snapshot or milestone release of 3.4, select the first of the three entries menu entry 41 (“Release”). b) If you have been running a 3.x release version, select menu entry 02 “Upgrade System”. c) If you are still on openHAB 2.x, please pay extra attention to all release notes from your version up to these. You also need to upgrade openHABian: select 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.4.0 and its optional add-ons with:

sudo apt-get install openhab=3.4.0-1

## optional add-ons for offline installation ##
sudo apt-get install openhab-addons=3.4.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.4.0 and its optional add-ons with:

sudo yum install openhab-3.4.0-1

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

Official update scripts are available that let you update your 3.x installation to version 3.4:

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.4.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.4.0

Core Runtime

Default units have been added for all dimensions. A state description defining the unit should be added to each item that uses a different unit.

Automower Binding

Due to Husqvarna Authentication API change, bridge now requires application secret instead of username and password. Delete any existing bridge and re-add it, please make sure to update all automower things to use the newly added bridge.

JavaScript Scripting Automation

  • 'setTimeout' and 'setInterval' return a timerId (a positive integer value) as in standard JS instead of an openHAB Timer.
  • ItemHistory min/max between/since returns now a number instead of a string.
  • openHAB JavaScript library versions < 3.1.2 are not fully compatible anymore. If you have manually installed the JS library, please upgrade to a version >= 3.1.2.

JRuby Scripting Automation

The default RUBYLIB directory has changed to OPENHAB_CONF/automation/ruby/lib. Either explicitly configure the add-on to use the previous value, or move any files to the new location.

Konnected Binding

Things needs to be recreated because of added Konnected Pro panel support and manual configuration of things.

LG webOS Binding

The undocumented action "sendRCButton" was removed while it is possible to achieve the same action with "sendButton"; in case you were using "sendButton" with ENTER or DELETE as parameter, you should now use the new action "sendKeyboard".

Miele@home Binding

  • The channel 'start' now contains date and time for start of scheduled program. Previously it was counting down duration until the program would start.
  • The channels 'duration', 'elapsed' and 'finish' are now Number:Time. You may need to remove and create your things again in case your things were previously created using UI and you want to use these channels. Linked items need to be recreated.

Resol Binding

Item Type of solar controllers channels using time and weekday format changed from Date to String. Items need to be adjusted accordingly.

Systeminfo Binding

  • Multiple Number channels now have a dimension added. You may need to remove and create your things again in case your things were previously created using UI and you want to use these channels. Linked items need to be recreated.
  • The default state description for DataAmount channels is now MiB. If you relied on MB, you may need to adjust.

Velux Binding

On window things the semantic category of the position channel has been corrected from 'blinds' to 'window'. Window things with such channels that had been created via the UI will need to be deleted and re-created.

Xiaomi Wifi devices (Mi IO) Binding

Channel Type change for some yeelights. The brightness channels with the Number type now have the Dimmer type. This affects only nightlight and ambilight channels for some models.