Skip to content

openHAB 4.3 Release Notes

Kai Kreuzer edited this page Dec 15, 2024 · 2 revisions

This is the official release of openHAB 4.3.0.

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

New and Noteworthy

The openHAB 4.3 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 4.3 is backward compatible to openHAB 4.x 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:

Add-on Type Issue
Broadlink Binding #16273
Electrolux Appliance Binding #17663
ENTSO-E Binding #17416
FENECON Binding #17174
Flume Binding #17152
fpp Binding #16298
hueSync Binding #16516
Hunter Douglas (Luxaflex) PowerView for Bluetooth Binding #17099
kermi Binding #16329
LinkTap Binding #17235
Met Office DataHub Binding #15367
myUplink Binding #17451
Pi-hole Binding #16627
Solarman Logger Binding #16835
SunSynk Binding #16753
Teslascope Binding #16956
VisualCrossing Binding #17239
WiZ Binding #17681

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

Type Issue Change
Enhancements 4271 Support offset in DateTimeTrigger
4272 RulesDSL: add DateTimeTrigger offset
4289 Add support for pre-compilation of conditions and actions
4311 Add a warning log to mention the field when configuration parsing is …
4314 Add default scope to profile when loading items file
4324 Add a PersistenceService bundle tracker
4327 Use a precompiled pattern in ChannelUID.validateSegment
4330 Support lists for metadata properties in items files
4336 Icon servlet: Set Cache-Control header to enable icon caching
4337 Upgrade to JmDNS 3.5.12
4343 Upgrade Jollyday to 0.30.0
4344 Add MEDIAN group function
4345 median action in persistence extensions
4347 Remove sendFrequency parameter for Slider/Colorpicker widgets
4352 Support channel transformations with parentheses
4353 Support channel transformation chaining with a list
4355 Add isTransform(), isEmpty() and isPresent() to ChannelTransformation
4357 Filter out blank lines and comments in a multi-line transformations
4364 Make DateTimeType Comparable
4365 Add time series support for script profile
4367 New methods kelvinToXY and xyToKelvin
4370 Support space-separated date/time format for DateTimeType
4375 Extend NetUtils for network range scanning
4376 Add caching for transformation resource
4377 Buttongrid with Button components available for main UI configuration
4378 Add offset and timeOnly config in TimerEvent payload
4382 Add toString overrides to ThingImpl & BridgeImpl
4384 Extend HistoricItem to work with Instant instead of ZonedDateTime
4386 Add XOR ArithmeticGroupFunction
4389 Add a new optional input parameter to discovery services
4392 Enhance ThingActions UI support
4394 Persistence: Optionally add current Item state to response
4398 Upgrade Xtext/Xtend to 2.36.0
4401 Add ColorUtil.xyToDuv
4402 Add support for synchronized execution of compiled scripts
4403 Upgrade Jollyday to 0.32.0
4410 Expose ColorUtil methods to DSL rules
4417 Parse BigInteger directly in DecimalType
4420 Add new element Colortemperaturepicker
4424 ActionInputsHelper: Allow any number of decimals & Apply primitive input default values
4428 ConfigDescriptionParameter: Change default format for datetime & Update context docs
4429 kelvinToXY: Extend Colour Temperature range 1000 K .. 10000 K
4430 Thing actions: Support @ActionOutput for single return values
4433 Add MK⁻¹ unit alias
4435 Add support for more types as output of thing actions
4436 ActionInputsHelper: Enable seconds for time & datetime
4440 ActionInputsHelper: Enhance ZonedDateTime & Instant support
4451 Add unit hint to color-temperature-abs system channel type
4467 Add some requested new units : J/m², gr/ft³,gr
4468 Persistence exclude items and groups
4471 Upgrade Jollyday to 0.35.1
4477 IP addon finder: add support for sending local mac address
1674 Add a persistence service bundle tracker
Bug Fixes 4303 PersistenceExtensions: fix DateTimeException when persisting an empty TimeSeries
4305 Config parameter: Change inferred i18n key for add-ons + alternative key
4306 Fix translation of label for system:addons service
4309 Fix merge of AddonInfo (masterAddonInfo field)
4312 Fix dynamic binding of AddonService to ConsoleCommandExtension service
4313 Fix Timer.isRunning() returning true immediately after rescheduling
4317 Add unitHint to AbstractStorageBasedTypeProvider.ChannelTypeEntity
4320 Add missing system profile types and UIDs
4323 Fix startup of background discovery
4326 Clean up removed links in GenericItemChannelLinkProvider
4335 Fix favicon for authorize/login page
4360 Add missing ScriptProfile parameter options
4361 Rename parameter of ChannelHandler
4400 Allow negative filter boundaries
4415 Improve marketplace remote handling
4421 ActionOutput: Document QR code rendering & Fix action REST doc
4426 Fully synchronize script action/condition execution if supported by engine
4437 ScriptProfile: Recover from closed context for JS Scripting
4449 Sitemap editor: Fix color and icon rules
4495 Thing action REST API: allow extended scope like bindingid-xxx
UI Type Issue Change
Basic UI Enhancements 2388 Align and optimize available space for switch with mappings
2661 Add a translatable title to the settings page
2697 Make button text not uppercased
2698 Revert uppercasing exponent
2703 Add build date to resource requests
2851 Implement new sitemap element Colortemperaturepicker
2873 Add preview color to Colorpicker widget
2895 Replace OK by CLOSE in the 2 color pop-ups
Bug Fixes 2660 Fix description for iconify parameter
2685 input widget, support html escape characters in input
2700 Fix frame title's left padding in condensed tablet layout
2746 Fix character encoding of returned page
2764 Hide header row for MJPEG video when visibility is disabled
2871 Fix selection of color temperature near min and max
2894 Fix unit determination for min/max from item state description
Main UI Enhancements 2216 Addons store: Use swiper for addon cards on mobile & Reduce size of addon card on desktop
2584 Allow model cards and model tabs outside of homepage
2607 HTTP block enhancements
2647 Make tabbed pages routable
2648 oh-sipclient: Add Item to report SIP status to server
2658 item-mixin: Improve Item name validation RegEx
2672 Add new sophisticated notification blocks
2687 Add a dirty indicator on the title bar
2691 Update HomeKit metadata definitions
2693 Clean-up unused login/logout code in app.vue
2694 SSE state tracking: Reduce logging
2705 Sitemap editor: Remove sendFrequency parameter
2711 Widget actions: Add a HTTP action to perform HTTP requests
2714 Main UI: Improve Content-Security-Policy
2715 Widget actions: Support optional confirmation dialog/sheet
2720 Sitemap editor: Validation improvements
2721 HomeKit metadata: Mark Thermostat.CurrentHeatingCoolingMode as optional
2731 Developer sidebar: Focus on search when opened
2732 Add persistence median methods
2734 Items: Add MEDIAN group function
2740 Make HTTP block method name dropdown labels less technical
2742 Small improvements to blocks
2743 Remove Nashorn support & Check for required automation add-on in script edit
2752 State description metadata: Allow to select transformations from list
2754 Rules/Scenes/Scripts: Gray out run now button if uninitialized
2755 Sitemap editor: Add Buttongrid Button support
2759 Transformation edit: Improve dirty handling & Fix settings styling
2760 Script editor: Extend mode translation for more automation languages
2761 Script & Transformation editor: Add links to the language reference docs
2771 Thing add page: Add support for optional scan input
2774 Z-Wave network map: Fix ECharts deprecation warnings
2779 System & Add-on settings: Add dirty indicator & Improve dirty handling
2781 Refactor card widgets to use a shared base component (oh-card)
2787 Canvas layout: Add interactive SVG support
2792 Item details: Show group function for group Items if defined
2796 Add version and commit to UI during production build
2800 Home page: Add options to set simple navbar/standard background the default on mobile/desktop
2805 Charts: Enable boundary and itemState persistence query params by default
2818 Thing page: Support invoking Thing actions & Viewing their output
2820 Config parameter: Add unit to param description when entering UoM values
2823 Rules list: Store search query when leaving page/reloading & Improve code
2824 Items list: Add note that states not updated in real-time & Code improvement
2827 Search bars: Remember search query & Automatically focus on desktop
2828 Improve injection of build info into the UI
2832 Number parameter: Allow configuring any step size/number of decimals
2834 Thing actions: Sort by label, Show description, Hide unsupported actions
2838 Config parameter: Implement date and datetime contexts
2839 Thing actions: Hide if no actions available & Merge with UI actions
2840 Thing action popup: Multiple improvements
2848 Config param time & datetime: Add support for seconds
2850 Thing action popup: Improve rendering of output value
2854 Rule/Scene/Script edit: Block addition of reserved tags
2855 Implement copy functionality for Things, Items, scenes & scripts
2859 Add-ons store: Improve card sizing on desktop
2867 Thing actions: Respect action visibility
2872 Interactive SVG background: Allow processing whole SVG group for state
2878 oh-chart: Only include boundary & Item state if now between start/end time
2880 Sitemap editor: Add support for color temperature picker
2881 Canvas Interactive SVG: Prevent image caching & Add id in config dialog
2884 Add Log Viewer to MainUI
2888 Config sheet: Always show advanced params only if changed from default
2896 Persistence edit: Support excluding items or groups
2911 Update openhab-js tern defs
2912 Update unit definitions
Bug Fixes 2655 Fix code editor overflow in sitemap editor
2656 Page editors: Encapsulate CSS to avoid polluting global CSS
2657 Fix sidebar openHAB logo href to avoid repeated navigation to home page
2662 oh-context: Fix rendering failure when not in edit mode
2663 Canvas layout page: Hide empty background image element to remove white border
2673 Overview page: Fix defineVars is not working
2677 Charts: Fix issues with charts not displaying on iOS >= 17.4
2678 Fix 404s for overview page, semantic model tabs and add-on store
2682 Fix bracketing in context block
2688 Fix code generation for Thing object on Thing status block
2689 Link add: Fix create item fails for trigger channels
2690 Link add: Support linking Number channel to Switch Item with profile
2695 Page designers: Fix dirty handling for code tab
2706 Charts: Force re-render on device orientation change
2729 Fixes logic to detect when a thing's config changes vs the whole thing structure
2751 Home edit: Fix model tab settings not editable
2753 Developer sidebar: Show error when trying to run unititialized rule
2772 Persistence edit: Fix wrong config parameter type definitions
2773 Config sheet: Properly handle null as configuration value
2775 Thing details: Fix config action saves the whole Thing
2777 oh-rollershutter: Use displayState if available & Improve styling
2778 Item metadata: Improve dirty handling & Fix description metadata always dirty
2780 oh-canvas-layout: Allow overriding style
2801 Fix safe area styling issues with card and card contents
2802 Settings pages: Fix double scrollbars by hiding y-overflow in block-narrow
2806 oh-input: Fix style issue on mobile when sendButton enabled & Update docs
2807 oh-cell: Fix headerBadgeColor
2825 Refactor shared model code into a mixin
2837 Fix flickering of list pages when updating
2846 Add bottom padding below advanced checkbox in config sheet
2853 oh-cell: Fix safe-area issues
2856 Pages list: Don't allow selecting overview page for removal
2860 oh-colorpicker: Fix color picker sends commands on external state change
2861 Model (picker): Fix toolbar checkbox issues with safe areas
2864 oh-canvas: Fix exception on empty initial svg config
2865 Thing action popup: Fix invocation of actions with signature hash
2866 Fix hsbToRgb util & Fix conversion in oh-canvas-embedded-svg-mixin.js
2869 oh-image-card: Fix too much padding when no action configured
2874 oh-label-card: Hide label if no label or Item configured
2886 Widget action taphold: Hide context menu in desktop browser
2891 Channel copy: Fix changed config discarded
2892 Thing: Fix dirty warning shown on deletion if unsaved changes
2905 Log viewer: only render lines around visible area
2908 Log viewer: Fix styling issues on mobile devices
2910 Fix safe-area issues
2913 Unit metadata edit: Add missing padding
cometvisu Bug Fixes 2671 Security fixes & cleanup for cometvisu backend
2696 Add more path checks and secure against XXE attacks
2719 fix path check regressions
Add-on Type Issue Change
AirGradient Bug Fixes 17332 Convert from AbstractDiscoveryService to AbstractThingHandlerDiscoveryService
airq Bug Fixes 17202 Fix occasional stalling of sensor value updates and refactoring
amazonechocontrol Enhancements 17754 Improve color temperature channel
androidTV Bug Fixes 17373 fix version parsing for newer Philips TV models
atlona Enhancements 17050 Suppress unnecessary INFO and WARN logging
17462 Set autoUpdatePolicy for WriteOnly channels
automower Bug Fixes 17539 Fix mower command channels
avmfritz Enhancements 17776 Provide unit hint for color temperature channel
Bug Fixes 17685 Fix incorrect state of dimmable bulb
aWattar Enhancements 16877 Add inverted best price
17068 Schedule API update more than once per day
17169 Add aWATTar API class
17172 Add TimeSeries support
17729 move calculation logic into best price classes
Bug Fixes 17032 Fix price handler refresh
17067 Fix countdown and remaining channels
17731 Fix last hour not being considered for best price
basicprofiles Enhancements 17323 Add additional comparisons to State Filter profile
17362 Add support for functions (DELTA, MEDIAN, AVG, STDDEV, MIN, MAX) in State Filter
17843 Add $DELTA_PERCENT function to State Filter profile
benqprojector Enhancements 17463 Set autoUpdatePolicy for directcmd channel
bluetooth.bluez Enhancements 17123 Bump bluez-dbus-osgi to version 0.2.0
Bug Fixes 17107 Handle UnsatisfiedLinkError on Windows (and macOS)
boschshc Enhancements 17026 Add support for Smart Relay
Bug Fixes 17190 Fix NullPointerException during deserialization, make long polling more robust
17289 Fix NPE during deserialization, make long polling more robust (#17190)
ChatGPT Enhancements 17320 Enhance binding
daikin Enhancements 17087 Add demand control support for ac_unit
17149 Update channels immediately after a successful API command
dbquery Bug Fixes 17159 Fix dependency issues and bump to newer version libs
17784 Fix Thing Action support for DSL rules
deconz Enhancements 17777 Improve color temperature channel
denonmarantz Bug Fixes 17057 Fix blocking initialization
17185 Fix clearing Now Playing channels
dscalarm Enhancements 17051 Add details in bridge handler error log to help find the problem
17407 Remove org.apache.commons.net.util.SubnetUtils
dsmr Bug Fixes 17854 Fix IllegalStateException in rfc2217 connector
ecovacs Bug Fixes 17333 Fix expired token handling for XML-over-MQTT models
electroluxair Enhancements 17324 Remove deprecated binding
emotiva Enhancements 17596 Improve logging, retry job, static typing and type inference.
Bug Fixes 17365 Fix missing data in source channels
17567 Fix main zone volume-db channel name
energidataservice Enhancements 17456 Introduce subscription-based providers
17690 Define grid tariff filters in YAML
enocean Enhancements 17531 D2-50 EEP remove extra channels and fix warnings
Bug Fixes 16975 Fix temperature values for D2_50 eep
17429 Move CHANNEL_DIMMER from D2_01_08 to D2_01_09
17522 Improve capability listing to align with EEP documentation
epsonprojector Enhancements 17464 Set autoUpdatePolicy for keycode channel
evcc Bug Fixes 17294 Fix unit hints missing for percentage channels
17380 Fix IllegalArgumentException for specific vehicle Id's
17528 Fix API change on duration channels
17640 Fix charge plan time channel not using correct timezone
17672 Fix synchronization of charge plan into openHAB
exec Enhancements 17292 Support transformation chaining and refactor using ChannelTransformation
fmiweather Enhancements 17543 Add time series support for forecasts
17555 Add support for edited Scandinavia forecast
Bug Fixes 17669 Fix discovery exception
freeboxos Enhancements 17198 Use rpm as unit for fan sensors
17199 Reduce log level for discovery warnings to debug
17201 Enhance log warning when handling channel command fails
17218 Enhance state display pattern for uptime
17219 Add FTTH and xDSL line status
17224 Remove veto policy on key-code channel
17233 Complete Alarm system handling
17236 Provide better fix for WebSocket registration
17237 Avoid useless API requests (server/player)
17257 Get server AirPlay capabilities
17259 Add unitHint on few channel types
17260 Add channels in group xdsl
17287 Add translatable labels for discovered things
17310 Prevent unnecessary API requests (phone)
Bug Fixes 17081 Fix creation of properties and dynamic channels at init
17082 Fix macAddress property when discovering a server
17086 Change default HTTPS port
17088 Remove macAddress as thing configuration parameter
17095 Avoid partial discovery
17097 Fix systeminfo group for active-player thing type
17124 Fix websocket registration
17161 Fix triggering of event firmware_updated
17178 Fix handling of REFRESH command for connectivity channels
17203 Fix enabling/disabling of Mac OS file sharing
17217 Fix IAE when sending a remote key to player
17223 Fix start/stop audio sink
17226 Fix actions to make them available in DSL rules
17238 Fix thing status handling when rebooting the player
17244 Fix media playing
17254 Avoid a call to the lcd API when not required
17261 Fix category for lcd-brightness channel type
17272 Fix phone and calls configuration
17274 Fix command handling for DECT thing type
17309 Change default timeout to 10s
17877 Add missing thing actions for active player
fronius Enhancements 17170 Add battery control Thing actions
gardena Bug Fixes 17524 Adjust log level
gce Bug Fixes 17430 Fix NullPointerException
goecharger Enhancements 17532 Add awattarMaxPrice channel
govee Enhancements 17778 Provide unit hint for color temperature channel
Bug Fixes 17048 Fix invalid status response handling
gpstracker Bug Fixes 17805 Fix handling ambigious region names
gree Enhancements 16950 Add support for ASC/GCM encryption
Bug Fixes 17398 Use GCM encryption when bind fails
groovyscripting Enhancements 17125 Update Groovy to 4.0.22
17428 Update Groovy to 4.0.23
Bug Fixes 17383 Fix default preset scope not applied
growatt Enhancements 17573 Improve logging
17781 Support battery state of charge alternate property name
17795 Enhance support for SPF inverters
17810 Enhancements for MID inverter and Smart Meter
homekit Enhancements 17031 Implement all AccessoryInformationService characteristics
17056 Allow configuring thermostat modes via metadata
17084 Use characteristic factory for TemperatureSensor
17129 Implement StatelessProgrammableSwitch
17134 Automatically assume valid enum values when linking to Switch/Contact
17137 Make GarageDoorOpener.ObstructionStatus optional
17138 Support UP/DOWN for WindowCoverings
17141 Support lock optional characteristics on GarageDoorOpener
17142 Don't pre-fill enums from switches if metadata has enum values
17144 Support multiple values per enum mapping
17150 Allow linking GarageDoorOpener directly to a Rollershutter
17157 Adjust default ranges for some characteristics
17191 Make Thermostat.CurrentHeatingCoolingMode optional
Bug Fixes 17059 Fix temperature unit conversion for min/max/step
17060 Synthesize Thermostat.TargetTemperature in some cases
17139 Fix linking a Lighting to a Group:Dimmer
17151 Fix duplicate name characteristic errors
homematic Bug Fixes 17206 Fix: Spaces in URLs are not allowed
17390 Fix NullPointerException in discovery
HomeWizard Enhancements 13495 Add support for Energy Socket and Watermeter products
16995 Add current, voltage and failure channels
http Enhancements 17110 Improve escaping of URLs
17288 Support chaining transformations without an intersection symbol
Bug Fixes 17042 Properly escape + character in query string
hue Enhancements 16980 Add support for enabling automations (API v2)
17302 Support dynamic add/delete of scenes (API v2)
17411 Use auto update policy 'veto' on more channels (API v2)
17637 Lamp handler exposes min/max Colour Temperature in state description
Bug Fixes 17440 Room / Zone Things no longer re-appear in Inbox
17878 Fix Friends of Hue sensors being shown as offline
hueemulation Bug Fixes 17772 Change uniqueid to make the earlier octets more unique to fix Alexa
hydrawise Bug Fixes 17345 Various Fixes
icalendar Enhancements 16105 Add configuration for the behavior of the time-based event filter
17455 Add useragent parameter
insteon Enhancements 17146 Rewrite with backward compatibility
17537 Refactor msg definition/factory and product data classes
17540 Update remote device support
ipcamera Enhancements 13313 Add new channels for Dahua API-based doorphones
17388 Add missing motion detection topic for VivoTek FD9388-HTV cameras
17419 Add motion and alarm support for Axis branded cameras
17488 Add autoTracking channel for reolink camera
17518 Improve onvif events with an auto restart feature
17591 Add support to change MJPEG source to a different RTSP sub stream to lower CPU usage
17639 Update openhab controls by asking camera for states.
17732 ONVIF events are processed faster, and adds a choice of what event method will be used.
Bug Fixes 17544 Fix SceneChange alarm not working for newer Dahua cameras
17551 Fix port numbers in a URL stop MJPEG from camera working
17581 Fix Reolink events do not auto restart
17589 Fix Reolink does not detect bad user or passwords.
17629 Fix Reolink will not update a new token after a disconnect.
ipobserver Enhancements 17727 Add channel rainTotal
Bug Fixes 17736 Fix absolute pressure not updating
ism8 Enhancements 17688 Add channel types for heat pumps
17742 Allow linking switch-r to Contact items
17760 Prevent sending for read-only channel types
jdbc Enhancements 17317 Add Oracle DB support
Bug Fixes 17597 Fix case-sensitive table names for PostgreSQL
jpa Bug Fixes 17215 Fix restoring quantity types
jrubyscripting Enhancements 17140 Inject ctx in compiled scripts
17827 Upgrade to JRuby 9.4.9.0
jsscripting Enhancements 16970 Implement javax.script.Compilable
17148 ThreadsafeTimers: Add overrides for double for setTimeout/setInterval
17885 Upgrade openhab-js to 5.8.1
Bug Fixes 17496 Synchronize context access in logger initialization
17510 Fix multi-threading issues in UI-based scripts
kaleidescape Enhancements 17371 Support discovery of Strato V
17387 Improve volume event handling
17423 Add movie end time and music title channels
Bug Fixes 17508 Switch to SDDP discovery for Strato and Alto
knx Enhancements 12434 Allow decoding of KNX Data Secure frames
17721 Improve handling of unknown encrypted frames
Bug Fixes 17830 Upgrade calimero-device to 2.6-rc1
lgwebos Enhancements 17588 Fix representation property
lifx Enhancements 17386 Add support for new LIFX products
linky Bug Fixes 17538 Yet another website underlaying API modification
17774 Thing goes OFFLINE once again
17824 Filter on dates when building the report requested from console
lutron Enhancements 17723 Added device discovery for DivaSmartDimmer and PaddleSwitchPico
Bug Fixes 17204 Fix Pico buttons for non-LEAP bridges
mail Enhancements 17314 Support chaining transformations without an intersection symbol
map Enhancements 17300 Support inline map
17327 Add a way to customize inline-map delimiters
melcloud Bug Fixes 17295 Improve null handling
mercedesme Enhancements 17143 Additional mappings and channels
17748 AdBlue channel for combustion vehicles
17753 Websocket decoupling
Bug Fixes 17001 Take end of charge weekday into account
17267 Fix trip channel type id
17594 Fix websocket endpoint
17750 Add vin automatically to discovered vehicle
meteofrance Enhancements 15462 Replacement of meteoalerte binding
Bug Fixes 17740 Documentation enhancements and more
miio Enhancements 17427 Add Xiaomi Robot Vacuum X10 (dreame.vacuum.r2209)
Bug Fixes 17350 Fix parsing error clear record
Mikrotik Enhancements 17547 Add support for RouterOS 7 devices and support internal radios with capsman disabled
misc Enhancements 16875 Update lastnpe EEA to 2.4.0
17826 Provide unit hints for RSSI channel types
17845 Add UoM support for RSSI channels
Bug Fixes 16989 Fix logging statements
modbus Enhancements 17306 Support chaining transformations without an intersection symbol
17457 Discard data if transformation failed
mqtt Enhancements 16600 Simplify homeassistant thing types, and use AbstractStorageBasedTypeProvider
mqtt.generic Enhancements 17158 Add optional stopCommandTopic for rollershutters
17290 Support chaining transformations without an intersection symbol
Bug Fixes 15929 Send ON/OFF for dimmer channels when so configured
mqtt.homeassistant Enhancements 17359 Update config abbreviations
17378 Use Jinjava directly
17399 Implement template schema lights
17402 Fully implement Fan component
17435 Implement iif and is_defined jinja function and filters
17447 Remove channels for no-longer-configured components
17452 Include details of JSON parse errors
17520 Implement optimistic components with AutoUpdatePolicy.RECOMMEND
17529 Implement non-deprecated color inference for JSON Schema Lights
17598 Use a single channel for all events from a single button
17599 Add support for Event component
17604 Bring channel ids inline with coding standards
17605 Add JSON attributes channel to several components
17607 Bring AlarmControlPanel in line with current documentation
17608 JSON Attributes can exist on BinarySensor
17610 JSON Attributes can exist on Climate
17611 JSON Attributes can exist on Cover
17612 JSON Attributes can exist on Lock
17613 JSON Attributes can exist on Number
17614 JSON Attributes can exist on Scene
17618 Document which channels a component might have
17622 Implement Valve
17624 Implement Text
17659 Add missing climate properties
17813 Fix multi-speed fans
17831 Implement Device Tracker
17852 Implement Tag Scanner
17853 Implement Humidifier
17859 Implement WaterHeater
Bug Fixes 17240 Fix color lights that don't specify color_mode: true
17400 Fix jinja usage in availability templates
17412 Update Jinjava to 2.7.3
17491 Fix newStyleChannels
17584 Avoid improperly delivered triggers
17617 Drop support for legacy schema vacuums
17851 Fix thing consistency for existing things when a device adds or removes components
17858 Update Jinjava to 2.7.4
mqtt.homie Enhancements 17649 Populate unit hint on dynamic channels
mybmw Bug Fixes 17896 Fix hcaptchatoken issue (#17862)
nanoleaf Enhancements 17724 Suppress ipv6 addr in controller discovery
netatmo Enhancements 17662 Consider setpoint duration when manual changing the setpoint temperature
Bug Fixes 17367 Fix doorbell channels flapping
17397 Switching siren channel of the Presence to Read-Only
17448 Prevent IndexOutOfBoundsException
17484 Avoid endless loop when Security claims event history
17553 Ensure expiresAt is usable
17586 Consider timezone of the house when defining the end time of a setpoint
17601 Home properties are not persisted
17661 Webhook events are dispatched but group id is missing
network Enhancements 17687 Modify iOS port knock to use a valid mDNS packet
nibeuplink Enhancements 17453 Remove binding
nikohomecontrol Enhancements 17352 Add console commands
Bug Fixes 17360 Fix basic alarm
nuvo Enhancements 17222 Add image size configurations
17465 Set autoUpdatePolicy for WriteOnly channels
Bug Fixes 17044 Fix display of album art for streaming media
omnikinverter Enhancements 17523 Add refreshInterval parameter
Onkyo Bug Fixes 17770 Fix audio sink for some receiver models
openhabcloud Bug Fixes 17331 Add the missing configuration parameter for NOT_EXTENDED actions
openweathermap Bug Fixes 17189 Fix NullPointerException
oppo Enhancements 17466 Set autoUpdatePolicy for remote_button channel
17783 Add missing input option and enable translations
panasonicbdp Enhancements 17467 Set autoUpdatePolicy for button channel
pentair Enhancements 13485 Many enhancements since original commit, including
persistence Enhancements 17578 Implement HistoricItem.getInstant
pihole Enhancements 17413 Add channels for gravity
pjlinkdevice Enhancements 14430 Remove org.apache.common
plclogo Enhancements 17408 Remove org.apache.commons.net.util.SubnetUtils
plugwiseha Enhancements 17677 Improve connection stability
17737 Add 5 boiler related channels
pushbullet Enhancements 17472 Add link and file push type support
17482 Remove unimplemented channels and thing parameters
pushover Bug Fixes 17348 Fix idle connection causing EOF exception
radiothermostat Enhancements 17743 Add next scheduled set point channels
robonect Enhancements 15061 Add blade status channel
roku Enhancements 17312 Add device communcation logging
17468 Set autoUpdatePolicy for button channel
rollershutterposition Bug Fixes 17251 Fix addon id
17341 Fix parameter configuration through UI
rrd4j Enhancements 17437 Improve the interpolation workaround
17449 Avoid RrdDb.getRrdDef calls
Bug Fixes 17054 Fix unit retrieval for group items
russound Enhancements 17409 Remove org.apache.commons.net.util.SubnetUtils
salus Enhancements 17221 Add running-state channel for it600
samsungtv Enhancements 17368 Add artOrientatation channel
Bug Fixes 17119 Adjust logging when TV is off
17454 Fix NullPointerException
17715 Fix incorrect power state
senechome Enhancements 17304 sync states with latest senec GUI FW 0967
17474 Add writeable Charging Modes
Bug Fixes 17299 Fix ArrayIndexOutOfBoundsException when less than 4 packs
sensibo Bug Fixes 17030 Fix channel provider throwing exception
17091 Fix potential API throttling at binding start
serial Enhancements 17313 Support chaining transformations without an intersection symbol
shelly Enhancements 17166 Add support for various Gen3 devices (Plus 1/1PM, Mini 1/PM/1PM, Dimmer 0110, i4)
17602 Add totalKWH channels for Shelly Pro 3EM
17692 Add support for Shelly Plus RGBW PM
Bug Fixes 17011 Revise fix for Gen1 initialization problem for manually created Things
17015 Fix thing type descriptions for Plus Mini series
17053 Fix initialization of BLU Motion device
17122  Fix BLU Gateway support, IllegalNumberFormatException when favorites are empty in cover mode
17163 Fix thing re-init after power cycle for firmware update
17167 Fix BLU Discovery when Shelly Cloud Bluetooth Gateway is enabled
17180 Fix NullPointerExceptions
17269 Fix NumberFormatException on Shelly2RelayStatus.timerDuration
17689 Fix timeDuration handling in DTOs
17696 Fix suggestion finder
siemensrds Bug Fixes 17697 Fix setting of target temperature
smaenergymeter Bug Fixes 17394 Fix IllegalStateException
smartmeter Bug Fixes 17133 Fix Undelivered IOException
snmp Enhancements 17699 Make use of openHAB network configuration
solarforecast Enhancements 17335 Add manual update feature
Bug Fixes 16996 Avoid past data updates
17506 Add missing @ActionOutput annotation
solarman Enhancements 17379 Sync inverter definition files from upstream.
17563 Add support for LSE-3 (LAN Stick Logger)
solax Enhancements 17055 Support for Solax EV charger via local connection
17549 Changes in values parser for X3-Hybrid-G4
Bug Fixes 17726 Fix the parsing of total consumption channel X3-Hybrid-G4
somfytahoma Enhancements 17583 Add support for the Up/Down Venetian Blind thing
Bug Fixes 17361 Switch Tahoma to OAUTH2 authentication
sonos Enhancements 17318 Ignore Sonos Boost at discovery
17647 Reduce log level
tacmi Enhancements 17556 Reworked unit-mapping between TA and OH; added support for timespans
Bug Fixes 17481 Unit of Measurement fixes, Add missing DateTime support
tado Enhancements 17576 Add channel for remaining time of open window override
tapocontrol Enhancements 17779 Improve color temperature channel
telegram Bug Fixes 17116 Fix log spamming when transient network issue occurs
17505 Add missing @ActionOutput annotation
tesla Enhancements 17582 Add null annotations
tibber Enhancements 17188 Only open websocket if live channels are linked
17344 Improve connection logic
tivo Enhancements 17469 Set autoUpdatePolicy for WriteOnly channels
tplinksmarthome Enhancements 17377 Add new device: EP25
17780 Improve color temperature channel
transform.map Enhancements 17334 Add time series support
transform.vat Enhancements 17642 Add support for VAT rate periodization
unifi Enhancements 17499 Add support for new thing type access point
17519 Provide basic properties for access point
17530 Add some standard channels to access points
17702 Provide LED channel for access point
Bug Fixes 17421 Fix NullPointerException
various Enhancements 17641 Lamp handlers expose min/max Color Temperature in state description
verisure Bug Fixes 17761 Fix broken cloud authentication
veSync Enhancements 15296 131 and Vital Purifiers base support
17842 Add auto-mode to core 300S devices
vizio Enhancements 17470 Set autoUpdatePolicy for button channel
warmup Enhancements 16387 Add fix and multiple enhancements
wifiled Enhancements 15846 Support LED's that demand seperate white and color updates
wled Bug Fixes 16907 Fix brightness inconsistency + power on
17277 Fix: FX and Palettes channel StateDescriptionProvider handling
xmpp Bug Fixes 14397 Improve reconnection logic
yamahareceiver Bug Fixes 17769 Assign proper read timeouts
zigbee Enhancements 855 Map colour temperature states to color HSB states
857 Use buffered steams with the SLZB06
858 Add reporting configuration options to some power measurement channels
859 Check if node is already initialised in discovery before reinitialising
863 Improve error reporting when coordinator not initialised
866 Add console "zigbee things" command
868 Add a color temperature absolute channel
869 Change default to only add devices during a scan
872 Reduce and update logging during network initialisation
Bug Fixes 852 Add timeout to SLZB06 port close thread join to prevent lockup
ZWave Enhancements 1958 Added System notification events used by a device
zway Enhancements 17410 Remove org.apache.commons.net.util.SubnetUtils

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.

If you are working with an openHABian setup,

  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. If on Raspberry, create an image copy of your SD card using menu option 54.
  5. Switching to openHAB 4.3.0 release depends on what version you’re upgrading from:
    a) If you have been running a 4.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 4.3, select the first entry in menu option 41 (“Release”).
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 4.3.0 and its optional add-ons with:

sudo apt-get install openhab=4.3.0-1

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

sudo yum install openhab-4.3.0-1

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

Official update scripts are available that let you update your 4.x installation to version 4.3:

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 4.3.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 4.3.0

Changes in Core

  • The sendFrequency parameter for Slider and Colorpicker sitemap elements has been removed.
  • The DateTimeType methods toZone(zone), toLocaleZone() and getZonedDateTime() have been deprecated. They will be removed in a future version. In DSL rules, please use getZonedDateTime(ZoneId) as replacement for getZonedDateTime(), for example getZonedDateTime(ZoneId.systemDefault()) to use system time-zone.

Changes in Add-ons

ElectroluxAir Binding
  • The binding has been removed since the Electrolux Delta API has been discontinued.
JavaScript Automation
  • The isJsInstanceOfJavaType method of the utils namespace has been removed. Use JavaScript's instanceof operator instead.
MeteoAlerte Binding
  • The underlying API stopped delivering data in May 2023. Binding has been removed and is now replaced by Météo France Binding based on a new API.
MQTT Binding (Home Assistant)
  • Thing types and channel IDs have been significantly restructured and simplified. Delete and re-create your things to opt in to the new style. In a subsequent openHAB release, existing things will also convert to the new style.
  • Legacy schema vacuums are no longer supported.
Pentair Binding
  • EasyTouch thing has been renamed to more generic Controller and all channels have been organized into groups. You will need to reconfigure your setup to the new thing structure.