Homebridge Plugin for OpenHAB2 - Complete Edition (works also with OpenHAB3!)


This homebridge plugin for openHAB fully supports all services offered by Apple's HomeKit Accessory Protocol (HAP), as far as it is feasible based on the item types offered by OpenHAB (see below for the currently supported 32 accessories). In opposite to the existing openHAB homebridge plugin or the native openHAB Homekit Plugin, this plugin requires explicit declaration of accessories in the homebridge configuration and does not use openHAB's tagging system, which leads to a little more effort during configuration, but proves more reliable and functional in more complex installations. See Comparisson below.

Preface

~~Since the native HomeKit integration of OpenHAB has significantly improved (still lacking some of the available Service of this plugin), I don't think there is much value in this plugin.~~

After testing openHAB3's HomeKit integration for a week, I decided to move back to homebridge, due to the instability of openHAB's implementation.

As part of my OpenHAB 3 migration I updated the code to support OH3, finally put some bug fixes that happened over the last year into the release and replaced the depricated request package.

To pull the Github version:
``
npm install -g -f steilerDev/homebridge-openhab2-complete#master
`

Installation

Note: Please install homebridge first.

`
npm install -g homebridge-openhab2-complete
`

Some people are experiencing dependency issues between homebridge's node version and the required node version for this project. My local setup is based on oznu's homebridge docker container, where I never ran into any problems. In order to install the plugin in the docker, just add npm install homebridge-openhab2-complete to the startup.sh script inside the mapped docker volume.

Configuration


This is a platform plugin, that will register all accessories within the Bridge provided by homebridge. The following shows the general homebridge configuration (config.json), see the Supported HAP Services below, in order to get the detailed configuration for each service.

`json
{
"bridge": {
...
},

"accessories": [
...
],

"platforms": [
{
"platform": "openHAB2-Complete",
"host": "http://192.168.0.100",
"port": "8080",
"username": "homebridge",
"password": "homebridge",
"accessories": [
{
"name": "An items name, as shown in Homekit later",
"type": "switch",
"item": "Itemname-within-OpenHAB"
},
...
]
},
...
]
}
`
* platform has to be "openHAB2-Complete"
* host: The IP or hostname of your openHAB instance. The Protocol specifier (http://) is optional, defaults to http:// (independent of the specified port)
port: (optional)* If not specified the default port of the specified host protocol is used
username: (optional)* Username for HTTP(S) basic auth
password: (optional)* Password for HTTP(S) basic auth
* accessory: An array of accessories exposed to HomeKit, see the next chapter for available services and their configurations

Alternatively you can group accessories of the same type in a sub-array:
`json
...
"platforms": [
{
...
"accessories": [
{
"type": "switch",
"items": [
{
"name": "An items name, as shown in Homekit later",
"item": "Itemname-within-OpenHAB"
},
{
"name": "An items name, as shown in Homekit later",
"item": "Itemname-within-OpenHAB"
},
...
]
},
...
]
},
...
`

Supported HAP Services


The following is a list of all services that are currently supported and which values are required within the accessory configuration. Every accessory needs a name (as shown in HomeKit later) and a type. The combination of name and type needs to be unique and should not change in the hombridge configuration (you can safely rename the item within the Home.app after adding them). Changing name or type in the config will change the item's serial number, which would be registered as a new/different one.

* Complex Accessories:
* Lightbulb
* Homebridge configuration type: light
* Fan
* Homebridge configuration type: fan
* Security System
* Homebridge configuration type: security
* Climate Control Accessories:
* Thermostat
* Homebridge configuration type: thermostat
* Humidifier/Dehumidifier
* Homebridge configuration type: humidifier
* Heater/Cooler
* Homebridge configuration type: heatercooler
* Air Purifier
* Homebridge configuration type: airpurifier
* Audio Accessories:
* Speaker
* Homebridge configuration type: speaker
* Microphone
* Homebridge configuration type: microphone
* Watering Accessories:
* Valve, which can be an 'Irrigation System' or 'Faucet'
* Homebridge configuration type: valve
* Position Based Actors:
* Window Covering
* Homebridge configuration type: windowcovering
* Door
* Homebridge configuration type: door
* Window
* Homebridge configuration type: window
* Lock Mechanism
* Homebridge configuration type: lock
* Garage Door Opener
* Homebridge configuration type: garage
* Slat
* Homebridge configuration type: slat
* Numeric Sensors:
* Temperature Sensor
* Homebridge configuration type: temp
* Humidity Sensor
* Homebridge configuration type: humidity
* Light Sensor
* Homebridge configuration type: lux
* Air Quality Sensor
* Homebridge configuration type: air
* Binary Actors:
* Switch
* Homebridge configuration type: switch
* Outlet
* Homebridge configuration type: outlet
* Binary Sensors:
* Motion Sensor
* Homebridge configuration type: motion
* Occupancy Sensor
* Homebridge configuration type: occupancy
* Leak Sensor
* Homebridge configuration type: leak
* Carbon Monoxide Sensor
* Homebridge configuration type: co
* Carbon Dioxide Sensor
* Homebridge configuration type: co2
* Contact Sensor
* Homebridge configuration type: contact
* Smoke Sensor
* Homebridge configuration type: smoke
* Filter Maintenance Sensor
* Homebridge configuration type: filter

The following services are also defined by the HomeKit protocol, but since I don't know a good way to map them to openHAB items, I currently don't plan to implement them. Let me know if you have any ideas, by opening an issue!
* Camera RTP Stream Management
* Doorbell
* Stateless Programmable Switch

Configuration for every accessory

$3

Since iOS 13 multiple accessories can be grouped within a single accessory. This can be -as far as I have tested- done in an arbitrary way. The syntax to define a grouped item is as follows:
`json
{
{
"type": "group",
"name": "Group Name",
"model": "Group Type Model",
"batteryItem": "Itemname-within-OpenHAB",
"batteryItemThreshold": "20",
"items": [
{
"type": "homebridge-openhab2-complete item type",
"name": "An items name, as shown in Homekit later",
"item": "Itemname-within-OpenHAB"
},
{
"type": "homebridge-openhab2-complete item type",
"items": [
{
"name": "An items name, as shown in Homekit later",
"item": "Itemname-within-OpenHAB",
},
{
...
}
]
}
]
}
}
`
* type: Needs to be "group"
* name: The name as shown in HomeKit later (in some instances I have experienced that this name is dropped in favor of the first item's name)
model (optional)*: A model description, defining the grouping. This is only shown in the expanded settings of the group.
batteryItem, batteryItemThreshold, ... (optional)*: A battery service can only be defined on the most upper level for the whole group. See Battery Levels and Warnings for more information on the syntax. All BatteryServices defined in the items array will be ignored!
* items: An array of item definitions. As shown in the example, the different items will be defined here, as if they were outside of the group, either through single item definition or multiple definitions of the same type in a sub-array. Those configuration styles can be combined!

$3

Every accessory can be configured to show battery warnings and battery levels. The following configuration can be optionally added to every item:
`json
{
"batteryItem": "Itemname-within-OpenHAB",
"batteryItemThreshold": "10",
"batteryItemInverted": "false",
"batteryItemChargingState": "Itemname-within-OpenHAB",
"batteryItemChargingStateInverted": "false"
}
`

batteryItem (optional)*: The openHAB item representing the battery level for this accessory.
* Needs to be of type Switch, Contact or Number within openHAB
* Note: If the type is Number, then the battery warning will be based on batteryItemThreshold and the battery level will be the value of the item
* Note: If the type is Switch or Contact the BatteryLevel will always show 0% and for states ON or OPEN a battery warning will be triggered
batteryItemInverted (optional)*: If batteryItem's state needs to be interpreted inverted, set this value to "true" (Only for types Switch and Contact)
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
batteryItemThreshold (optional)*: The threshold of batteryItem's numeric value, below a warning will be triggered
* Default: "20"
* Allowed values: All integers
* batteryItemChargingState: The openHAB item representing if the device is currently charging
* Needs to be of type Switch or Contact within openHAB
* Default: Item will be reported as 'Not chargeable' to HomeKit if this item is not available
batteryItemChargingStateInverted (optional)*: If batteryItemChargingState's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*



Available accessory types

$3

This service describes a lightbulb.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "light",
"item": "Itemname-within-OpenHAB",
"sendOnOnlyWhenOff": "false"
}
`
* item: The openHAB item controlled by this accessory
Needs to be of type Switch, Dimmer or Color within openHAB (HomeKit will correctly display brightness -in case of Dimmer or Color- and color settings -in case of Color-*)
* sendOnOnlyWhenOff: This addresses the different behaviour of lights as discussed in issue #57 and when enabled uses @weakfl 's proposed fix
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*




$3

This service describes a fan.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "fan",
"item": "Itemname-within-OpenHAB"
}
`
* item: The openHAB item controlled by this accessory
Needs to be of type Switch, Number or Dimmer within openHAB (HomeKit will correctly display fan speed control -in case of Number or Dimmer-*)

$3

This service describes a security system.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "security",
"item": "Itemname-within-OpenHAB"
}
`
* item: The openHAB item representing the state of the security system
* Needs to be of type String within openHAB
* Allowed values (Every other value will be ignored and shown as an error)
* StayArm: The home is occupied and the residents are active, shown as Home in the Home.app
* AwayArm: The home is unoccupied, shown as Away in the Home.app
* NightArm: The home is occupied and the residents are sleeping, shown as Night in the Home.app
* Disarmed: The security system is disabled, shown as Off in the Home.app
* AlarmTriggered: The security alarm is triggered

