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:
- Notes about new add-ons
- Notes about the core runtime
- Notes about the UIs
- Notes about the add-ons
- Upgrade Process for openHABian, APT, RPM, Manual Installations
- Breaking Changes that require manual interaction after the upgrade.
Relevant Changes
New Add-ons
The following add-ons are newly introduced:
| 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 |
Runtime
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 |
User Interfaces
| 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-ons
| 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 | |
| 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 |
Upgrade Process
Backup your configuration
If you are on openHABian, sudo openhabian-config menu option 50 will do for you,
else use sudo openhab-cli backup. Get the resulting file from $OPENHAB_USERDATA/backups, $OPENHAB_USERDATA is accessible as a Samba share. Using SSH it is /var/lib/openhab/ on your system.
If you run a Raspberry, get another SD card (an "Endurance" labelled one) and create a mirror copy.
openhabian-config menu option 54 will do for you on the live system, else there's tools such as dd or WinDiskImager.
Should you ever need to revert to your old openHAB system or to redo the upgrade process, simply change SD cards and start over from where you had started.
openHABian
If you are working with an openHABian setup,
- Use SSH to connect to the command line and run
sudo openhabian-config. - When being asked, answer that you want to update openHABian (note that’s not about openHAB itself).
- If needed check which version you run via menu option 00.
- If on Raspberry, create an image copy of your SD card using menu option 54.
- 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”).
Package-based Installations
APT (Debian / Ubuntu and derivatives)
Make sure that openHAB is sourced from the latest location, has the correct GPG signing key and that your system can download .deb packages via HTTPS by following the instructions for a stable installation in the docs.
If the above is correct, simply upgrade by using:
sudo apt-get update
sudo apt-get upgradeAlternatively, 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-1RPM
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 updateAlternatively, 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-1Manual Installations
Official update scripts are available that let you update your 4.x installation to version 4.3:
Linux/macOS
- Change to your openHAB root directory (e.g.
cd /opt/openhab) - Create a backup by calling
sudo ./runtime/bin/backup. - Run the update command:
sudo ./runtime/bin/update 4.3.0
Windows
- Make a backup of your openHAB installation folder.
- Run PowerShell as administrator and change to your openHAB root directory (e.g.
cd C:\openHAB) - Run the update command:
. .\runtime\bin\update.ps1
Update-openHAB -OHVersion 4.3.0
Breaking Changes that Require Manual Interaction after the Upgrade
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 UIs
- Main UI oh-clock-card widget
The background property has been removed. To set the background color, use the following widget code instead:
component: oh-clock-card
config:
style:
background: green
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.