seokwangkim/addons

SmartHome/J addons for openHAB

Smarthome/J Add-ons

This repository contains the add-ons that are implemented on top of openHAB Core APIs. Some parts of this repository are forked from openHAB Addons.

Installation / Usage

For openHAB 3.2.0 - 3.4.0 it is recommended to add https://download.smarthomej.org/addons.json as JSON 3rd Party Addon Service in the settings. Afterwards all addons can be installed from the UI.

If you installed SmartHome/J bindings from Community Marketplace (NOT the "JSON 3rd Party Addon Service" mentioned above!), you need to manually remove the installed addons. Go to your userdata folder (e.g. /var/lib/openhab on Debian systems) and remove the marketplace directory. Attention: This will also uninstall all other bindings installed from the marketplace, make sure you install everything you need afterwards.

Compatibility

Due to a breaking changes in openHAB, older and newer versions of bundles are not compatible in every combination. We'll continue to support 3.0 compatible addons until the release of openHAB 3.2.0 (which is expected end of 2021) and provide the same set of addons for newer versions. Please check the table to see which versions of SmartHome/J are compatible with which openHAB version:

	openHAB 3.2.0 - 3.4.0 (release)	openHAB 4.0.0 (snapshots)
SmartHome/J 3.2.x (snapshots, releases)	yes	no
SmartHome/J 4.0.x (snapshots, releases)	no	yes

Please note that currently no release for openHAB 4.0.0 snapshots is available.

Upgrading SmartHome/J bindings installed from the JSON 3rd Party Add-on service

The newest version (and only that !) is available for installation in the UIs Add-ons section. You'll always install the newest version, but installed addons keep their version.

Unfortunately there is no automatic or half-automatic update process. If you want to upgrade after a new version is released, you have to manually uninstall and re-install the binding. Your configurations (binding-configurations and thing configurations) are safe and will be picked up by the new version. Things will automatically update their type/definition where necessary.

Add-ons will automatically be upgraded to the latest version if you upgrade your openHAB installation.

Attention: Even though we try to reduce breaking changes to an absolute minimum, please always look at the release notes prior to updating.

Development

SmartHome/J add-ons are Java .jar and Apache Karaf .kar files. Regarding development, code-style and alike the same rules and tooling that apply (or are used) within openHAB are also used.

The following differences apply:

• null checks: some warnings have been increased to error level
• null checks: annotations are required

Happy coding! Pull requests always welcome, and we'll try to review as soon as possible. In case you need assistance, feel free to ask.