$3

This service describes a thermostat.

Important notes on Thermostat Capabilities
* A thermostat can have the capability to cool, heat or do both
* The modeItem will precede heatingItem or coolingItem (when modeItem is defined, heatingItem and coolingItem will be ignored)
* If modeItem is present while modeItemCharacteristic is present the allowed values for modeItem will be restricted based on modeItemCharacteristic (see below)
* If modeItem is not present, one of the following is required: heatingItem or coolingItem
* Based on those, the capability to heat or cool will be derived
* If both are present, coolingItem will be ignored, therefore the item will only be able to either cool or heat

Important notes on Thermostat Capabilities

`json
{
"name": "An items name, as shown in Homekit later",
"type": "thermostat",
"currentTempItem": "Itemname-within-OpenHAB",
"targetTempItem": "Itemname-within-OpenHAB",
"currentHumidityItem": "Itemname-within-OpenHAB",
"targetHumidityItem": "Itemname-within-OpenHAB",
"heatingItem": "Itemname-within-OpenHAB",
"coolingItem": "Itemname-within-OpenHAB",
"tempUnit": "Celsius",
"heatingThresholdTempItem": "Itemname-within-OpenHAB",
"coolingThresholdTempItem": "Itemname-within-OpenHAB",
"modeItem": "Itemname-within-OpenHAB",
"modeItemCapability": "HeatingCooling",
"minTemp": "-100",
"maxTemp": "200",
"minTempStep": "0.1"
}
`


