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.
The easiest way to use the bindings in this repository with openHAB 3.0.x/3.1.x is to install the SmartHome/J repository manager. The documentation can be found here.
For openHAB 3.2.0 and later 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.
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.0.x (releases) | openHAB 3.1.x (releases) | openHAB 3.2.0 (release) | openHAB 3.3.0 (snapshots) | |
|---|---|---|---|---|
| SmartHome/J 3.1.x (snapshots, releases) | yes | no | no | no |
| SmartHome/J 3.2.x (snapshots, releases) | no | yes | yes | yes |
| compatible RepoManager | latest 3.1.x | latest 3.2.x | JSON AddonService | JSON AddonService |
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.