* currentTempItem: The openHAB item representing the current temperature as measured by the thermostat
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
* targetTempItem: The openHAB item representing the target temperature inside the room
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
currentHumidityItem (optional)*: The openHAB item representing the current humidity as measured by the thermostat
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
targetHumidityItem (optional)*: The openHAB item representing the target humidity inside the room
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)

heatingItem (optional, see Important Notes above)*: The openHAB item showing, if the room is currently being heated
* Needs to be of type Switch within openHAB
coolingItem (optional, see Important Notes above)*: The openHAB item showing, if the room is currently being cooled
* Needs to be of type Switch within openHAB
tempUnit (optional)*: Gives the measurement unit of the thermostat. HomeKit always expects the input to be in degrees celsius, therefore specifying Fahrenheit as a unit, the plugin will convert the values to be shown correctly on the fly.
* Default: Celsius
* Allowed values: Celsius & Fahrenheit
heatingThresholdTempItem (optional)*: The openHAB item describing the heating threshold in Celsius for devices that support simultaneous heating and cooling. The value of this characteristic represents the 'minimum temperature' that mus be reached before heating is turned on.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
coolingThresholdTempItem (optional)*: The openHAB item describing the cooling threshold in Celsius for devices that support simultaneous heating and cooling. The value of this characteristic represents the 'maximum temperature' that mus be reached before cooling is turned on.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
modeItem (optional)*: If your thermostat can be set to heating, cooling or auto mode through an item, and/or reports back its current configuration use this item, otherwise the heating/cooling capabilities are deferred from heatingItem and coolingItem.
* Needs to be of type Number within openHAB
* Only discrete values are recognized:
* 0 ≙ Off
* 1 ≙ Heating
* 2 ≙ Cooling
* 3 ≙ Auto
modeItemCapability (optional)*: If you are using modeItem the discrete values accepted and shown in the app can be restricted:
* Allowed values: Heating (will restrict modeItem to 0, 1, 3), Cooling (will restrict modeItem to 0, 2, 3) or HeatingCooling (will not restrict modeItem)
* Default HeatingCooling
minTemp (optional)*: If you need to change the minimum allowed temperature, the currentTempItem is reading
* Needs to be an float
* Default: -100
maxTemp (optional)*: If you need to change the maximum allowed temperature, the currentTempItem is reading
* Needs to be a float
* Default: 200
minTempStep (optional)*: If you need to change the granularity of the currentTempItem reading/writing (Note: Home.app seem to not allow a greater granularity than 0.5 in the UI, however the reported values might be more granular)
* Needs to be a float
* Default: 0.1

$3

This service describes a humidifier and/or dehumidifier accessory.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "humidifier",
"currentHumidityItem": "Itemname-within-OpenHAB",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"humidifierItem": "Itemname-within-OpenHAB",
"dehumidifierItem": "Itemname-within-OpenHAB",
"modeItem": "Itemname-within-OpenHAB",
"humidifierThresholdItem": "Itemname-within-OpenHAB",
"dehumidifierThresholdItem": "Itemname-within-OpenHAB",
"waterLevelItem": "Itemname-within-OpenHAB",
"swingItem": "Itemname-within-OpenHAB",
"swingItemInverted": "false",
"rotationSpeedItem": "Itemname-within-OpenHAB",
"minFanSpeed": "0",
"maxFanSpeed": "100",
"minFanStep": "1"
}
`

* currentHumidityItem: The openHAB item representing the current humidity
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
* item: The openHAB item showing, if the (de-)humidfier is currently active
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If activeItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
humidifierItem (optional, if dehumidifierItem is present, otherwise required)*: The openHAB item showing, if the room is currently humidified
* Needs to be of type Switch or Contact within openHAB
dehumidifierItem (optional, if humidifierItem is present, otherwise required)*: The openHAB item showing, if the room is currently dehumidified
* Needs to be of type Switch or Contact within openHAB
modeItem: (optional)* If your (de-)humidifier can be set to humidifying, dehumidifying or auto mode through an item, and/or reports back its current configuration use this item, otherwise the humidifying/dehumidifying capabilities are deferred from humidifierItem and dehumidifierItem and will not be changeable.
* Needs to be of type Number within openHAB
* Only discrete values are recognized:
* 0 ≙ Humidifier or Dehumidifier
* 1 ≙ Humidifier
* 2 ≙ Dehumidifier
humidifierThresholdItem: (optional)* The openHAB item describing the humidifying threshold. The value of this characteristic represents the 'minimum relative humidity' that mus be reached before humidifying is turned on.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
dehumidifierThresholdItem: (optional)* The openHAB item describing the dehumidifying threshold. The value of this characteristic represents the 'maximum relative humidity' that mus be reached before dehumidifying is turned on.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
waterLevelItem: (optional)* The openHAB item representing the current water level
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
swingItem: (optional)* The openHAB item showing, if swing is active
* Needs to be of type Switch within openHAB
swingItemInverted (optional)*: If swingItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
rotationSpeedItem: (optional)* The openHAB item representing the rotation speed
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
minFanSpeed (optional)*: If you need to change the minimum allowed fan speed, the rotationSpeedItem is reading in percent
* Needs to be an float
* Default: 0
maxFanSpeed (optional)*: If you need to change the maximum allowed fan speed, the rotationSpeedItem is reading in percent
* Needs to be a float
* Default: 100
minTempStep (optional)*: If you need to change the granularity of the rotationSpeedItem reading/writing (Note: Home.app seem to not allow a greater granularity than 0.5 in the UI, however the reported values might be more granular)
* Needs to be a float
* Default: 1

$3

This service describes a heater and/or cooler accessory.

Important notes on Heater/Cooler

The Heater/Cooler implementation within HomeKit clashes with OpenHAB. The Heater/Cooler is usable but there might be bugs around the mode. If the swing item and rotation speed item are not required, it is recommended to use the Thermostat Service!

Important notes on Heater/Cooler


`json
{
"name": "An items name, as shown in Homekit later",
"type": "heatercooler",
"currentTempItem": "Itemname-within-OpenHAB",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"heatingItem": "Itemname-within-OpenHAB",
"coolingItem": "Itemname-within-OpenHAB",
"modeItem": "Itemname-within-OpenHAB",
"heatingThresholdTempItem": "Itemname-within-OpenHAB",
"coolingThresholdTempItem": "Itemname-within-OpenHAB",
"swingItem": "Itemname-within-OpenHAB",
"swingItemInverted": "false",
"rotationSpeedItem": "Itemname-within-OpenHAB",
"tempUnit": "Celsius",
"minTemp": "-100",
"maxTemp": "200",
"minTempStep": "0.1",
"minFanSpeed": "0",
"maxFanSpeed": "100",
"minFanStep": "1"
}
`

* currentTempItem: The openHAB item representing the current temperature
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
* item: The openHAB item showing, if the heater/cooler is currently active
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If activeItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
heatingItem (optional, if coolingItem is present, otherwise required)*: The openHAB item showing, if the room is currently being heated
* Needs to be of type Switch or Contact within openHAB
coolingItem (optional, if heatingItem is present, otherwise required)*: The openHAB item showing, if the room is currently being cooled
* Needs to be of type Switch or Contact within openHAB
modeItem: (optional)* If your heater/cooler can be set to heating, cooling or auto mode through an item, and/or reports back its current configuration use this item, otherwise the heating/cooling capabilities are deferred from heatingItem and coolingItem and will not be changeable.
* Needs to be of type Number within openHAB
* Only discrete values are recognized:
* 0 ≙ Auto
* 1 ≙ Heat
* 2 ≙ Cool
heatingThresholdTempItem: (optional)* The openHAB item describing the heating threshold in Celsius for devices that support simultaneous heating and cooling. The value of this characteristic represents the 'minimum temperature' that mus be reached before heating is turned on.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
coolingThresholdTempItem: (optional)* The openHAB item describing the cooling threshold in Celsius for devices that support simultaneous heating and cooling. The value of this characteristic represents the 'maximum temperature' that mus be reached before cooling is turned on.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
swingItem: (optional)* The openHAB item showing, if swing is active
* Needs to be of type Switch within openHAB
swingItemInverted (optional)*: If swingItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
rotationSpeedItem: (optional)* The openHAB item representing the rotation speed
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
tempUnit (optional)*: Gives the measurement unit of the thermostat, currently does not change anything inside HomeKit
* Default: Celsius
* Allowed values: Celsius & Fahrenheit
minTemp (optional)*: If you need to change the minimum allowed temperature, the currentTempItem is reading
* Needs to be an float
* Default: -100
maxTemp (optional)*: If you need to change the maximum allowed temperature, the currentTempItem is reading
* Needs to be a float
* Default: 200
minTempStep (optional)*: If you need to change the granularity of the currentTempItem reading/writing (Note: Home.app seem to not allow a greater granularity than 0.5 in the UI, however the reported values might be more granular)
* Needs to be a float
* Default: 0.1
minFanSpeed (optional)*: If you need to change the minimum allowed fan speed, the rotationSpeedItem is reading in percent
* Needs to be an float
* Default: 0
maxFanSpeed (optional)*: If you need to change the maximum allowed fan speed, the rotationSpeedItem is reading in percent
* Needs to be a float
* Default: 100
minTempStep (optional)*: If you need to change the granularity of the rotationSpeedItem reading/writing (Note: Home.app seem to not allow a greater granularity than 0.5 in the UI, however the reported values might be more granular)
* Needs to be a float
* Default: 1

$3

This service describes an air purifier accessory.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "airpurifier",
"purifyingItem": "Itemname-within-OpenHAB",
"modeItem": "Itemname-within-OpenHAB",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"swingItem": "Itemname-within-OpenHAB",
"swingItemInverted": "false",
"rotationSpeedItem": "Itemname-within-OpenHAB",
"minFanSpeed": "0",
"maxFanSpeed": "100",
"minFanStep": "1"
}
`
* purifyingItem: The openHAB item showing, if the air purifier is currently purifying the air
* Needs to be of type Switch or Contact within openHAB
* modeItem: The openHAB item showing, if the air purifier is currently in Manual (OFF or CLOSED) or Automatic Mode (ON or OPEN)
* Needs to be of type Switch or Contact within openHAB
* item: The openHAB item showing, if the air purifier is currently active
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If activeItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
swingItem: (optional)* The openHAB item showing, if swing is active
* Needs to be of type Switch within openHAB
swingItemInverted (optional)*: If swingItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
rotationSpeedItem: (optional)* The openHAB item representing the rotation speed
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
minFanSpeed (optional)*: If you need to change the minimum allowed fan speed, the rotationSpeedItem is reading in percent
* Needs to be an float
* Default: 0
maxFanSpeed (optional)*: If you need to change the maximum allowed fan speed, the rotationSpeedItem is reading in percent
* Needs to be a float
* Default: 100
minFanStep (optional)*: If you need to change the granularity of the rotationSpeedItem reading/writing (Note: Home.app seem to not allow a greater granularity than 0.5 in the UI, however the reported values might be more granular)
* Needs to be a float
* Default: 1

$3

This service is used to control the audio output settings on a speaker device.

Note: Even though Speaker is part of Apple's HAP specification, this accessory is shown as "not supported" in the Home app.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "speaker",
"muteItem": "Itemname-within-OpenHAB",
"muteItemInverted": "true",
"volumeItem": "Itemname-within-OpenHAB"

}
`
* muteItem: The openHAB item showing, if the speaker is muted
* Needs to be of type Switch within openHAB
muteItemInverted (optional)*: If muteItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
volumeItem (optional)*: The openHAB item controlling the speaker's volume
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)



$3

This service is used to control the audio input settings on an audio device (primarily used for microphones).

Note: Even though Microphone is part of Apple's HAP specification, this accessory is shown as "not supported" in the Home app.
`json
{
"name": "An items name, as shown in Homekit later",
"type": "microphone",
"muteItem": "Itemname-within-OpenHAB",
"muteItemInverted": "true",
"volumeItem": "Itemname-within-OpenHAB"

}
`
* muteItem: The openHAB item showing, if the microphone is muted
* Needs to be of type Switch within openHAB
muteItemInverted (optional)*: If muteItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
volumeItem (optional)*: The openHAB item controlling the microphone's volume
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)

$3


This service describes a generic valve or a specific Faucet, Irigation System or Showerhead.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "valve",
"item": "Itemname-within-OpenHAB",
"inverted": "true",
"inUseItem": "Itemname-within-OpenHAB",
"inUseItemInverted": "true",
"durationItem": "Itemname-within-OpenHAB",
"valveType": "generic"
}
`
* item: The openHAB item showing, if the valve is currently active
* Needs to be of type Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
* inUseItem Representing, if the valve is currently in use (if Switch is ON, Contact is OPEN or Number is greater than 0)
* Needs to be of type Switch, Contact or Number within openHAB
inUseItemInverted (optional)*: If inUseItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
durationItem (optional)*: This item will be set by HomeKit to show the duration for the watering. This item should also be decreased, to show the remaining watering time
* Needs to be of type Number within openHAB
valveType (optional)*: The type of valve described by this service.
* Default: generic
* Allowed values: generic, irrigation, showerhead, faucet



$3

This service describes motorized window coverings or shades - examples include shutters, blinds, awnings etc.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "windowcovering",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"multiplier": "1",
"stateItem": "Itemname-within-OpenHAB",
"stateItemInverted": "false",
"stateItemMultiplier": "1",
"manuMode": "false",
"horizontalTiltItem": "Itemname-within-OpenHAB",
"horizontalTiltItemRangeStart": "-90",
"horizontalTiltItemRangeEnd": "90",
"verticalTiltItem": "Itemname-within-openHAB",
"verticalTiltItemRangeStart": "-90",
"verticalTiltItemRangeEnd": "90"
}
`
* item: The openHAB item representing the window covering, receiving commands about the target position and determining the current position (if stateItem is not set)
* Needs to be of type Rollershutter, Number or Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
multiplier (optional)*: If item's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
stateItem (optional)*: The openHAB item, used to determine the state of the window covering instead of item's state
* Needs to be of type Rollershutter, Number, Switch or Contact within openHAB
stateItemInverted (optional)*: If stateItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
stateItemMultiplier (optional)*: If stateItem's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
manuMode (optional)*: If your item can be operated manually, you should enable this mode to not see Opening... or Closing... on the item when manipulating the state manually (This is due to the fact that HomeKit stores a TargetState value and compares it to the ActualState to show this metadata. The manuMode automatically changes the TargetState of the item, when the ActualState is changed)
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
horizontalTiltItem (optional)*: An item representing the angle of horizontal slats.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
* Allowed value range: -90 to 90 (for different ranges, see horizontalTiltItemRangeStart and horizontalTiltItemRangeEnd):
* A value of 0 indicates that the slats are rotated to a fully open position
* A value of -90 indicates that the slats are rotated all the way in a direction where the user-facing edge is higher than the window-facing edge
* A value of 90 indicates that the slats are rotated all the way in a direction where the window-facing edge is higher than the user-facing edge
horizontalTiltItemRangeStart (optional)*: If the range of the openHAB item does not start at -90 (e.g. if the angle is represented in percent from 0 to 100) set this value. The range will be mapped linearly.
* Default: "-90"
* Allowed values: All integers
horizontalTiltItemRangeEnd (optional)*: If the range of the openHAB item does not end at 90 (e.g. if the angle is represented in percent from 0 to 100) set this value. The range will be mapped linearly.
* Default: "90"
* Allowed values: All integers
verticalTiltItem (optional)*: An item representing the angle of vertical slats.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
* Allowed value range: -90 to 90 (for different ranges, see verticalTiltItemRangeStart and verticalTiltItemRangeEnd):
* A value of 0 indicates that the slats are rotated to a fully open position
* A value of -90 indicates that the slats are rotated all the way in a direction where the user-facing edge is to the left of the window-facing edge
* A value of 90 indicates that the slats are rotated all the way in a direction where the user-facing edge is to the right of the window-facing edge
verticalTiltItemRangeStart (optional)*: If the range of the openHAB item does not start at -90 (e.g. if the angle is represented in percent from 0 to 100) set this value. The range will be mapped linearly.
* Default: "-90"
* Allowed values: All integers
verticalTiltItemRangeEnd (optional)*: If the range of the openHAB item does not end at 90 (e.g. if the angle is represented in percent from 0 to 100) set this value. The range will be mapped linearly.
* Default: "90"
* Allowed values: All integers


$3

This service describes a motorized door

`json
{
"name": "An items name, as shown in Homekit later",
"type": "door",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"multiplier": "1",
"stateItem": "Itemname-within-OpenHAB",
"stateItemInverted": "false",
"stateItemMultiplier": "1",
"manuMode": "false"
}
`
* item: The openHAB item representing the door, receiving commands about the target position and determining the current position (if stateItem is not set)
* Needs to be of type Rollershutter, Number or Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
multiplier (optional)*: If item's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
stateItem (optional)*: The openHAB item, used to determine the state of the door instead of item's state
* Needs to be of type Rollershutter, Number, Switch or Contact within openHAB
stateItemInverted (optional)*: If stateItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
stateItemMultiplier (optional)*: If stateItem's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
manuMode (optional)*: If your item can be operated manually, you should enable this mode to not see Opening... or Closing... on the item when manipulating the state manually (This is due to the fact that HomeKit stores a TargetState value and compares it to the ActualState to show this metadata. The manuMode automatically changes the TargetState of the item, when the ActualState is changed)
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*

$3

This service describes a motorized window

`json
{
"name": "An items name, as shown in Homekit later",
"type": "window",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"multiplier": "1",
"stateItem": "Itemname-within-OpenHAB",
"stateItemInverted": "false",
"stateItemMultiplier": "1",
"manuMode": "false"
}
`
* item: The openHAB item representing the window, receiving commands about the target position and determining the current position (if stateItem is not set)
* Needs to be of type Rollershutter, Number or Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
multiplier (optional)*: If item's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
stateItem (optional)*: The openHAB item, used to determine the state of the window instead of item's state
* Needs to be of type Rollershutter, Number, Switch or Contact within openHAB
stateItemInverted (optional)*: If stateItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
stateItemMultiplier (optional)*: If stateItem's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
manuMode (optional)*: If your item can be operated manually, you should enable this mode to not see Opening... or Closing... on the item when manipulating the state manually (This is due to the fact that HomeKit stores a TargetState value and compares it to the ActualState to show this metadata. The manuMode automatically changes the TargetState of the item, when the ActualState is changed)
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*

$3

The HomeKit Lock Mechanism service is designed to expose and control the physical lock mechanism on a device.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "lock",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"stateItem": "Itemname-within-OpenHAB",
"stateItemInverted": "false"
}
`
* item: The openHAB item representing the lock, receiving commands about the target position and determining the current position (if stateItem is not set)
* Needs to be of type Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
stateItem (optional)*: The openHAB item, used to determine the state of the lock instead of item's state
* Needs to be of type Switch or Contact within openHAB
stateItemInverted (optional)*: If stateItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*



$3

This service describes a garage door opener tat controls a single door. If a garage has more than one door, then each door should have its own Garage Door Opener Service.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "garage",
"item": "Itemname-within-OpenHAB",
"inverted": "false",
"multiplier": "1",
"stateItem": "Itemname-within-OpenHAB",
"stateItemInverted": "false",
"stateItemMultiplier": "1",
"obstructionItem": "Itemname-within-OpenHAB",
"obstructionItemInverted": "false"
}
`
* item: The openHAB item representing the garage door, receiving commands about the target position and determining the current position (if stateItem is not set)
* Needs to be of type Rollershutter, Number or Switch within openHAB
* In case of a Number item:
* 100 ≙ OPEN
* 0 ≙ CLOSED
* In case of a Rollershutter item:
* For the current state, the accessory behaves like a Number item
* For the target state, the item will receive UP and DOWN commands
* If you have an inverted Rollershutter item, use the same item as stateItem with stateItemInverted set to "true" and inverted set to false
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
multiplier (optional)*: If item's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
stateItem (optional)*: The openHAB item, used to determine the state of the garage door instead of item's state
* Needs to be of type Rollershutter, Number, Switch or Contact within openHAB
stateItemInverted (optional)*: If stateItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
stateItemMultiplier (optional)*: If stateItem's state need to be multiplied by a fixed amount to make sense to HomeKit, set this to a number (e.g. if your device stores its state in a float range from 0 to 1, where HomeKit expects integer numbers from 0 to 100 use a multiplier of 100)
* Default: "1"
Needs to be a number don't forget the quotes*
* obstructionItem: The openHAB item showing, if an obstruction is detected
* Needs to be of type Switch or Contact within openHAB
obstructionItemInverted (optional)*: If obstructionItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*



$3

This service describes a slat which tilts on a vertical or a horizontal axis.

Note: Even though Slat is part of Apple's HAP specification, this accessory is shown as "not supported" in the Home app.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "slat",
"stateItem": "Itemname-within-OpenHAB",
"stateItemInverted": "false",
"item": "Itemname-within-OpenHAB",
"itemRangeStart": "itemRangeStart",
"itemRangeEnd": "itemRangeEnd",
"slatType": "horizontal"
}
`
* stateItem: The openHAB item describing the current state. The state can be Fixed or Swinging.
* Needs to be of type Switch or Contact within openHAB
* By default, OPEN or ON represents a swinging state, and CLOSED or OFF a fixed state.
stateItemInverted (optional)*: If stateItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
item (optional)*: The openHAB item representing the tilt angle of the slat, if the user can set the slats to a particular tilt angle.
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
* Allowed value range: -90 to 90 (for different ranges, see itemRangeStart and itemRangeEnd):
* A value of 0 indicates that the slats are rotated to a fully open position
* If slatType is vertical:
* A value of -90 indicates that the slats are rotated all the way in a direction where the user-facing edge is higher than the window-facing edge
* A value of 90 indicates that the slats are rotated all the way in a direction where the window-facing edge is higher than the user-facing edge
* If slatType is horizontal:
* A value of -90 indicates that the slats are rotated all the way in a direction where the user-facing edge is to the left of the window-facing edge
* A value of 90 indicates that the slats are rotated all the way in a direction where the user-facing edge is to the right of the window-facing edge
itemRangeStart (optional)*: If the range of the openHAB item does not start at -90 (e.g. if the angle is represented in percent from 0 to 100) set this value. The range will be mapped linearly.
* Default: "-90"
* Allowed values: All integers
itemRangeEnd (optional)*: If the range of the openHAB item does not end at 90 (e.g. if the angle is represented in percent from 0 to 100) set this value. The range will be mapped linearly.
* Default: "90"
* Allowed values: All integers
slatType (optional)*: Describes the type of slats
* Default: horizontal
* Allowed values: horizontal & vertical



$3

This service describes a temperature sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "temp",
"currentTempItem": "Itemname-within-OpenHAB",
"tempUnit": "Celsius",
"minTemp": "-100",
"maxTemp": "200",
"minTempStep": "0.1"
}
`
* currentTempItem: The openHAB item representing the current temperature
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)
tempUnit (optional)*: Gives the measurement unit of the thermostat. HomeKit always expects the input to be in degrees celsius, therefore specifying Fahrenheit as a unit, the plugin will convert the values to be shown correctly on the fly.
* Default: Celsius
* Allowed values: Celsius & Fahrenheit
minTemp (optional)*: If you need to change the minimum allowed temperature, the currentTempItem is reading
* Needs to be an float
* Default: -100
maxTemp (optional)*: If you need to change the maximum allowed temperature, the currentTempItem is reading
* Needs to be a float
* Default: 200
minTempStep (optional)*: If you need to change the granularity of the currentTempItem reading
* Needs to be a float
* Default: 0.1

$3

This service describes a humidity sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "humidity",
"item": "Itemname-within-OpenHAB"
}
`
* item: The openHAB item representing the current humidity
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)

$3

This service describes a light sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "lux",
"item": "Itemname-within-OpenHAB"
}
`
* item: The openHAB item representing the current light in lux
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)

$3

This service describes an air quality sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "air",
"item": "Itemname-within-OpenHAB"
}
`
* item: The openHAB item representing the current air quality, referring to the cumulative air quality recorded by the accessory, which may be based on multiple sensors present.
* Needs to be of type Number within openHAB
* Only discrete values are recognized:
* 0 ≙ UNKNOWN
* 1 ≙ EXCELLENT
* 2 ≙ GOOD
* 3 ≙ FAIR
* 4 ≙ INFERIOR
* 5 ≙ POOR



$3

This service describes a binary switch.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "switch",
"item": "Itemname-within-OpenHAB",
"inverted": "false"
}
`
* item: The openHAB item controlled by this accessory
* Needs to be of type Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*




$3

This service describes an outlet.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "outlet",
"item": "Itemname-within-OpenHAB",
"inverted": "true",
"inUseItem": "Itemname-within-OpenHAB",
"inUseItemInverted": "false"
}
`
* item: The openHAB item controlled by this accessory
* Needs to be of type Switch within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
inUseItem (optional)*: Representing, if the outlet is currently in use (if Switch is ON, Contact is OPEN or Number is greater than 0)
* Default: The state of item is used to show if the outlet is in use
* Needs to be of type Switch, Contact or Number within openHAB
inUseItemInverted (optional)*: If inUseItem's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*

$3

This service describes a motion sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "motion",
"item": "Itemname-within-OpenHAB",
"inverted": "true"
}
`
* item: The openHAB item showing, if motion is detected
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*

$3

This service describes an occupancy sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "occupancy",
"item": "Itemname-within-OpenHAB",
"inverted": "true"
}
`
* item: The openHAB item showing, if occupancy is detected
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*

$3

This service describes a leak sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "leak",
"item": "Itemname-within-OpenHAB",
"inverted": "true"
}
`
* item: The openHAB item showing, if a leak is detected
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*

$3

This service describes a carbon monoxide sensor.

`json
{
"name": "An items name, as shown in Homekit later",
"type": "co",
"item": "Itemname-within-OpenHAB",
"inverted": "true",
"levelItem": "Itemname-within-OpenHAB"
}
`
* item: The openHAB item showing, if carbon monoxide is detected
* Needs to be of type Switch or Contact within openHAB
inverted (optional)*: If item's state needs to be interpreted inverted, set this value to "true"
* Default: "false"
Allowed values: "true" & "false" don't forget the quotes*
levelItem (optional)*: The openHAB item representing the current carbon monoxide level, measured by the sensor
* Needs to be of type Number, Rollershutter, or Dimmer within openHAB

(Note: When using Dimmer or Rollershutter type and OpenHAB receives a non numeric command like ON, OFF, INCREASE, DECREASE, UP or DOWN this might lead to unexpected behaviour and/or non-responsive HomeKit items. This exception is not covered by this plugin and the user needs to ensure a consistent state)

$3

This service describes a carbon dioxide sensor.

``json
{
"name": "An items name, as show