-# Adorne Binding
+# Adorne Binding
The Adorne Binding integrates [Adorne Wi-Fi ready devices](https://www.legrand.us/adorne/products/wireless-whole-house-lighting-controls.aspx) (switches, dimmers, outlets) from [Legrand](https://legrand.com/).
## Discovery
-Auto-discovery is supported as long as the hub can be discovered using the default host and port.
-If the hub requires custom host and/or port configuration manual setup is required.
+Auto-discovery is supported as long as the hub can be discovered using the default host and port.
+If the hub requires custom host and/or port configuration manual setup is required.
Background discovery is not supported.
Legrand does not provide an easy way to look up a zone ID for a device.
However, zone IDs are simply assigned sequentially starting with 0 in the order devices are added to the hub.
-So the first device will have zone ID 0, the next 1 and so on.
+So the first device will have zone ID 0, the next 1 and so on.
## Channels
Once the dimmer is turned on it will turn on with the updated brightness setting.
Consequently when a dimmer is turned on it always returns to the most recent brightness setting.
In other words power and brightness states are controlled independently.
-This matches how power and brightness are managed on the physical dimmer itself.
+This matches how power and brightness are managed on the physical dimmer itself.
To avoid confusion for the user any UI must ensure that only values from 1 to 100 are passed to the brightness channel.
-A default slider allows a 0 value and should not be used since there will be no response when the user selects 0.
+A default slider allows a 0 value and should not be used since there will be no response when the user selects 0.
Common UI choices are Sliders or Setpoints with a minimum value of 1 and a maximum value of 100 (min/max values in Sliders are only supported as of openHAB 2.5).
## Example
This is a simple example that uses an Adorne switch and two dimmers.
Remember that the host and port parameter are not needed in most cases.
As discussed above care is taken that the brightness channel only allows values from 1 to 100 by specifying a min and max value in the sitemap for the dimmers.
-For this example to run on an openHAB version older than 2.5 Bedroom 1's Slider must be removed in the sitemap since older versions don't support the min/max setting.
+For this example to run on an openHAB version older than 2.5 Bedroom 1's Slider must be removed in the sitemap since older versions don't support the min/max setting.
## demo.things
-```
+```java
Bridge adorne:hub:home "Adorne Hub" [host="192.160.1.111", port=2113] {
- switch bathroom "Bathroom" [zoneId=0]
- dimmer bedroom1 "Bedroom1" [zoneId=1]
- dimmer bedroom2 "Bedroom2" [zoneId=2]
+ switch bathroom "Bathroom" [zoneId=0]
+ dimmer bedroom1 "Bedroom1" [zoneId=1]
+ dimmer bedroom2 "Bedroom2" [zoneId=2]
}
```
## demo.items
-```
+```java
Switch LightBathroom {channel="adorne:switch:home:bathroom:power"}
Switch LightBedroomSwitch1 {channel="adorne:dimmer:home:bedroom1:power"}
Dimmer LightBedroomDimmer1 {channel="adorne:dimmer:home:bedroom1:brightness"}
## demo.sitemap
-```
+```perl
sitemap demo label="Adorne Binding Demo"
{
- Frame label="Adorne Switch" {
- Switch item=LightBathroom label="Bathroom" mappings=["ON"="On", "OFF"="Off"] icon="light-on"
- }
- Frame label="Adorne Dimmer using Slider" {
- Switch item=LightBedroomSwitch1 label="Bedroom 1" mappings=["ON"="On", "OFF"="Off"] icon="light-on"
- Slider item=LightBedroomDimmer1 label="Bedroom 1" icon="light-on" minValue=1 maxValue=100 step=1
- }
- Frame label="Adorne Dimmer using Setpoint" {
- Switch item=LightBedroomSwitch2 label="Bedroom 2" mappings=["ON"="On", "OFF"="Off"] icon="light-on"
- Setpoint item=LightBedroomDimmer2 label="Bedroom 2" icon="light-on" minValue=1 maxValue=100 step=5
- }
+ Frame label="Adorne Switch" {
+ Switch item=LightBathroom label="Bathroom" mappings=["ON"="On", "OFF"="Off"] icon="light-on"
+ }
+ Frame label="Adorne Dimmer using Slider" {
+ Switch item=LightBedroomSwitch1 label="Bedroom 1" mappings=["ON"="On", "OFF"="Off"] icon="light-on"
+ Slider item=LightBedroomDimmer1 label="Bedroom 1" icon="light-on" minValue=1 maxValue=100 step=1
+ }
+ Frame label="Adorne Dimmer using Setpoint" {
+ Switch item=LightBedroomSwitch2 label="Bedroom 2" mappings=["ON"="On", "OFF"="Off"] icon="light-on"
+ Setpoint item=LightBedroomDimmer2 label="Bedroom 2" icon="light-on" minValue=1 maxValue=100 step=5
+ }
}
```
## Supported Things
-- **collectionSchedule:** Represents the connection to the **aha Waste Collection Schedule** with four channels for the different waste types.
+- **collectionSchedule:** Represents the connection to the **aha Waste Collection Schedule** with four channels for the different waste types.
## Discovery
For configuration of the **collectionSchedule** thing, you need the form inputs from the aha collections schedule web page. Follow the steps below to get the required configuration parameters from the form input values.
-
1. Open [aha Abfuhrkalender](https://www.aha-region.de/abholtermine/abfuhrkalender) in your favorite brower with developer-console.
-2. Open the developer console and switch to network tab (for example press F12 in chrome / edge / firefox).
-3. Fill in the form: Select your commune, Street and house number and hit "Suchen".
-4. Select the first request to https://www.aha-region.de/abholtermine/abfuhrkalender (see first screenshot below)
-5. Check the form data at the end of the request for the form values (see second screenshot below)
-5. Fill in the values from the form input in thing configuration (see examples below)
+1. Open the developer console and switch to network tab (for example press F12 in chrome / edge / firefox).
+1. Fill in the form: Select your commune, Street and house number and hit "Suchen".
+1. Select the first request to [https://www.aha-region.de/abholtermine/abfuhrkalender](https://www.aha-region.de/abholtermine/abfuhrkalender) (see first screenshot below)
+1. Check the form data at the end of the request for the form values (see second screenshot below)
+1. Fill in the values from the form input in thing configuration (see examples below)
-*Check if you've selected the correct request, that contains the form data*
+Check if you've selected the correct request, that contains the form data
-*Grab the values for the configuration parameters from the form data section at the end of the request*
+Grab the values for the configuration parameters from the form data section at the end of the request
**collectionSchedule** parameters:
The thing **aha Waste Collection Schedule** provides four channels for the upcoming day of waste collection for the different waste types.
-
| channel | type | description |
|----------|--------|------------------------------|
| generalWaste | DateTime | Next collection day for general waste |
| bioWaste | DateTime | Next collection day for bio waste |
| paper | DateTime | Next collection day for paper |
-
## Full Example
wasteCollection.things
-```
+```java
Thing ahawastecollection:collectionSchedule:wasteCollectionSchedule "aha Abfuhrkalender" [ commune="Isernhagen", street="67269@Rosmarinweg+/+Kirchhorst@Kirchhorst", houseNumber="10", houseNumberAddon="", collectionPlace="67269-0010+" ]
```
wasteCollection.items
-```
+```java
DateTime collectionDay_generalWaste "Next general waste collection" {channel="ahawastecollection:collectionSchedule:wasteCollectionSchedule:generalWaste"}
DateTime collectionDay_leightweightPackaging "Next lightweight packaging collection" {channel="ahawastecollection:collectionSchedule:wasteCollectionSchedule:leightweightPackaging"}
DateTime collectionDay_bioWaste "Next bio waste collection" {channel="ahawastecollection:collectionSchedule:wasteCollectionSchedule:bioWaste"}
DateTime collectionDay_paper "Next paper collection" {channel="ahawastecollection:collectionSchedule:wasteCollectionSchedule:paper"}
```
-
Example for rule that sends a notification with collected waste types on day before collection
-```
+```yaml
triggers:
- id: "1"
configuration:
### air-Q.things
-```
+```java
Thing airq:airq:1 "air-Q" [ ipAddress="192.168.0.68", password="myAirQPassword" ]
```
### air-Q.items
-```
+```java
String airQ_status "Status of Sensors" {channel="airq:airq:1:status"}
Number:Length airQ_avgFineDustSize "Average Size of Fine Dust" {channel="airq:airq:1:avgFineDustSize"}
Number:Dimensionless airQ_fineDustCnt00_3 "Fine Dust >0,3 µm" {channel="airq:airq:1:fineDustCnt00_3"}
## Bridge Configuration
-The bridge configuration only holds the api key :
+The bridge configuration only holds the api key :
| Parameter | Description |
|-----------|-------------------------------------------------------------------------|
| apiKey | Data-platform token to access the AQIcn.org service. Mandatory. |
-
## Thing Configuration
The 'Station' thing has a few configuration parameters:
If you always want to receive data from specific station and you know its unique ID, you can enter it instead of the coordinates.
This `stationId` can be found by using the following link:
-https://api.waqi.info/search/?token=TOKEN&keyword=NAME, replacing TOKEN by your apiKey and NAME by the station you are looking for.
+`https://api.waqi.info/search/?token=TOKEN&keyword=NAME`, replacing TOKEN by your apiKey and NAME by the station you are looking for.
### Thing properties
- Measuring station ID
- Latitude/longitude of measuring station
-
## Channels
The AirQuality information that is retrieved for a given is available as these channels:
| index | Number | AQI Index of the single pollutant |
| alert-level | Number | Alert level associate to the index |
-
-(*) The alert level is described by a color :
+(*) The alert level is described by a color :
| Code | Color | Description |
|------|--------|--------------------------------|
| 4 | Purple | Very Unhealthy |
| 5 | Maroon | Hazardous |
-
## Full Example
-
airquality.things:
```java
## Discovery
-Binding will do autodiscovery for AirVisual Node by searching for a host advertised with the NetBIOS name 'AVISUAL-<SerialNumber>'.
+Binding will do autodiscovery for AirVisual Node by searching for a host advertised with the NetBIOS name `AVISUAL-<SerialNumber>`.
All discovered devices will be added to the inbox. Please note you will need to set the Node username and password in the configuration
of the newly discovered thing before a connection can be made.
The preferred way to add AirVisual Node to the openHAB installation is autodiscovery,
but the AirVisual Node also can be configured using `.things` file:
-```
+```java
airvisualnode:avnode:1a2b3c4 [ address="192.168.1.32", username="airvisual", password="12345", share="airvisual", refresh=60 ]
```
Here is an example of items for the AirVisual Node:
-```
+```java
Number:Temperature Livingroom_Temperature "Temperature [%.1f %unit%]" <temperature> {channel="airvisualnode:avnode:1a2b3c4:temperature"}
Number:Dimensionless Livingroom_Humidity "Humidity [%d %unit%]" <humidity> {channel="airvisualnode:avnode:1a2b3c4:humidity"}
Number:Dimensionless Livingroom_CO2_Level "CO₂" {channel="airvisualnode:avnode:1a2b3c4:co2"}
Example rules:
-```
+```java
rule "AirVisual Node Temperature Rule"
when
Item Livingroom_Temperature changed
Example sitemap:
-```
+```perl
sitemap home label="Home" {
Frame label="Living Room" {
Text item=Livingroom_Temperature
There are several versions of the adapter available:
-* *AD2PI* or *AD2PHAT* - A board that plugs into a Raspberry Pi and offers network-based TCP connectivity
-* *AD2SERIAL* - Attaches to a host via a serial port
-* *AD2USB* - Attaches to a host via USB
+- _AD2PI_ or _AD2PHAT_ - A board that plugs into a Raspberry Pi and offers network-based TCP connectivity
+- _AD2SERIAL_ - Attaches to a host via a serial port
+- _AD2USB_ - Attaches to a host via USB
This binding allows openHAB to access the state of wired or wireless contacts and motion detectors connected to supported alarm panels, as well as the state of attached keypads and the messages send to attached LRR devices.
Support is also available for sending keypad commands, including special/programmable keys supported by your panel.
The binding supports the following thing types:
-* `ipbridge` - Supports TCP connection to the AD.
-* `serialbridge` - Supports serial/USB connection to the AD.
-* `keypad` - Reports keypad status and optionally sends keypad messages.
-* `zone` - Reports status from zone expanders and relay expanders, and also from built-in zones via emulation.
-* `rfzone` - Reports status from RF zones.
-* `vzone` - Sends commands to virtual zones.
-* `lrr` - Reports messages sent from the panel to a Long Range Radio (LRR) or emulated LRR device.
+- `ipbridge` - Supports TCP connection to the AD.
+- `serialbridge` - Supports serial/USB connection to the AD.
+- `keypad` - Reports keypad status and optionally sends keypad messages.
+- `zone` - Reports status from zone expanders and relay expanders, and also from built-in zones via emulation.
+- `rfzone` - Reports status from RF zones.
+- `vzone` - Sends commands to virtual zones.
+- `lrr` - Reports messages sent from the panel to a Long Range Radio (LRR) or emulated LRR device.
## Discovery
Background discovery is currently supported for `zone` and `rfzone` things.
-If the bridge `discovery` parameter is set to *true*, the first time a status message is seen from each zone or RF zone a corresponding thing will appear in the inbox.
-Leaving the `discovery` parameter set to *false* during normal operation is recommended, as it will slightly reduce resource consumption by the binding.
+If the bridge `discovery` parameter is set to _true_, the first time a status message is seen from each zone or RF zone a corresponding thing will appear in the inbox.
+Leaving the `discovery` parameter set to _false_ during normal operation is recommended, as it will slightly reduce resource consumption by the binding.
## Prerequisites
Alarm Decoder things can be configured through openHAB's management UI, or manually via configuration files.
When first configuring the binding it is probably easiest to configure it via the management UI, even if you plan to use configuration files later.
-If you enable the *discovery* option on the bridge, as you fault zones (e.g. open doors and windows, trigger motion detectors, etc.) they should appear in the discovery inbox.
+If you enable the _discovery_ option on the bridge, as you fault zones (e.g. open doors and windows, trigger motion detectors, etc.) they should appear in the discovery inbox.
### ipbridge
-The `ipbridge` thing supports a TCP/IP connection to an Alarm Decoder device such as *AD2PI* or *AD2PHAT*.
+The `ipbridge` thing supports a TCP/IP connection to an Alarm Decoder device such as _AD2PI_ or _AD2PHAT_.
-* `hostname` (required) The hostname or IP address of the Alarm Decoder device
-* `tcpPort` (default = 10000) TCP port number for the Alarm Decoder connection
-* `discovery` (default = false) Enable automatic discovery of zones and RF zones
-* `reconnect` (1-60, default = 2) The period in minutes that the handler will wait between connection checks and connection attempts
-* `timeout` (0-60, default = 5) The period in minutes after which the connection will be reset if no valid messages have been received. Set to 0 to disable.
+- `hostname` (required) The hostname or IP address of the Alarm Decoder device
+- `tcpPort` (default = 10000) TCP port number for the Alarm Decoder connection
+- `discovery` (default = false) Enable automatic discovery of zones and RF zones
+- `reconnect` (1-60, default = 2) The period in minutes that the handler will wait between connection checks and connection attempts
+- `timeout` (0-60, default = 5) The period in minutes after which the connection will be reset if no valid messages have been received. Set to 0 to disable.
Thing config file example:
-```
+```java
Bridge alarmdecoder:ipbridge:ad1 [ hostname="cerberus.home", tcpPort=10000, discovery=true ] {
Thing ...
Thing ...
### serialbridge
-The `serialbridge` thing supports a serial or USB connection to an Alarm Decoder device such as *AD2SERIAL* or *AD2USB*.
+The `serialbridge` thing supports a serial or USB connection to an Alarm Decoder device such as _AD2SERIAL_ or _AD2USB_.
Parameters:
-* `serialPort` (required) The name of the serial port used to connect to the Alarm Decoder device
-* `bitrate` Speed of the serial connection
-* `discovery` (default=false) Enable automatic discovery of zones and RF zones
+- `serialPort` (required) The name of the serial port used to connect to the Alarm Decoder device
+- `bitrate` Speed of the serial connection
+- `discovery` (default=false) Enable automatic discovery of zones and RF zones
Thing config file example:
-```
+```java
Bridge alarmdecoder:serialbridge:ad1 [ serialPort="/dev/ttyS1", bitrate=115200, discovery=true ] {
Thing ...
Thing ...
Parameters:
-* `addressMask` (default = 0) String containing the mask in hex of addresses for which the keypad thing will receive messages (0 = all addresses).
-* `sendCommands` (default = false) Allow keypad commands to be sent to the alarm system from openHAB. Enabling this means the alarm system will be only as secure as your openHAB system.
-* `sendStar` (default = false) When disarmed/faulted, automatically send the * character to obtain zone fault information.
-* `commandMapping` (optional) Comma separated list of key/value pairs mapping integers to command strings for `intcommand` channel.
+- `addressMask` (default = 0) String containing the mask in hex of addresses for which the keypad thing will receive messages (0 = all addresses).
+- `sendCommands` (default = false) Allow keypad commands to be sent to the alarm system from openHAB. Enabling this means the alarm system will be only as secure as your openHAB system.
+- `sendStar` (default = false) When disarmed/faulted, automatically send the * character to obtain zone fault information.
+- `commandMapping` (optional) Comma separated list of key/value pairs mapping integers to command strings for `intcommand` channel.
Address masks
The mask itself is represented as a string containing a hexadecimal number.
For example, a mask of 03000000 would indicate devices 0 and 1 as follows:
-```
+```text
Mask: 03000000
Bytes: 03 00 00 00
Bits: 00000011 00000000 00000000 00000000
Thing config file example:
-```
+```java
Thing keypad keypad1 [ addressMask=0, sendCommands=true ]
```
Parameters:
-* `address` (required) Zone address
-* `channel` (required) Zone channel
+- `address` (required) Zone address
+- `channel` (required) Zone channel
Thing config file example:
-```
+```java
Thing zone frontdoor [ address=10, channel=1 ]
```
Parameters:
-* `serial` (required) Serial number of the RF zone
+- `serial` (required) Serial number of the RF zone
Thing config file example:
-```
+```java
Thing rfzone motion1 [ serial=0180010 ]
```
Parameters:
-* `address` (required) Virtual zone number (0-99)
+- `address` (required) Virtual zone number (0-99)
Thing config file example:
-```
+```java
Thing vzone watersensor [ address=41 ]
```
They can also, depending on configuration, be other types of messages as described [here](https://www.alarmdecoder.com/wiki/index.php/LRR_Support).
For panels that support multiple partitions, the partition for which a given lrr thing will receive messages can be defined.
-* `partition` (default = 0) Partition for which to receive LRR events (0 = All)
+- `partition` (default = 0) Partition for which to receive LRR events (0 = All)
Thing config file example:
-```
+```java
Thing lrr lrr [ partition=0 ]
```
The alarmdecoder things expose the following channels:
-**zone**
+### zone
| channel | type |RO/RW| description |
|--------------|---------|-----|------------------------------|
| contact | Contact |RO |Zone contact state |
-**rfzone**
+### rfzone
| channel | type |RO/RW| description |
|--------------|---------|-----|------------------------------|
| loop3 | Contact | RO |Loop 3 state |
| loop4 | Contact | RO |Loop 4 state |
-**vzone**
+### vzone
| channel | type |RO/RW| description |
|--------------|---------|-----|------------------------------|
| command | String | WO |"OPEN" or "CLOSED" command |
| state | Switch | RW |Zone state (ON = closed) |
-**keypad**
+### keypad
| channel | type |RO/RW| description |
|--------------|---------|-----|------------------------------|
| command | String | RW |Keypad command |
| intcommand | Number | RW |Integer keypad command |
-*Note* - The `intcommand` channel is provided for backward compatibility with the OH1 version of the binding.
+_Note_ - The `intcommand` channel is provided for backward compatibility with the OH1 version of the binding.
The integer to command string mappings are provided by the optional keypad `commandMapping` parameter.
The default mapping is "0=0,1=1,2=2,3=3,4=4,5=5,6=6,7=7,8=8,9=9,10=*,11=#".
-**lrr**
+### lrr
| channel | type |RO/RW| description |
|--------------|---------|-----|------------------------------|
Example ad.things file:
-```
+```java
Bridge alarmdecoder:ipbridge:ad1 [ hostname="cerberus.home", tcpPort=10000, discovery=true ] {
Thing zone frontdoor [ address=10, channel=1 ]
Thing zone backdoor [ address=11, channel=1 ]
Example ad.items file:
-```
+```java
Number KeypadZone "Zone [%d]" {channel="alarmdecoder:keypad:ad1:keypad1:zone"}
String KeypadText "Message" {channel="alarmdecoder:keypad:ad1:keypad1:text"}
Switch KeypadArmedAway "Armed Away" {channel="alarmdecoder:keypad:ad1:keypad1:armedaway"}
String LrrReportCode "CID Report Code" {channel="alarmdecoder:lrr:ad1:lrr:reportcode"}
```
-*Note: For brevity, not every possible keypad channel is linked to an item in the above example.*
+_Note: For brevity, not every possible keypad channel is linked to an item in the above example._
## Thing Actions
The `ipbridge` and `serialbridge` things expose the following action to the automation engine:
-*reboot* - Send command to reboot the Alarm Decoder device. Accepts no parameters.
+_reboot_ - Send command to reboot the Alarm Decoder device. Accepts no parameters.
## Quirks
The alarmdecoder device cannot query the panel for the state of individual zones.
-For this reason, the binding puts contacts into the "unknown" state (UNDEF), *until the panel goes into the READY state*.
+For this reason, the binding puts contacts into the "unknown" state (UNDEF), _until the panel goes into the READY state_.
At that point, all contacts for which no update messages have arrived are presumed to be in the CLOSED state.
In other words: to get to a clean slate after an openHAB restart, close all doors/windows such that the panel is READY.
**Warning:**
The Dash Button will try to contact the Amazon servers every time the button is pressed.
This might not be in line with your privacy preferences but can be prevented.
-Please refer to the ["Preventing Communication with Amazon Servers"](#no-phonehome) section for details.
+Please refer to the ["Preventing Communication with Amazon Servers"](#preventing-communication-with-amazon-servers) section for details.
**Response Time:**
Please be aware, that due to the operation method of this binding, the response time for a button press can be rather high (up to five seconds).
On a Windows system there are two options to go with.
1. The preferred solution is [WinPcap](https://www.winpcap.org) if your network interface is supported.
-2. An alternative option is [npcap](https://github.com/nmap/npcap) with the settings "WinPcap 4.1.3 compatibility" and "Raw 802.11 Packet Capture"
+1. An alternative option is [npcap](https://github.com/nmap/npcap) with the settings "WinPcap 4.1.3 compatibility" and "Raw 802.11 Packet Capture"
### Installing libpcap on Other Operating Systems
## Setup Dash Button
Amazon itself doesn't support Dash Buttons anymore.
-Instructions how to use them without having to rely on Amazon's servers can be found at https://blog.christophermullins.com/2019/12/20/rescue-your-amazon-dash-buttons/ - at least for some firmware versions.
+Instructions how to use them without having to rely on Amazon's servers can be found at [https://blog.christophermullins.com/2019/12/20/rescue-your-amazon-dash-buttons/](https://blog.christophermullins.com/2019/12/20/rescue-your-amazon-dash-buttons/) - at least for some firmware versions.
Take care to block internet access for the button or it will be bricked.
-{: #no-phonehome}
## Preventing Communication with Amazon Servers
Every time a Dash Button is pressed a request will be sent to the Amazon servers.
### Amazon Dash Button
-- `macAddress` - The MAC address of the Amazon Dash Button.
+- `macAddress` - The MAC address of the Amazon Dash Button.
-- `pcapNetworkInterfaceName` - The network interface which receives the packets of the Amazon Dash Button.
+- `pcapNetworkInterfaceName` - The network interface which receives the packets of the Amazon Dash Button.
-- `packetInterval` - Often a single button press is recognized multiple times.
+- `packetInterval` - Often a single button press is recognized multiple times.
You can specify how long any further detected button pressed should be ignored after one click was processed.
The parameter is optional and 5000ms by default.
## First Steps
-1) Create an 'Amazon Account' thing
-2) open the url YOUR_OPENHAB/amazonechocontrol in your browser (e.g. http://openhab:8080/amazonechocontrol/), click the link for your account thing and login.
-3) You should see now a message that the login was successful
-4) If you encounter redirect/page refresh issues, enable two-factor authentication (2FA) on your Amazon account.
+1. Create an 'Amazon Account' thing
+1. open the url YOUR_OPENHAB/amazonechocontrol in your browser (e.g. `http://openhab:8080/amazonechocontrol/`), click the link for your account thing and login.
+1. You should see now a message that the login was successful
+1. If you encounter redirect/page refresh issues, enable two-factor authentication (2FA) on your Amazon account.
## Discovery
If you want to discover your smart home devices you need to activate it in the 'Amazon Account' thing.
Devices from other skills can be discovered too.
-See section *Smart Home Devices* below for more information.
+See section _Smart Home Devices_ below for more information.
## Account
|--------------------------|----------------------------------------------------|
| serialNumber | Serial number of the Amazon Echo in the Alexa app |
-You will find the serial number in the Alexa app or on the webpage YOUR_OPENHAB/amazonechocontrol/YOUR_ACCOUNT (e.g. http://openhab:8080/amazonechocontrol/account1).
+You will find the serial number in the Alexa app or on the webpage YOUR_OPENHAB/amazonechocontrol/YOUR_ACCOUNT (e.g. `http://openhab:8080/amazonechocontrol/account1`).
### Flash Briefing Profile
E.g. to read out the history call from an installation on openhab:8080 with an account named account1:
-http://openhab:8080/amazonechocontrol/account1/PROXY/api/activities?startTime=&size=50&offset=1
+`http://openhab:8080/amazonechocontrol/account1/PROXY/api/activities?startTime=&size=50&offset=1`
### Example
#### echo.things
-```
+```java
Bridge amazonechocontrol:account:account1 "Amazon Account" @ "Accounts" [discoverSmartHome=2, pollingIntervalSmartHomeAlexa=30, pollingIntervalSmartSkills=120]
{
Thing echo echo1 "Alexa" @ "Living Room" [serialNumber="SERIAL_NUMBER"]
Sample for the Thing echo1 only. But it will work in the same way for the other things, only replace the thing name in the channel link.
Take a look in the channel description above to know, which channels are supported by your thing type.
-```
+```java
// Account
String Echo_Living_Room_SendMessage "SendMessage" {channel="amazonechocontrol:account:account1:sendMessage"}
#### echo.sitemap:
-```
+```perl
sitemap amazonechocontrol label="Echo Devices"
{
Frame label="Alexa" {
## Flash Briefing
-#### Supported Things
+### Supported Things
| Thing type id | Name |
|----------------------|---------------------------------------|
| flashbriefingprofile | Flash briefing profile |
-#### Channels
+### Channels
The flashbriefingprofile thing has no configuration parameters.
It will be configured at runtime by using the save channel to store the current flash briefing configuration which is set in the alexa app in the thing. Create a flashbriefingprofile Thing for each set you need.
| active | Switch | R/W | flashbriefingprofile | Active the profile
| playOnDevice | String | W | flashbriefingprofile | Specify the echo serial number or name to start the flash briefing.
-#### Example
+### Example
#### flashbriefings.things
-```
+```java
Bridge amazonechocontrol:account:account1 "Amazon Account" @ "Accounts" [discoverSmartHome=2]
{
Thing flashbriefingprofile flashbriefing1 "Flash Briefing Technical" @ "Flash Briefings"
Sample for the Thing echo1 only. But it will work in the same way for the other things, only replace the thing name in the channel link.
Take a look in the channel description above to know, which channels are supported by your thing type.
-```
+```java
// Flashbriefings
Switch FlashBriefing_Technical_Save "Save (Write only)" {channel="amazonechocontrol:flashbriefingprofile:account1:flashbriefing1:save"}
Switch FlashBriefing_Technical_Active "Active" {channel="amazonechocontrol:flashbriefingprofile:account1:flashbriefing1:active"}
#### flashbriefings.sitemap:
-```
+```perl
sitemap flashbriefings label="Flash Briefings"
{
Frame label="Flash Briefing Technical" {
Note: the channels of smartHomeDevices and smartHomeDeviceGroup will be created dynamically based on the capabilities reported by the amazon server. This can take a little bit of time.
The polling interval configured in the Account Thing to get the state is specified in minutes and has a minimum of 10. This means it takes up to 10 minutes to see the state of a channel. The reason for this low interval is, that the polling causes a big server load for the Smart Home Skills.
-#### Supported Things
+### Supported Things
| Thing type id | Name |
|----------------------|---------------------------------------|
| smartHomeDevice | Smart Home Device |
| smartHomeDeviceGroup | Smart Home Device group |
-
-#### Thing configuration of smartHomeDevice, smartHomeDeviceGroup
+### Thing configuration of smartHomeDevice, smartHomeDeviceGroup
| Configuration name | Description |
|--------------------------|---------------------------------------------------------------------------|
The only possibility to find out the id is by using the discover function in the UI. You can use then the id, if you want define the Thing in a file.
-#### Channels
+### Channels
The channels of the smarthome devices will be generated at runtime. Check in the UI thing configurations, which channels are created.
#### smarthome.things
-```
+```java
Bridge amazonechocontrol:account:account1 "Amazon Account" @ "Accounts" [discoverSmartHome=2, pollingIntervalSmartHomeAlexa=30, pollingIntervalSmartSkills=120]
{
Thing smartHomeDevice smartHomeDevice1 "Smart Home Device 1" @ "Living Room" [id="ID"]
Sample for the Thing echo1 only. But it will work in the same way for the other things, only replace the thing name in the channel link.
Take a look in the channel description above to know which channels are supported by your thing type.
-```
+```java
// Lights and lightgroups
Switch Light_State "On/Off" {channel="amazonechocontrol:smartHomeDevice:account1:smartHomeDevice1:powerState"}
Dimmer Light_Brightness "Brightness" {channel="amazonechocontrol:smartHomeDevice:account1:smartHomeDevice1:brightness"}
#### smarthome.sitemap:
-```
+```perl
sitemap smarthome label="Smart Home Devices"
{
Frame label="Lights and light groups" {
## How To Get IDs
-1) Open the url YOUR_OPENHAB/amazonechocontrol in your browser (e.g. http://openhab:8080/amazonechocontrol/)
-2) Click on the name of the account thing
-3) Click on the name of the echo thing
-4) Scroll to the channel and copy the required ID
+1. Open the url YOUR_OPENHAB/amazonechocontrol in your browser (e.g. `http://openhab:8080/amazonechocontrol/`)
+1. Click on the name of the account thing
+1. Click on the name of the echo thing
+1. Scroll to the channel and copy the required ID
-## Advanced Feature Technically Experienced Users
+### Advanced Feature Technically Experienced Users
The url <YOUR_OPENHAB>/amazonechocontrol/<YOUR_ACCOUNT>/PROXY/<API_URL> provides a proxy server with an authenticated connection to the amazon alexa server. This can be used to call alexa api from rules.
E.g. to read out the history call from an installation on openhab:8080 with an account named account1:
-http://openhab:8080/amazonechocontrol/account1/PROXY/api/activities?startTime=&size=50&offset=1
+`http://openhab:8080/amazonechocontrol/account1/PROXY/api/activities?startTime=&size=50&offset=1`
## Tutorials
Note: If you turn off the sound and Alexa is playing music, it will anyway turn down the volume for a moment. This behavior can not be changed.
-
-```php
+```java
rule "Say welcome if the door opens"
when
Item Door_Contact changed to OPEN
## Playing an alarm sound for 15 seconds with an openHAB rule if a door contact was opened:
-1) Do get the ID of your sound, follow the steps in "How To Get IDs"
-2) Write down the text in the square brackets. e.g. ECHO:system_alerts_repetitive01 for the nightstand sound
-3) Create a rule for start playing the sound:
+1. Do get the ID of your sound, follow the steps in "How To Get IDs"
+1. Write down the text in the square brackets. e.g. ECHO:system_alerts_repetitive01 for the nightstand sound
+1. Create a rule for start playing the sound:
-```php
+```java
var Timer stopAlarmTimer = null
rule "Turn on alarm sound for 15 seconds if door opens"
### Play a spotify playlist if a switch was changed to on:
-1) Do get the ID of your sound, follow the steps in "How To Get IDs"
-2) Write down the text in the square brackets. e.g. SPOTIFY for the spotify music provider
-3) Create a rule for start playing a song or playlist:
+1. Do get the ID of your sound, follow the steps in "How To Get IDs"
+1. Write down the text in the square brackets. e.g. SPOTIFY for the spotify music provider
+1. Create a rule for start playing a song or playlist:
-```php
+```java
rule "Play a playlist on spotify if a switch was changed"
when
Item Spotify_Playlist_Switch changed to ON
### Start playing weather/traffic/etc:
-1) Pick up one of the available commands: Weather, Traffic, GoodMorning, SingASong, TellStory, FlashBriefing
-2) Create a rule for start playing the information where you provide the command as string:
+1. Pick up one of the available commands: Weather, Traffic, GoodMorning, SingASong, TellStory, FlashBriefing
+1. Create a rule for start playing the information where you provide the command as string:
-```php
+```java
rule "Start wheater info"
when
Item Spotify_Start_Wheater_Switch changed to ON
### Start playing a custom flashbriefing on a device:
-1) Do get the ID of your sound, follow the steps in "How To Get IDs"
-2) Write down the text in the square brackets. e.g. flashbriefing.flashbriefing1
-2) Create a rule for start playing the information where you provide the command as string:
+1. Do get the ID of your sound, follow the steps in "How To Get IDs"
+1. Write down the text in the square brackets. e.g. flashbriefing.flashbriefing1
+1. Create a rule for start playing the information where you provide the command as string:
-```php
+```java
rule "Start wheater info"
when
Item Spotify_Start_Wheater_Switch changed to ON
end
```
-## Advanced Feature Technically Experienced Users
+### Advanced Feature Technically Experienced Users
The url <YOUR_OPENHAB>/amazonechocontrol/<YOUR_ACCOUNT>/PROXY/<API_URL> provides a proxy server with an authenticated connection to the Amazon Alexa server.
This can be used to call Alexa API from rules.
E.g. to read out the history call from an installation on openhab:8080 with an account named account1:
-http://openhab:8080/amazonechocontrol/account1/PROXY/api/activities?startTime=&size=50&offset=1
+`http://openhab:8080/amazonechocontrol/account1/PROXY/api/activities?startTime=&size=50&offset=1`
To resolve login problems the connection settings of an `account` thing can be reset via the karaf console.
The command `amazonechocontrol listAccounts` shows a list of all available `account` things.
## Credits
-The idea for writing this binding came from this blog: https://blog.loetzimmer.de/2017/10/amazon-alexa-hort-auf-die-shell-echo.html (German).
+The idea for writing this binding came from this blog: [https://blog.loetzimmer.de/2017/10/amazon-alexa-hort-auf-die-shell-echo.html](https://blog.loetzimmer.de/2017/10/amazon-alexa-hort-auf-die-shell-echo.html) (German).
Thank you Alex!
-The technical information for the web socket connection to get live Alexa state updates cames from Ingo. He has done the Alexa ioBroker implementation https://github.com/Apollon77
+The technical information for the web socket connection to get live Alexa state updates cames from Ingo. He has done the Alexa ioBroker implementation [https://github.com/Apollon77](https://github.com/Apollon77)
Thank you Ingo!
## Trademark Disclaimer
The binding currently supports weather data from these weather stations.
-| Thing | ID |
+| Thing | ID |
|--------------------------|-----------|
| Account | bridge |
| WS-0900-IP | ws0900ip |
| Parameter | Parameter ID | Required/Optional | Description |
|------------------|-------------------|-------------------|-------------|
-| API Key | apiKey | Required | Obtain the API key on the *My Account* page of your `ambientweather.net` dashboard. |
-| Application Key | apiKey | Required | Obtain the Application key on the *My Account* page of your `ambientweather.net` dashboard. |
+| API Key | apiKey | Required | Obtain the API key on the _My Account_ page of your `ambientweather.net` dashboard. |
+| Application Key | apiKey | Required | Obtain the Application key on the _My Account_ page of your `ambientweather.net` dashboard. |
### Weather Station
### Things
-```
+```java
Bridge ambientweather:bridge:account "Ambient Weather Account" [ applicationKey="bd7eb3fe87f74e9.....", apiKey="efe88d6202be43e6a40....." ] {
Thing ws1400ip 1400 "Ambient Weather WS-1400-IP" [ macAddress="00:ab:cd:00:00:01" ]
Thing ws8482 8482 "Ambient Weather WS-8482" [ macAddress="00:ab:cd:00:00:02" ]
### Items
-```
+```java
// WS-1400-IP Weather Station
String WS1400IP_StationName "Station Name [%s]" { channel="ambientweather:ws1400ip:account:1400:station#name" }
String WS1400IP_StationLocation "Station Location [%s]" { channel="ambientweather:ws1400ip:account:1400:station#location" }
#### File ambient-battery.map
-```
+```text
-=UNKNOWN
NULL=UNKNOWN
1=GOOD
### Sitemap
-```
+```perl
Text label="Weather Station" icon="sun_clouds" {
Frame {
Text item=WS1400IP_ObservationTime label="Observation Time [%1$tm/%1$td %1$tl:%1$tM %1$tp]"
Adding support for a new weather station type involves changes to the source code in just a few places.
-#### Add a New Thing Type in AmbientWeatherBindingConstants.java
+### Add a New Thing Type in AmbientWeatherBindingConstants.java
Define a new `ThingTypeUID` for the new station and add it to the `SUPPORTED_THING_TYPES_UIDS` Collection.
Add a channel group for the new station.
-#### Create OH-INF/thing/\<station-model\>.xml
+### Create OH-INF/thing/\<station-model\>.xml
Add thing type and channel group specific to the data elements supported by this weather station.
Modeling this after an existing thing type that shares many of the channels is the easiest starting point.
You can determine the weather data elements returned for the weather station by putting the binding into debug mode and reviewing the JSON object returned by the Ambient Weather API.
-#### Create Processor Class <StationModel>Processor
+### Create Processor Class <StationModel>Processor
Add a class in `org.openhab.binding.ambientweather.internal.processor` that defines the channels supported by this station type.
Again, the easiest approach is to model this class after a class for a similar weather station type.
-##### Method: processInfoUpdate
+#### Method: processInfoUpdate
Updates the channels for station name and location.
-##### Method: processWeatherData
+#### Method: processWeatherData
Updates channels for weather data.
-#### Update ProcessorFactory.java
+### Update ProcessorFactory.java
Add new Processor class definition to `ProcessorFactory.java`, and add a new case to the switch statement to return the new processor.
This binding supports the multi-room audio system [AmpliPi](http://www.amplipi.com/) from [MicroNova](http://www.micro-nova.com/).
-
## Supported Things
The AmpliPi itself is modeled as a Bridge of type `controller`.
amplipi.things:
-```
+```java
Bridge amplipi:controller:1 "My AmpliPi" [ hostname="amplipi.local" ] {
zone zone2 "Living Room" [ id=1 ]
}
amplipi.items:
-```
+```java
Number Preset "Preset" { channel="amplipi:controller:1:preset" }
String Input1 "Input 1" { channel="amplipi:controller:1:input1" }
String Input2 "Input 2" { channel="amplipi:controller:1:input2" }
amplipi.sitemap:
-```
+```perl
sitemap amplipi label="Main Menu"
{
Frame label="AmpliPi" {
| Nexus5x | 8.1.0 | Everything works nice |
| Freebox Pop Player | 9 | Everything works nice |
-Please update this document if you tested it with other android versions to reflect the compatibility of the binding.
+Please update this document if you tested it with other android versions to reflect the compatibility of the binding.
## Discovery
The available modes are:
-* idle: assert not playing, avoid command execution.
-* media_state: detect play status by dumping the media_session service. This is the default for not configured apps
-* audio: detect play status by dumping the audio service.
-* wake_lock: detect play status by comparing the power wake lock state with the values provided in 'wakeLockPlayStates'
+- idle: assert not playing, avoid command execution.
+- media_state: detect play status by dumping the media_session service. This is the default for not configured apps
+- audio: detect play status by dumping the audio service.
+- wake_lock: detect play status by comparing the power wake lock state with the values provided in 'wakeLockPlayStates'
The configuration depends on the application, device and version used.
## Record/Send input events
-As the execution of key events takes a while, you can use input events as an alternative way to control your device.
+As the execution of key events takes a while, you can use input events as an alternative way to control your device.
They are pretty device specific, so you should use the record-input and recorded-input channels to store/send those events.
An example of what you can do:
-* You can send the command `UP` to the `record-input` channel the binding will then capture the events you send through your remote for the defined recordDuration config for the thing, so press once the UP key on your remote and wait a while.
-* Now that you have recorded your input, you can send the `UP` command to the `recorded-input` event and it will send the recorded event to the android device.
+- You can send the command `UP` to the `record-input` channel the binding will then capture the events you send through your remote for the defined recordDuration config for the thing, so press once the UP key on your remote and wait a while.
+- Now that you have recorded your input, you can send the `UP` command to the `recorded-input` event and it will send the recorded event to the android device.
Please note that events could fail if the input method is removed, for example it could fail if you clone the events of a bluetooth controller and the remote goes offline. This is happening for me when recording the Fire TV remote events but not for my Xiaomi TV which also has a bt remote controller.
| wake-lock | Number | Power wake lock value |
| screen-state | Switch | Screen power state |
-#### Start Intent
+### Start Intent
This channel allows to invoke the 'am start' command, the syntax for it is:
<package/activity>||<<arg name>> <arg value>||...
This is a sample:
com.netflix.ninja/.MainActivity||<a>android.intent.action.VIEW||<d>netflix://title/80025384||<f>0x10000020||<es>amzn_deeplink_data 80025384
-Not all the (arguments)[https://developer.android.com/studio/command-line/adb#IntentSpec] are supported. Please open an issue or pull request if you need more.
-
-#### Available key-event values:
-
-* KEYCODE_0
-* KEYCODE_1
-* KEYCODE_11
-* KEYCODE_12
-* KEYCODE_2
-* KEYCODE_3
-* KEYCODE_3D_MODE
-* KEYCODE_4
-* KEYCODE_5
-* KEYCODE_6
-* KEYCODE_7
-* KEYCODE_8
-* KEYCODE_9
-* KEYCODE_A
-* KEYCODE_ALL_APPS
-* KEYCODE_ALT_LEFT
-* KEYCODE_ALT_RIGHT
-* KEYCODE_APOSTROPHE
-* KEYCODE_APP_SWITCH
-* KEYCODE_ASSIST
-* KEYCODE_AT
-* KEYCODE_AVR_INPUT
-* KEYCODE_AVR_POWER
-* KEYCODE_B
-* KEYCODE_BACK
-* KEYCODE_BACKSLASH
-* KEYCODE_BOOKMARK
-* KEYCODE_BREAK
-* KEYCODE_BRIGHTNESS_DOWN
-* KEYCODE_BRIGHTNESS_UP
-* KEYCODE_BUTTON_1
-* KEYCODE_BUTTON_10
-* KEYCODE_BUTTON_11
-* KEYCODE_BUTTON_12
-* KEYCODE_BUTTON_13
-* KEYCODE_BUTTON_14
-* KEYCODE_BUTTON_15
-* KEYCODE_BUTTON_16
-* KEYCODE_BUTTON_2
-* KEYCODE_BUTTON_3
-* KEYCODE_BUTTON_4
-* KEYCODE_BUTTON_5
-* KEYCODE_BUTTON_6
-* KEYCODE_BUTTON_7
-* KEYCODE_BUTTON_8
-* KEYCODE_BUTTON_9
-* KEYCODE_BUTTON_A
-* KEYCODE_BUTTON_B
-* KEYCODE_BUTTON_C
-* KEYCODE_BUTTON_L1
-* KEYCODE_BUTTON_L2
-* KEYCODE_BUTTON_MODE
-* KEYCODE_BUTTON_R1
-* KEYCODE_BUTTON_R2
-* KEYCODE_BUTTON_SELECT
-* KEYCODE_BUTTON_START
-* KEYCODE_BUTTON_THUMBL
-* KEYCODE_BUTTON_THUMBR
-* KEYCODE_BUTTON_X
-* KEYCODE_BUTTON_Y
-* KEYCODE_BUTTON_Z
-* KEYCODE_C
-* KEYCODE_CALCULATOR
-* KEYCODE_CALENDAR
-* KEYCODE_CALL
-* KEYCODE_CAMERA
-* KEYCODE_CAPS_LOCK
-* KEYCODE_CAPTIONS
-* KEYCODE_CHANNEL_DOWN
-* KEYCODE_CHANNEL_UP
-* KEYCODE_CLEAR
-* KEYCODE_COMMA
-* KEYCODE_CONTACTS
-* KEYCODE_COPY
-* KEYCODE_CTRL_LEFT
-* KEYCODE_CTRL_RIGHT
-* KEYCODE_CUT
-* KEYCODE_D
-* KEYCODE_DEL
-* KEYCODE_DPAD_CENTER
-* KEYCODE_DPAD_DOWN
-* KEYCODE_DPAD_DOWN_LEFT
-* KEYCODE_DPAD_DOWN_RIGHT
-* KEYCODE_DPAD_LEFT
-* KEYCODE_DPAD_RIGHT
-* KEYCODE_DPAD_UP
-* KEYCODE_DPAD_UP_LEFT
-* KEYCODE_DPAD_UP_RIGHT
-* KEYCODE_DVR
-* KEYCODE_E
-* KEYCODE_EISU
-* KEYCODE_ENDCALL
-* KEYCODE_ENTER
-* KEYCODE_ENVELOPE
-* KEYCODE_EQUALS
-* KEYCODE_ESCAPE
-* KEYCODE_EXPLORER
-* KEYCODE_F
-* KEYCODE_F1
-* KEYCODE_F10
-* KEYCODE_F11
-* KEYCODE_F12
-* KEYCODE_F2
-* KEYCODE_F3
-* KEYCODE_F4
-* KEYCODE_F5
-* KEYCODE_F6
-* KEYCODE_F7
-* KEYCODE_F8
-* KEYCODE_F9
-* KEYCODE_FOCUS
-* KEYCODE_FORWARD
-* KEYCODE_FORWARD_DEL
-* KEYCODE_FUNCTION
-* KEYCODE_G
-* KEYCODE_GRAVE
-* KEYCODE_GUIDE
-* KEYCODE_H
-* KEYCODE_HEADSETHOOK
-* KEYCODE_HELP
-* KEYCODE_HENKAN
-* KEYCODE_HOME
-* KEYCODE_I
-* KEYCODE_INFO
-* KEYCODE_INSERT
-* KEYCODE_J
-* KEYCODE_K
-* KEYCODE_KANA
-* KEYCODE_KATAKANA_HIRAGANA
-* KEYCODE_L
-* KEYCODE_LANGUAGE_SWITCH
-* KEYCODE_LAST_CHANNEL
-* KEYCODE_LEFT_BRACKET
-* KEYCODE_M
-* KEYCODE_MANNER_MODE
-* KEYCODE_MEDIA_AUDIO_TRACK
-* KEYCODE_MEDIA_CLOSE
-* KEYCODE_MEDIA_EJECT
-* KEYCODE_MEDIA_FAST_FORWARD
-* KEYCODE_MEDIA_NEXT
-* KEYCODE_MEDIA_PAUSE
-* KEYCODE_MEDIA_PLAY
-* KEYCODE_MEDIA_PLAY_PAUSE
-* KEYCODE_MEDIA_PREVIOUS
-* KEYCODE_MEDIA_RECORD
-* KEYCODE_MEDIA_REWIND
-* KEYCODE_MEDIA_SKIP_BACKWARD
-* KEYCODE_MEDIA_SKIP_FORWARD
-* KEYCODE_MEDIA_STEP_BACKWARD
-* KEYCODE_MEDIA_STEP_FORWARD
-* KEYCODE_MEDIA_STOP
-* KEYCODE_MEDIA_TOP_MENU
-* KEYCODE_MENU
-* KEYCODE_META_LEFT
-* KEYCODE_META_RIGHT
-* KEYCODE_MINUS
-* KEYCODE_MOVE_END
-* KEYCODE_MOVE_HOME
-* KEYCODE_MUHENKAN
-* KEYCODE_MUSIC
-* KEYCODE_MUTE
-* KEYCODE_N
-* KEYCODE_NAVIGATE_IN
-* KEYCODE_NAVIGATE_NEXT
-* KEYCODE_NAVIGATE_OUT
-* KEYCODE_NAVIGATE_PREVIOUS
-* KEYCODE_NOTIFICATION
-* KEYCODE_NUM
-* KEYCODE_NUMPAD_0
-* KEYCODE_NUMPAD_1
-* KEYCODE_NUMPAD_2
-* KEYCODE_NUMPAD_3
-* KEYCODE_NUMPAD_4
-* KEYCODE_NUMPAD_5
-* KEYCODE_NUMPAD_6
-* KEYCODE_NUMPAD_7
-* KEYCODE_NUMPAD_8
-* KEYCODE_NUMPAD_9
-* KEYCODE_NUMPAD_ADD
-* KEYCODE_NUMPAD_COMMA
-* KEYCODE_NUMPAD_DIVIDE
-* KEYCODE_NUMPAD_DOT
-* KEYCODE_NUMPAD_ENTER
-* KEYCODE_NUMPAD_EQUALS
-* KEYCODE_NUMPAD_LEFT_PAREN
-* KEYCODE_NUMPAD_MULTIPLY
-* KEYCODE_NUMPAD_RIGHT_PAREN
-* KEYCODE_NUMPAD_SUBTRACT
-* KEYCODE_NUM_LOCK
-* KEYCODE_O
-* KEYCODE_P
-* KEYCODE_PAGE_DOWN
-* KEYCODE_PAGE_UP
-* KEYCODE_PAIRING
-* KEYCODE_PASTE
-* KEYCODE_PERIOD
-* KEYCODE_PICTSYMBOLS
-* KEYCODE_PLUS
-* KEYCODE_POUND
-* KEYCODE_POWER
-* KEYCODE_PROFILE_SWITCH
-* KEYCODE_PROG_BLUE
-* KEYCODE_PROG_GREEN
-* KEYCODE_PROG_RED
-* KEYCODE_PROG_YELLOW
-* KEYCODE_Q
-* KEYCODE_R
-* KEYCODE_REFRESH
-* KEYCODE_RIGHT_BRACKET
-* KEYCODE_RO
-* KEYCODE_S
-* KEYCODE_SCROLL_LOCK
-* KEYCODE_SEARCH
-* KEYCODE_SEMICOLON
-* KEYCODE_SETTINGS
-* KEYCODE_SHIFT_LEFT
-* KEYCODE_SHIFT_RIGHT
-* KEYCODE_SLASH
-* KEYCODE_SLEEP
-* KEYCODE_SOFT_LEFT
-* KEYCODE_SOFT_RIGHT
-* KEYCODE_SOFT_SLEEP
-* KEYCODE_SPACE
-* KEYCODE_STAR
-* KEYCODE_STB_INPUT
-* KEYCODE_STB_POWER
-* KEYCODE_STEM_1
-* KEYCODE_STEM_2
-* KEYCODE_STEM_3
-* KEYCODE_STEM_PRIMARY
-* KEYCODE_SWITCH_CHARSET
-* KEYCODE_SYM
-* KEYCODE_SYSRQ
-* KEYCODE_SYSTEM_NAVIGATION_DOWN
-* KEYCODE_SYSTEM_NAVIGATION_LEFT
-* KEYCODE_SYSTEM_NAVIGATION_RIGHT
-* KEYCODE_SYSTEM_NAVIGATION_UP
-* KEYCODE_T
-* KEYCODE_TAB
-* KEYCODE_THUMBS_DOWN
-* KEYCODE_THUMBS_UP
-* KEYCODE_TV
-* KEYCODE_TV_ANTENNA_CABLE
-* KEYCODE_TV_AUDIO_DESCRIPTION
-* KEYCODE_TV_AUDIO_DESCRIPTION_MIX_DOWN
-* KEYCODE_TV_AUDIO_DESCRIPTION_MIX_UP
-* KEYCODE_TV_CONTENTS_MENU
-* KEYCODE_TV_DATA_SERVICE
-* KEYCODE_TV_INPUT
-* KEYCODE_TV_INPUT_COMPONENT_1
-* KEYCODE_TV_INPUT_COMPONENT_2
-* KEYCODE_TV_INPUT_COMPOSITE_1
-* KEYCODE_TV_INPUT_COMPOSITE_2
-* KEYCODE_TV_INPUT_HDMI_1
-* KEYCODE_TV_INPUT_HDMI_2
-* KEYCODE_TV_INPUT_HDMI_3
-* KEYCODE_TV_INPUT_HDMI_4
-* KEYCODE_TV_INPUT_VGA_1
-* KEYCODE_TV_MEDIA_CONTEXT_MENU
-* KEYCODE_TV_NETWORK
-* KEYCODE_TV_NUMBER_ENTRY
-* KEYCODE_TV_POWER
-* KEYCODE_TV_RADIO_SERVICE
-* KEYCODE_TV_SATELLITE
-* KEYCODE_TV_SATELLITE_BS
-* KEYCODE_TV_SATELLITE_CS
-* KEYCODE_TV_SATELLITE_SERVICE
-* KEYCODE_TV_TELETEXT
-* KEYCODE_TV_TERRESTRIAL_ANALOG
-* KEYCODE_TV_TERRESTRIAL_DIGITAL
-* KEYCODE_TV_TIMER_PROGRAMMING
-* KEYCODE_TV_ZOOM_MODE
-* KEYCODE_U
-* KEYCODE_UNKNOWN
-* KEYCODE_V
-* KEYCODE_VOICE_ASSIST
-* KEYCODE_VOLUME_DOWN
-* KEYCODE_VOLUME_MUTE
-* KEYCODE_VOLUME_UP
-* KEYCODE_W
-* KEYCODE_WAKEUP
-* KEYCODE_WINDOW
-* KEYCODE_X
-* KEYCODE_Y
-* KEYCODE_YEN
-* KEYCODE_Z
-* KEYCODE_ZENKAKU_HANKAKU
-* KEYCODE_ZOOM_IN
-* KEYCODE_ZOOM_OUT
+Not all the [arguments](https://developer.android.com/studio/command-line/adb#IntentSpec) are supported. Please open an issue or pull request if you need more.
+
+### Available key-event values:
+
+- KEYCODE_0
+- KEYCODE_1
+- KEYCODE_11
+- KEYCODE_12
+- KEYCODE_2
+- KEYCODE_3
+- KEYCODE_3D_MODE
+- KEYCODE_4
+- KEYCODE_5
+- KEYCODE_6
+- KEYCODE_7
+- KEYCODE_8
+- KEYCODE_9
+- KEYCODE_A
+- KEYCODE_ALL_APPS
+- KEYCODE_ALT_LEFT
+- KEYCODE_ALT_RIGHT
+- KEYCODE_APOSTROPHE
+- KEYCODE_APP_SWITCH
+- KEYCODE_ASSIST
+- KEYCODE_AT
+- KEYCODE_AVR_INPUT
+- KEYCODE_AVR_POWER
+- KEYCODE_B
+- KEYCODE_BACK
+- KEYCODE_BACKSLASH
+- KEYCODE_BOOKMARK
+- KEYCODE_BREAK
+- KEYCODE_BRIGHTNESS_DOWN
+- KEYCODE_BRIGHTNESS_UP
+- KEYCODE_BUTTON_1
+- KEYCODE_BUTTON_10
+- KEYCODE_BUTTON_11
+- KEYCODE_BUTTON_12
+- KEYCODE_BUTTON_13
+- KEYCODE_BUTTON_14
+- KEYCODE_BUTTON_15
+- KEYCODE_BUTTON_16
+- KEYCODE_BUTTON_2
+- KEYCODE_BUTTON_3
+- KEYCODE_BUTTON_4
+- KEYCODE_BUTTON_5
+- KEYCODE_BUTTON_6
+- KEYCODE_BUTTON_7
+- KEYCODE_BUTTON_8
+- KEYCODE_BUTTON_9
+- KEYCODE_BUTTON_A
+- KEYCODE_BUTTON_B
+- KEYCODE_BUTTON_C
+- KEYCODE_BUTTON_L1
+- KEYCODE_BUTTON_L2
+- KEYCODE_BUTTON_MODE
+- KEYCODE_BUTTON_R1
+- KEYCODE_BUTTON_R2
+- KEYCODE_BUTTON_SELECT
+- KEYCODE_BUTTON_START
+- KEYCODE_BUTTON_THUMBL
+- KEYCODE_BUTTON_THUMBR
+- KEYCODE_BUTTON_X
+- KEYCODE_BUTTON_Y
+- KEYCODE_BUTTON_Z
+- KEYCODE_C
+- KEYCODE_CALCULATOR
+- KEYCODE_CALENDAR
+- KEYCODE_CALL
+- KEYCODE_CAMERA
+- KEYCODE_CAPS_LOCK
+- KEYCODE_CAPTIONS
+- KEYCODE_CHANNEL_DOWN
+- KEYCODE_CHANNEL_UP
+- KEYCODE_CLEAR
+- KEYCODE_COMMA
+- KEYCODE_CONTACTS
+- KEYCODE_COPY
+- KEYCODE_CTRL_LEFT
+- KEYCODE_CTRL_RIGHT
+- KEYCODE_CUT
+- KEYCODE_D
+- KEYCODE_DEL
+- KEYCODE_DPAD_CENTER
+- KEYCODE_DPAD_DOWN
+- KEYCODE_DPAD_DOWN_LEFT
+- KEYCODE_DPAD_DOWN_RIGHT
+- KEYCODE_DPAD_LEFT
+- KEYCODE_DPAD_RIGHT
+- KEYCODE_DPAD_UP
+- KEYCODE_DPAD_UP_LEFT
+- KEYCODE_DPAD_UP_RIGHT
+- KEYCODE_DVR
+- KEYCODE_E
+- KEYCODE_EISU
+- KEYCODE_ENDCALL
+- KEYCODE_ENTER
+- KEYCODE_ENVELOPE
+- KEYCODE_EQUALS
+- KEYCODE_ESCAPE
+- KEYCODE_EXPLORER
+- KEYCODE_F
+- KEYCODE_F1
+- KEYCODE_F10
+- KEYCODE_F11
+- KEYCODE_F12
+- KEYCODE_F2
+- KEYCODE_F3
+- KEYCODE_F4
+- KEYCODE_F5
+- KEYCODE_F6
+- KEYCODE_F7
+- KEYCODE_F8
+- KEYCODE_F9
+- KEYCODE_FOCUS
+- KEYCODE_FORWARD
+- KEYCODE_FORWARD_DEL
+- KEYCODE_FUNCTION
+- KEYCODE_G
+- KEYCODE_GRAVE
+- KEYCODE_GUIDE
+- KEYCODE_H
+- KEYCODE_HEADSETHOOK
+- KEYCODE_HELP
+- KEYCODE_HENKAN
+- KEYCODE_HOME
+- KEYCODE_I
+- KEYCODE_INFO
+- KEYCODE_INSERT
+- KEYCODE_J
+- KEYCODE_K
+- KEYCODE_KANA
+- KEYCODE_KATAKANA_HIRAGANA
+- KEYCODE_L
+- KEYCODE_LANGUAGE_SWITCH
+- KEYCODE_LAST_CHANNEL
+- KEYCODE_LEFT_BRACKET
+- KEYCODE_M
+- KEYCODE_MANNER_MODE
+- KEYCODE_MEDIA_AUDIO_TRACK
+- KEYCODE_MEDIA_CLOSE
+- KEYCODE_MEDIA_EJECT
+- KEYCODE_MEDIA_FAST_FORWARD
+- KEYCODE_MEDIA_NEXT
+- KEYCODE_MEDIA_PAUSE
+- KEYCODE_MEDIA_PLAY
+- KEYCODE_MEDIA_PLAY_PAUSE
+- KEYCODE_MEDIA_PREVIOUS
+- KEYCODE_MEDIA_RECORD
+- KEYCODE_MEDIA_REWIND
+- KEYCODE_MEDIA_SKIP_BACKWARD
+- KEYCODE_MEDIA_SKIP_FORWARD
+- KEYCODE_MEDIA_STEP_BACKWARD
+- KEYCODE_MEDIA_STEP_FORWARD
+- KEYCODE_MEDIA_STOP
+- KEYCODE_MEDIA_TOP_MENU
+- KEYCODE_MENU
+- KEYCODE_META_LEFT
+- KEYCODE_META_RIGHT
+- KEYCODE_MINUS
+- KEYCODE_MOVE_END
+- KEYCODE_MOVE_HOME
+- KEYCODE_MUHENKAN
+- KEYCODE_MUSIC
+- KEYCODE_MUTE
+- KEYCODE_N
+- KEYCODE_NAVIGATE_IN
+- KEYCODE_NAVIGATE_NEXT
+- KEYCODE_NAVIGATE_OUT
+- KEYCODE_NAVIGATE_PREVIOUS
+- KEYCODE_NOTIFICATION
+- KEYCODE_NUM
+- KEYCODE_NUMPAD_0
+- KEYCODE_NUMPAD_1
+- KEYCODE_NUMPAD_2
+- KEYCODE_NUMPAD_3
+- KEYCODE_NUMPAD_4
+- KEYCODE_NUMPAD_5
+- KEYCODE_NUMPAD_6
+- KEYCODE_NUMPAD_7
+- KEYCODE_NUMPAD_8
+- KEYCODE_NUMPAD_9
+- KEYCODE_NUMPAD_ADD
+- KEYCODE_NUMPAD_COMMA
+- KEYCODE_NUMPAD_DIVIDE
+- KEYCODE_NUMPAD_DOT
+- KEYCODE_NUMPAD_ENTER
+- KEYCODE_NUMPAD_EQUALS
+- KEYCODE_NUMPAD_LEFT_PAREN
+- KEYCODE_NUMPAD_MULTIPLY
+- KEYCODE_NUMPAD_RIGHT_PAREN
+- KEYCODE_NUMPAD_SUBTRACT
+- KEYCODE_NUM_LOCK
+- KEYCODE_O
+- KEYCODE_P
+- KEYCODE_PAGE_DOWN
+- KEYCODE_PAGE_UP
+- KEYCODE_PAIRING
+- KEYCODE_PASTE
+- KEYCODE_PERIOD
+- KEYCODE_PICTSYMBOLS
+- KEYCODE_PLUS
+- KEYCODE_POUND
+- KEYCODE_POWER
+- KEYCODE_PROFILE_SWITCH
+- KEYCODE_PROG_BLUE
+- KEYCODE_PROG_GREEN
+- KEYCODE_PROG_RED
+- KEYCODE_PROG_YELLOW
+- KEYCODE_Q
+- KEYCODE_R
+- KEYCODE_REFRESH
+- KEYCODE_RIGHT_BRACKET
+- KEYCODE_RO
+- KEYCODE_S
+- KEYCODE_SCROLL_LOCK
+- KEYCODE_SEARCH
+- KEYCODE_SEMICOLON
+- KEYCODE_SETTINGS
+- KEYCODE_SHIFT_LEFT
+- KEYCODE_SHIFT_RIGHT
+- KEYCODE_SLASH
+- KEYCODE_SLEEP
+- KEYCODE_SOFT_LEFT
+- KEYCODE_SOFT_RIGHT
+- KEYCODE_SOFT_SLEEP
+- KEYCODE_SPACE
+- KEYCODE_STAR
+- KEYCODE_STB_INPUT
+- KEYCODE_STB_POWER
+- KEYCODE_STEM_1
+- KEYCODE_STEM_2
+- KEYCODE_STEM_3
+- KEYCODE_STEM_PRIMARY
+- KEYCODE_SWITCH_CHARSET
+- KEYCODE_SYM
+- KEYCODE_SYSRQ
+- KEYCODE_SYSTEM_NAVIGATION_DOWN
+- KEYCODE_SYSTEM_NAVIGATION_LEFT
+- KEYCODE_SYSTEM_NAVIGATION_RIGHT
+- KEYCODE_SYSTEM_NAVIGATION_UP
+- KEYCODE_T
+- KEYCODE_TAB
+- KEYCODE_THUMBS_DOWN
+- KEYCODE_THUMBS_UP
+- KEYCODE_TV
+- KEYCODE_TV_ANTENNA_CABLE
+- KEYCODE_TV_AUDIO_DESCRIPTION
+- KEYCODE_TV_AUDIO_DESCRIPTION_MIX_DOWN
+- KEYCODE_TV_AUDIO_DESCRIPTION_MIX_UP
+- KEYCODE_TV_CONTENTS_MENU
+- KEYCODE_TV_DATA_SERVICE
+- KEYCODE_TV_INPUT
+- KEYCODE_TV_INPUT_COMPONENT_1
+- KEYCODE_TV_INPUT_COMPONENT_2
+- KEYCODE_TV_INPUT_COMPOSITE_1
+- KEYCODE_TV_INPUT_COMPOSITE_2
+- KEYCODE_TV_INPUT_HDMI_1
+- KEYCODE_TV_INPUT_HDMI_2
+- KEYCODE_TV_INPUT_HDMI_3
+- KEYCODE_TV_INPUT_HDMI_4
+- KEYCODE_TV_INPUT_VGA_1
+- KEYCODE_TV_MEDIA_CONTEXT_MENU
+- KEYCODE_TV_NETWORK
+- KEYCODE_TV_NUMBER_ENTRY
+- KEYCODE_TV_POWER
+- KEYCODE_TV_RADIO_SERVICE
+- KEYCODE_TV_SATELLITE
+- KEYCODE_TV_SATELLITE_BS
+- KEYCODE_TV_SATELLITE_CS
+- KEYCODE_TV_SATELLITE_SERVICE
+- KEYCODE_TV_TELETEXT
+- KEYCODE_TV_TERRESTRIAL_ANALOG
+- KEYCODE_TV_TERRESTRIAL_DIGITAL
+- KEYCODE_TV_TIMER_PROGRAMMING
+- KEYCODE_TV_ZOOM_MODE
+- KEYCODE_U
+- KEYCODE_UNKNOWN
+- KEYCODE_V
+- KEYCODE_VOICE_ASSIST
+- KEYCODE_VOLUME_DOWN
+- KEYCODE_VOLUME_MUTE
+- KEYCODE_VOLUME_UP
+- KEYCODE_W
+- KEYCODE_WAKEUP
+- KEYCODE_WINDOW
+- KEYCODE_X
+- KEYCODE_Y
+- KEYCODE_YEN
+- KEYCODE_Z
+- KEYCODE_ZENKAKU_HANKAKU
+- KEYCODE_ZOOM_IN
+- KEYCODE_ZOOM_OUT
## Full Example
### Sample Thing
-```
+```java
Thing androiddebugbridge:android:xxxxxxxxxxxx "xxxxxxxxxxxx" [ ip="192.168.1.10", port=5555, refreshTime=30 ]
```
### Sample Items
-```
+```java
Group androidDevice "Android TV"
String device_SendKey "Send Key" (androidDevice) { channel="androiddebugbridge:android:xxxxxxxxxxxx:key-event" }
String device_CurrentApp "Current App" (androidDevice) { channel="androiddebugbridge:android:xxxxxxxxxxxx:current-package" }
NET-PwrCtrl devices are power sockets / relays that can be configured via browser but they can also be controlled over the network, e.g. with an Android or iPhone app - and also with openHAB via this binding.
Some NET-PwrCtrl devices also have 8 I/O ports which can either be used to directly switch the sockets / relays, or they can be used as general input / output switches in openHAB.
-
## Supported Things
There are three kinds of devices ([overview on manufacturer's homepage](https://en.anel.eu/?src=/produkte/produkte.htm)):
Thing type IDs:
-* *home*: The smallest device, the _HOME_, is the only one with only three power sockets and only available in Germany.
-* *simple-firmware*: The _PRO_ and _REDUNDANT_ have eight power sockets and a similar (simplified) firmware as the _HOME_.
-* *advanced-firmware*: All others (_ADV_, _IO_, and the different _HUT_ variants) have eight power sockets / relays, eight IO ports, and an advanced firmware.
+- _home_: The smallest device, the _HOME_, is the only one with only three power sockets and only available in Germany.
+- _simple-firmware_: The _PRO_ and _REDUNDANT_ have eight power sockets and a similar (simplified) firmware as the _HOME_.
+- _advanced-firmware_: All others (_ADV_, _IO_, and the different _HUT_ variants) have eight power sockets / relays, eight IO ports, and an advanced firmware.
An [additional sensor](https://en.anel.eu/?src=/produkte/sensor_1/sensor_1.htm) may be used for monitoring temperature, humidity, and brightness.
The sensor can be attached to a _HUT_ device via an Ethernet cable (max length is 50m).
-
## Discovery
Devices can be discovered automatically if their UDP ports are configured as follows:
-* 75 / 77 (default)
-* 750 / 770
-* 7500 / 7700
-* 7750 / 7770
+- 75 / 77 (default)
+- 750 / 770
+- 7500 / 7700
+- 7750 / 7770
If a device is found for a specific port (excluding the default port), the subsequent port is also scanned, e.g. 7500/7700 → 7501/7701 → 7502/7702 → etc.
Depending on the network switch and router devices, discovery may or may not work on wireless networks.
It should work reliably though on local wired networks.
-
## Thing Configuration
Each Thing requires the following configuration parameters.
Possible entries in your thing file could be (thing types _home_, _simple-firmware_, and _advanced-firmware_ are explained above in _Supported Things_):
-```
+```java
anel:home:mydevice1 [hostname="192.168.0.101", udpSendPort=7500, udpReceivePort=7700, user="user7", password="anel"]
anel:simple-firmware:mydevice2 [hostname="192.168.0.102", udpSendPort=7501, udpReceivePort=7701, user="user7", password="anel"]
anel:advanced-firmware:mydevice3 [hostname="192.168.0.103", udpSendPort=7502, udpReceivePort=7702, user="user7", password="anel"]
anel:advanced-firmware:mydevice4 [hostname="192.168.0.104", udpSendPort=7503, udpReceivePort=7703, user="user7", password="anel"]
```
-
## Channels
Depending on the thing type, the following channels are available.
\* Relay / socket state is read-only if it is locked; otherwise it is changeable.<br/>
\** IO port state is read-only if its mode is _input_, it is changeable if its mode is _output_.
-
## Full Example
`.things` file:
-```
+```java
Thing anel:advanced-firmware:anel1 "Anel1" [hostname="192.168.0.100", udpSendPort=7500, udpReceivePort=7700, user="user7", password="anel"]
```
`.items` file:
-```
+```java
// device properties
String anel1name "Anel1 Name" {channel="anel:advanced-firmware:anel1:prop#name"}
Number:Temperature anel1temperature "Anel1 Temperature" {channel="anel:advanced-firmware:anel1:prop#temperature"}
`.sitemap` file:
-```
+```perl
sitemap anel label="Anel NET-PwrCtrl" {
Frame label="Device and Sensor" {
Text item=anel1name label="Anel1 Name"
`.rules` file:
-```
+```java
rule "doorbell only at daytime"
when Item anel1io6state changed then
if (now.getHoursOfDay >= 6 && now.getHoursOfDay <= 22) {
end
```
-
## Reference Documentation
The UDP protocol of Anel devices is explained [here](https://forum.anel.eu/viewtopic.php?f=16&t=207).
-
# Astro Binding
-The Astro binding is used for calculating
+The Astro binding is used for calculating
-* many DateTime and positional values for sun and moon.
-* Radiation levels (direct, diffuse and total) of the sun during the day
+- many DateTime and positional values for sun and moon.
+- Radiation levels (direct, diffuse and total) of the sun during the day
## Supported Things
## Thing Configuration
-All Things require the parameter `geolocation` (as `<latitude>,<longitude>[,<altitude in m>]`) for which the calculation is done.
+All Things require the parameter `geolocation` (as `<latitude>,<longitude>[,<altitude in m>]`) for which the calculation is done.
The altitude segment is optional and sharpens results provided by the Radiation group.
Optionally, a refresh `interval` (in seconds) can be defined to also calculate positional data like azimuth and elevation.
## Channels
-* **thing** `sun`
- * **group** `rise, set, noon, night, morningNight, astroDawn, nauticDawn, civilDawn, astroDusk, nauticDusk, civilDusk, eveningNight, daylight`
- * **channel**
- * `start, end` (DateTime)
- * `duration` (Number:Time)
- * **group** `position`
- * **channel**
- * `azimuth, elevation` (Number:Angle)
- * `shadeLength` (Number)
- * **group** `radiation`
- * **channel**
- * `direct, diffuse, total` (Number:Intensity)
- * **group** `zodiac`
- * **channel**
- * `start, end` (DateTime)
- * `sign` (String), values: `ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES`
- * **group** `season`
- * **channel**:
- * `spring, summer, autumn, winter` (DateTime)
- * `name`,`nextName` (String), values `SPRING, SUMMER, AUTUMN, WINTER`
- * `timeLeft` (Number:Time)
- * **group** `eclipse`
- * **channel**:
- * `total, partial, ring` (DateTime)
- * `totalElevation, partialElevation, ringElevation` (Number:Angle)
- * **group** `phase`
- * **channel**
- * `name` (String), values: `SUN_RISE, ASTRO_DAWN, NAUTIC_DAWN, CIVIL_DAWN, CIVIL_DUSK, NAUTIC_DUSK, ASTRO_DUSK, SUN_SET, DAYLIGHT, NIGHT`
-* **thing** `moon`
- * **group** `rise, set`
- * **channel**
- * `start, end` (DateTime)
- * **group** `phase`
- * **channel**:
- * `firstQuarter, thirdQuarter, full, new` (DateTime)
- * `age` (Number:Time)
- * `ageDegree` (Number:Angle)
- * `agePercent, illumination` (Number:Dimensionless)
- * `name` (String), values: `NEW, WAXING_CRESCENT, FIRST_QUARTER, WAXING_GIBBOUS, FULL, WANING_GIBBOUS, THIRD_QUARTER, WANING_CRESCENT`
- * **group** `eclipse`
- * **channel**:
- * `total, partial` (DateTime)
- * `totalElevation, partialElevation` (Number:Angle)
- * **group** `distance`
- * **channel**:
- * `date` (DateTime)
- * `distance` (Number:Length)
- * **group** `perigee`
- * **channel**:
- * `date` (DateTime),
- * `distance` (Number:Length)
- * **group** `apogee`
- * **channel**:
- * `date` (DateTime)
- * `distance` (Number:Length)
- * **group** `zodiac`
- * **channel**
- * `sign` (String), values: `ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES`
- * **group** `position`
- * **channel**
- * `azimuth, elevation` (Number:Angle)
+- **thing** `sun`
+ - **group** `rise, set, noon, night, morningNight, astroDawn, nauticDawn, civilDawn, astroDusk, nauticDusk, civilDusk, eveningNight, daylight`
+ - **channel**
+ - `start, end` (DateTime)
+ - `duration` (Number:Time)
+ - **group** `position`
+ - **channel**
+ - `azimuth, elevation` (Number:Angle)
+ - `shadeLength` (Number)
+ - **group** `radiation`
+ - **channel**
+ - `direct, diffuse, total` (Number:Intensity)
+ - **group** `zodiac`
+ - **channel**
+ - `start, end` (DateTime)
+ - `sign` (String), values: `ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES`
+ - **group** `season`
+ - **channel**:
+ - `spring, summer, autumn, winter` (DateTime)
+ - `name`,`nextName` (String), values `SPRING, SUMMER, AUTUMN, WINTER`
+ - `timeLeft` (Number:Time)
+ - **group** `eclipse`
+ - **channel**:
+ - `total, partial, ring` (DateTime)
+ - `totalElevation, partialElevation, ringElevation` (Number:Angle)
+ - **group** `phase`
+ - **channel**
+ - `name` (String), values: `SUN_RISE, ASTRO_DAWN, NAUTIC_DAWN, CIVIL_DAWN, CIVIL_DUSK, NAUTIC_DUSK, ASTRO_DUSK, SUN_SET, DAYLIGHT, NIGHT`
+- **thing** `moon`
+ - **group** `rise, set`
+ - **channel**
+ - `start, end` (DateTime)
+ - **group** `phase`
+ - **channel**:
+ - `firstQuarter, thirdQuarter, full, new` (DateTime)
+ - `age` (Number:Time)
+ - `ageDegree` (Number:Angle)
+ - `agePercent, illumination` (Number:Dimensionless)
+ - `name` (String), values: `NEW, WAXING_CRESCENT, FIRST_QUARTER, WAXING_GIBBOUS, FULL, WANING_GIBBOUS, THIRD_QUARTER, WANING_CRESCENT`
+ - **group** `eclipse`
+ - **channel**:
+ - `total, partial` (DateTime)
+ - `totalElevation, partialElevation` (Number:Angle)
+ - **group** `distance`
+ - **channel**:
+ - `date` (DateTime)
+ - `distance` (Number:Length)
+ - **group** `perigee`
+ - **channel**:
+ - `date` (DateTime),
+ - `distance` (Number:Length)
+ - **group** `apogee`
+ - **channel**:
+ - `date` (DateTime)
+ - `distance` (Number:Length)
+ - **group** `zodiac`
+ - **channel**
+ - `sign` (String), values: `ARIES, TAURUS, GEMINI, CANCER, LEO, VIRGO, LIBRA, SCORPIO, SAGITTARIUS, CAPRICORN, AQUARIUS, PISCES`
+ - **group** `position`
+ - **channel**
+ - `azimuth, elevation` (Number:Angle)
### Trigger Channels
-* **thing** `sun`
- * **group** `rise, set, noon, night, morningNight, astroDawn, nauticDawn, civilDawn, astroDusk, nauticDusk, civilDusk, eveningNight, daylight`
- * **event** `START, END`
- * **group** `eclipse`
- * **event**: `TOTAL, PARTIAL, RING`
-* **thing** `moon`
- * **group** `rise`
- * **event** `START`
- * **group** `set`
- * **event** `END`
- * **group** `phase`
- * **event**: `FIRST_QUARTER, THIRD_QUARTER, FULL, NEW`
- * **group** `eclipse`
- * **event**: `TOTAL, PARTIAL`
- * **group** `perigee`
- * **event**: `PERIGEE`
- * **group** `apogee`
- * **event**: `APOGEE`
+- **thing** `sun`
+ - **group** `rise, set, noon, night, morningNight, astroDawn, nauticDawn, civilDawn, astroDusk, nauticDusk, civilDusk, eveningNight, daylight`
+ - **event** `START, END`
+ - **group** `eclipse`
+ - **event**: `TOTAL, PARTIAL, RING`
+- **thing** `moon`
+ - **group** `rise`
+ - **event** `START`
+ - **group** `set`
+ - **event** `END`
+ - **group** `phase`
+ - **event**: `FIRST_QUARTER, THIRD_QUARTER, FULL, NEW`
+ - **group** `eclipse`
+ - **event**: `TOTAL, PARTIAL`
+ - **group** `perigee`
+ - **event**: `PERIGEE`
+ - **group** `apogee`
+ - **event**: `APOGEE`
### Channel config
Things:
-```
+```java
astro:sun:home [ geolocation="52.5200066,13.4049540,100", interval=60 ]
astro:moon:home [ geolocation="52.5200066,13.4049540", interval=60 ]
```
or optionally with an event offset
-```
+```java
astro:sun:home [ geolocation="52.5200066,13.4049540,100", interval=60 ] {
Channels:
Type rangeEvent : rise#event [
or a datetime offset
-```
+```java
astro:sun:home [ geolocation="52.5200066,13.4049540,100", interval=60 ] {
Channels:
Type start : rise#start [
or an offset and latest
-```
+```java
astro:sun:home [ geolocation="52.5200066,13.4049540,100", interval=60 ] {
Channels:
Type rangeEvent : rise#event [
Items:
-```
+```java
DateTime Sunrise_Time "Sunrise [%1$tH:%1$tM]" { channel="astro:sun:home:rise#start" }
DateTime Sunset_Time "Sunset [%1$tH:%1$tM]" { channel="astro:sun:home:set#start" }
Number:Angle Azimuth "Azimuth" { channel="astro:sun:home:position#azimuth" }
Events:
-```
+```java
rule "example trigger rule"
when
Channel 'astro:sun:home:rise#event' triggered START
Getting sunActions variable in scripts
-```
+```java
val sunActions = getActions("astro","astro:sun:local")
if(null === sunActions) {
logInfo("actions", "sunActions not found, check thing ID")
Retrieves date and time (ZonedDateTime) of the requested phase name.
Thing method only applies to Sun thing type.
-* `phaseName` (String), values: `SUN_RISE, ASTRO_DAWN, NAUTIC_DAWN, CIVIL_DAWN, CIVIL_DUSK, NAUTIC_DUSK, ASTRO_DUSK, SUN_SET, DAYLIGHT, NIGHT`. Mandatory.
+- `phaseName` (String), values: `SUN_RISE, ASTRO_DAWN, NAUTIC_DAWN, CIVIL_DAWN, CIVIL_DUSK, NAUTIC_DUSK, ASTRO_DUSK, SUN_SET, DAYLIGHT, NIGHT`. Mandatory.
-* `date` (ZonedDateTime), only the date part of this parameter will be considered - defaulted to now() if null.
+- `date` (ZonedDateTime), only the date part of this parameter will be considered - defaulted to now() if null.
-* `moment` (String), values: `START, END` - defaulted to `START` if null.
+- `moment` (String), values: `START, END` - defaulted to `START` if null.
Example :
-```
+```java
val sunEvent = "SUN_SET"
val today = ZonedDateTime.now;
val sunEventTime = sunActions.getEventTime(sunEvent,today,"START")
Retrieves the elevation (QuantityType<Angle>) of the sun at the requested instant.
Thing method applies to Sun and Moon.
-* `timeStamp` (ZonedDateTime) - defaulted to now() if null.
-
+- `timeStamp` (ZonedDateTime) - defaulted to now() if null.
### getAzimuth(timeStamp)
Retrieves the azimuth (QuantityType<Angle>) of the sun at the requested instant.
Thing method applies to Sun and Moon.
-* `timeStamp` (ZonedDateTime) - defaulted to now() if null.
+- `timeStamp` (ZonedDateTime) - defaulted to now() if null.
Example :
-```
+```java
val azimuth = sunActions.getAzimuth(sunEventTime)
val elevation = sunActions.getElevation(sunEventTime)
logInfo("AstroActions", "{} will be positioned at elevation {} - azimuth {}",sunEvent, elevation.toString,azimuth.toString)
```
-
## Tips
Do not worry if for example the "astro dawn" is undefined at your location.
# Atlona Binding
This binding integrates Atlona AT-UHD-PRO3 HdBaseT matrix switches [Atlona AT-UHD-PRO3 HdBaseT matrix switches](https://www.atlona.com) into your openHAB installation.
-The older HD model 6x6 matrix [AT-PRO3HD66M] (https://atlona.com/product/at-pro3hd66m/) is also supported.
+The older HD model 6x6 matrix [AT-PRO3HD66M](https://atlona.com/product/at-pro3hd66m/) is also supported.
## Supported Things
As of firmware 1.6.03 (rev 13), there are three issues on Atlona firmware (I have notified them on these issues):
-- clearX command does not work. The TCP/IP command "ClearX" as specified in Atlona's protocol will ALWAYS return a "Command Failed". Please avoid this channel until atlona releases a new firmware.
+- clearX command does not work. The TCP/IP command "ClearX" as specified in Atlona's protocol will ALWAYS return a "Command Failed". Please avoid this channel until atlona releases a new firmware.
-- There is no way to query what the current status is of: panellock, and irenable. This add-on simply assumes that panellock is off and irenable is on at startup.
+- There is no way to query what the current status is of: panellock, and irenable. This add-on simply assumes that panellock is off and irenable is on at startup.
-- If you make a change in the switches UI that requires a reboot (mainly changing any of the settings on the "Network" tab in the switch configuration UI), this add-on's connection will be inconsistently closed at different times.
+- If you make a change in the switches UI that requires a reboot (mainly changing any of the settings on the "Network" tab in the switch configuration UI), this add-on's connection will be inconsistently closed at different times.
The thing will go OFFLINE and then back ONLINE when the reconnect attempt is made - and then it starts all over again. Please make sure you reboot as soon as possible when the switch UI notifies you.
-- a bug in the firmware will sometimes cause memory presets to disappear after a reboot
+- a bug in the firmware will sometimes cause memory presets to disappear after a reboot
As of firmware 1.6.8 (rev 14),
Here is an example with minimal configuration parameters (using default values with no telnet login):
-```
+```java
atlona:pro3-88m:home [ ipAddress="192.168.1.30" ]
```
Here is another example with minimal configuration parameters (using default values with telnet login):
-```
+```java
atlona:pro3-88m:home [ ipAddress="192.168.1.30", userName="me", password="12345" ]
```
Here is a full configuration example:
-```
+```java
atlona:pro3-88m:home [ ipAddress="192.168.1.30", userName="me", password="12345", polling=600, ping=30, retryPolling=10 ]
```
Here is an example of items for the AT-UHD-PRO33-88M:
-```
+```java
Switch Atlona_Power "Power" { channel = "atlona:pro3-88m:home:primary#power" }
Switch Atlona_PanelLock "Panel Lock" { channel = "atlona:pro3-88m:home:primary#panellock" }
Switch Atlona_Presets "Preset Command" { channel = "atlona:pro3-88m:home:primary#presetcmd" }
### SiteMap
-```
+```perl
sitemap demo label="Main Menu" {
Frame label="Atlona" {
Text label="Device" {
### atlonainputports.map
-```
+```text
1=CableBox
2=BluRay Player
3=Roku
### atlonaoutputports.map
-```
+```text
1=Living Room
2=Master Bed
3=Kitchen
This binding supports:
-* Jandy and Pentair models
-* Read circuit, auxiliary, temperature, pump, chemistry and system values
-* Control circuit, auxiliary lighting scenes, and temperature set points
-
+- Jandy and Pentair models
+- Read circuit, auxiliary, temperature, pump, chemistry and system values
+- Control circuit, auxiliary lighting scenes, and temperature set points
## Auto Discovery
In the thing file, this looks e.g. like
-```
+```java
Thing autelis:pentair:myPool [ host="192.168.1.10", port="80", user="admin", password="admin"]
```
or
-```
+```java
Thing autelis:jandy:myPool [ host="192.168.1.10", port="80", user="admin", password="admin"]
```
All Husqvarna Automower models with "Automower Connect" should be supported. It was tested only with a Husqvarna Automower 430X and 450X.
-
## Discovery
Once the bridge is created and configured, OpenHab will automatically discover all Automowers registered on your account.
| position50 | Location | R | GPS Position 50 |
| last-position | Location | R | Last GPS Position (identical with positions#position01) |
-
## Actions
The following actions are available for `automower`things:
| park | duration (int) | Parks the automower for the given duration (minutes), overriding the schedule |
| resumeSchedule | - | Resumes the schedule for the automower |
-
## Full Example
### automower.thing
- Bridge automower:bridge:mybridge [ appKey="<your_private_application_key>", userName="<your_username>", password="<your_password>" ] {
- Thing automower myAutomower [ mowerId="<your_id_received_from_discovery>", pollingInterval=3600] {
- }
- }
-
+```java
+Bridge automower:bridge:mybridge [ appKey="<your_private_application_key>", userName="<your_username>", password="<your_password>" ] {
+ Thing automower myAutomower [ mowerId="<your_id_received_from_discovery>", pollingInterval=3600] {
+ }
+}
+```
### automower.items
- String Automower_Mode "Mode [%s]" { channel="automower:automower:mybridge:myAutomower:mode" }
- String Automower_Activity "Activity [%s]" { channel="automower:automower:mybridge:myAutomower:activity" }
- String Automower_State "State [%s]" { channel="automower:automower:mybridge:myAutomower:state" }
- DateTime Automower_Last_Update "Last Update" { channel="automower:automower:mybridge:myAutomower:last-update" }
- Number Automower_Battery "Battery [%d %%]" { channel="automower:automower:mybridge:myAutomower:battery" }
- Number Automower_Error_Code "Error Code [%d]" { channel="automower:automower:mybridge:myAutomower:error-code" }
- DateTime Automower_Error_Time "Error Time" { channel="automower:automower:mybridge:myAutomower:error-timestamp" }
- String Automower_Override_Action "Override Action [%s]" { channel="automower:automower:mybridge:myAutomower:planner-override-action" }
- DateTime Automower_Next_Start_Time "Next Start Time" { channel="automower:automower:mybridge:myAutomower:planner-next-start" }
- String Automower_Calendar_Tasks "Planned Tasks [%s]" { channel="automower:automower:mybridge:myAutomower:calendar-tasks" }
-
- Number Automower_Command_Start "Start mowing for duration [%d min]" { channel="automower:automower:mybridge:myAutomower:start" }
- Switch Automower_Command_Resume "Resume the schedule" { channel="automower:automower:mybridge:myAutomower:resume_schedule" }
- Switch Automower_Command_Pause "Pause the automower" { channel="automower:automower:mybridge:myAutomower:pause" }
- Number Automower_Command_Park "Park for duration [%d min]" { channel="automower:automower:mybridge:myAutomower:park" }
- Switch Automower_Command_Park_Next_Schedule "Park until next schedule" { channel="automower:automower:mybridge:myAutomower:park_until_next_schedule" }
- Switch Automower_Command_Park_Notice "Park until further notice" { channel="automower:automower:mybridge:myAutomower:park_until_further_notice" }
-
- Location Automower_Last_Position "Last Position" { channel="automower:automower:mybridge:myAutomower:last-position" }
-
+```java
+String Automower_Mode "Mode [%s]" { channel="automower:automower:mybridge:myAutomower:mode" }
+String Automower_Activity "Activity [%s]" { channel="automower:automower:mybridge:myAutomower:activity" }
+String Automower_State "State [%s]" { channel="automower:automower:mybridge:myAutomower:state" }
+DateTime Automower_Last_Update "Last Update" { channel="automower:automower:mybridge:myAutomower:last-update" }
+Number Automower_Battery "Battery [%d %%]" { channel="automower:automower:mybridge:myAutomower:battery" }
+Number Automower_Error_Code "Error Code [%d]" { channel="automower:automower:mybridge:myAutomower:error-code" }
+DateTime Automower_Error_Time "Error Time" { channel="automower:automower:mybridge:myAutomower:error-timestamp" }
+String Automower_Override_Action "Override Action [%s]" { channel="automower:automower:mybridge:myAutomower:planner-override-action" }
+DateTime Automower_Next_Start_Time "Next Start Time" { channel="automower:automower:mybridge:myAutomower:planner-next-start" }
+String Automower_Calendar_Tasks "Planned Tasks [%s]" { channel="automower:automower:mybridge:myAutomower:calendar-tasks" }
+
+Number Automower_Command_Start "Start mowing for duration [%d min]" { channel="automower:automower:mybridge:myAutomower:start" }
+Switch Automower_Command_Resume "Resume the schedule" { channel="automower:automower:mybridge:myAutomower:resume_schedule" }
+Switch Automower_Command_Pause "Pause the automower" { channel="automower:automower:mybridge:myAutomower:pause" }
+Number Automower_Command_Park "Park for duration [%d min]" { channel="automower:automower:mybridge:myAutomower:park" }
+Switch Automower_Command_Park_Next_Schedule "Park until next schedule" { channel="automower:automower:mybridge:myAutomower:park_until_next_schedule" }
+Switch Automower_Command_Park_Notice "Park until further notice" { channel="automower:automower:mybridge:myAutomower:park_until_further_notice" }
+
+Location Automower_Last_Position "Last Position" { channel="automower:automower:mybridge:myAutomower:last-position" }
+```
### automower.sitemap
-
-```
+```perl
sitemap demo label="Automower"
{
Frame {
Example rule that triggers an automower action
-```
+```java
rule "AutomowerParkUntilFurtherNotice"
when
Item Some_Item changed to ON
(It can be deactivated again by dialing `#96*4*`.)
You can test if everything is working with the Telnet program from your openHAB server:
-```
+```shell
telnet fritz.box 1012
```
If you see an output like this:
-```
+```shell
Trying 192.168.178.1...
Connected to fritz.box.
Escape character is '^]'.
The [FRITZ!DECT 400](https://avm.de/produkte/fritzdect/fritzdect-400/) and [FRITZ!DECT 440](https://avm.de/produkte/fritzdect/fritzdect-440/) are buttons for convenient operation of FRITZ! Smart Home devices (FRITZ!OS 7.08 or higher for FRITZ!DECT 400, 7.20 or higher for FRITZ!DECT 440).
The FRITZ!DECT 400 supports a configurable button to trigger short or long press events.
Beside four customizable buttons the FRITZ!DECT 440 supports temperature readings.
-** NOTE: ** FRITZ!DECT 440 now uses Channel Groups to group its Channels like `device#battery_level`, `device#battery_low` for device information, `sensors#temperature` for sensor data and `top-left`, `bottom-left`, `top-right` and `bottom-right` combined with `press` and `last_change` (see [Full Example](#full-example))
+**NOTE:** FRITZ!DECT 440 now uses Channel Groups to group its Channels like `device#battery_level`, `device#battery_low` for device information, `sensors#temperature` for sensor data and `top-left`, `bottom-left`, `top-right` and `bottom-right` combined with `press` and `last_change` (see [Full Example](#full-example))
### FRITZ!DECT 500
The FRITZ!Box has to run at least on firmware FRITZ!OS 7.
-### FRITZ! Groups
+### FRITZ! Groups
The FRITZ!OS supports two different types of groups.
On the one hand there are groups for heating thermostats on the other hand there are groups for switchable outlets and power meters.
Auto-discovery is enabled by default.
To disable it, you can add the following line to `<openHAB-conf>/services/runtime.cfg`:
-```
+```text
discovery.avmfritz:background=false
```
With the new [templates feature](https://en.avm.de/guide/smart-home/meet-the-smart-home-templates-from-fritz/) in FRITZ!OS 7, you can now save the settings of your Smart Home devices and groups as a template for certain occasions e.g. holidays or vacation.
Unfortunately it is not that simple to find out the unique identifier (AIN) for a template needed for sending it as command to the `apply_template` channel.
Here is a work-around:
-To retrieve the list of AINs assigned by FRITZ! for your templates, go to the FRITZ!Box' Support page at http://fritz.box/html/support.html within your local network and login.
+To retrieve the list of AINs assigned by FRITZ! for your templates, go to the FRITZ!Box' Support page at [http://fritz.box/html/support.html](http://fritz.box/html/support.html) within your local network and login.
Then in the section "Support Data" ("Support-Daten") press the button "Create Support Data" ("Support-Daten erstellen") and save the generated text file.
Open the file in a text editor and search for the term "avm_home_device_type_template".
You will find entries like the attached one.
The `identifyer 'tmpFC0F2C-3960B7EE6'` contains the templates AINs you need for using them in rules.
-```
+```text
Name 'Demo Template', identifyer 'tmpFC0F2C-3960B7EE6', firmware version '0.1'
[aktive] ID 60013, emc 0x0, model 0x0, grouphash=0x0, devicetype 'avm_home_device_type_template', functionbitmask 0x4000, sortid 0, batt perc 255 low 255, pollinterval 0, polltimeout 0, validchangetime: 0
--------------------
For heating devices and heating groups there are two actions available to set Boost or Window Open mode for a given duration: `setBoostMode(long)` and `setWindowOpenMode(long)`.
The duration has to be given in seconds, min. 1, max. 86400, 0 for deactivation.
-
-```
+```java
val actions = getActions("avmfritz","avmfritz:Comet_DECT:1:aaaaaabbbbbb")
// set Boost mode for 5 min
This binding provides access to the hourly prices for electricity for the German and Austrian provider aWATTar.
-
## Supported Things
There are three supported things.
### Prices Thing
-The `prices` Thing provides todays and (after 14:00) tomorrows net and gross prices.
+The `prices` Thing provides todays and (after 14:00) tomorrows net and gross prices.
### Bestprice Thing
### aWATTar Bridge
-
| Parameter | Description |
|-------------|-------------------------------------------------------------------------------------------------------------------------------|
| vatPercent | Percentage of the value added tax to apply to net prices. Optional, defaults to 19. |
### Prices Thing
For every hour, the `prices` thing provides the following prices:
-
+
| channel | type | description |
|----------|--------|------------------------------|
| market-net | Number | This net market price per kWh. This is directly taken from the price the aWATTar API delivers. |
| total-net | Number | Sum of net market price and configured base price |
| total-gross | Number | Sum of market and base price with VAT applied. Most probably this is the final price you will have to pay for one kWh in a certain hour |
-
All prices are available in each of the following channel groups:
-
| channel group | description |
|----------|--------------------------------|
| current | The prices for the current hour |
| today00, today01, today02 ... today23 | Hourly prices for today. `today00` provides the price from 0:00 to 1:00, `today01` from 1:00 to 02:00 and so on. As long as the API is working, this data should always be available |
| tomorrow00, tomorrow01, ... tomorrow23 | Hourly prices for the next day. They should be available starting at 14:00. |
-
### Bestprice Thing
| channel | type | description |
| remaining | Number:Time | The time in minutes until end of the bestprice range. If start time passed. the channel will be set to `UNDEFINED` until the values for the next day are available. |
| hours | String | A comma separated list of hours this bestprice period contains. |
-
-
-
## Full Example
### Things
awattar.things:
-```
+```java
Bridge awattar:bridge:bridge1 "aWATTar Bridge" [ country="DE", vatPercent="19", basePrice="17.22"] {
- Thing prices price1 "aWATTar Price" []
+ Thing prices price1 "aWATTar Price" []
// The car should be loaded for 4 hours during the night
- Thing bestprice carloader "Car Loader" [ rangeStart="22", rangeDuration="8", length="4", consecutive="true" ]
+ Thing bestprice carloader "Car Loader" [ rangeStart="22", rangeDuration="8", length="4", consecutive="true" ]
// In the cheapest hour of the night the garden should be watered
- Thing bestprice water "Water timer" [ rangeStart="19", rangeDuration="12", length="1" ]
+ Thing bestprice water "Water timer" [ rangeStart="19", rangeDuration="12", length="1" ]
// The heatpump should run the 12 cheapest hours per day
- Thing bestprice heatpump "Heat pump" [ length="12", consecutive="false" ]
+ Thing bestprice heatpump "Heat pump" [ length="12", consecutive="false" ]
}
```
awattar.items:
-```
+```java
Number:Dimensionless currentnet "Current price [%2.2f ct/kWh]" { channel="awattar:prices:bridge1:price1:current#market-net" }
Number:Dimensionless currentgross "Current price [%2.2f ct/kWh]" { channel="awattar:prices:bridge1:price1:current#market-gross" }
Number:Dimensionless totalnet "Current price [%2.2f ct/kWh]" { channel="awattar:prices:bridge1:price1:current#total-net" }
### Sitemap
-```
+```perl
sitemap default label="aWATTar Sitemap"
{
- Frame label="Car Loader" {
- Switch item=CarActive
- Text item=CarCountdown
- Text item=CarStart
- Text item=CarEnd
- Text item=CarHours
- }
- Frame label="Current Prices" {
- Text label="Current Net" item=currentnet
- Text label="Current Gross" item=currentgross
- Text label="Total Net" item=totalnet
- Text label="Total Gross" item=totalgross
- }
- Frame label="Todays Prices (total gross)" {
- Text item=today00
- Text item=today01
- Text item=today02
- Text item=today03
- Text item=today04
- Text item=today05
- Text item=today06
- Text item=today07
- Text item=today08
- Text item=today09
- Text item=today10
- Text item=today11
- Text item=today12
- Text item=today13
- Text item=today14
- Text item=today15
- Text item=today16
- Text item=today17
- Text item=today18
- Text item=today19
- Text item=today20
- Text item=today21
- Text item=today22
- Text item=today23
- }
- Frame label="Tomorrows Prices (total gross)" {
- Text item=tomorrow00
- Text item=tomorrow01
- Text item=tomorrow02
- Text item=tomorrow03
- Text item=tomorrow04
- Text item=tomorrow05
- Text item=tomorrow06
- Text item=tomorrow07
- Text item=tomorrow08
- Text item=tomorrow09
- Text item=tomorrow10
- Text item=tomorrow11
- Text item=tomorrow12
- Text item=tomorrow13
- Text item=tomorrow14
- Text item=tomorrow15
- Text item=tomorrow16
- Text item=tomorrow17
- Text item=tomorrow18
- Text item=tomorrow19
- Text item=tomorrow20
- Text item=tomorrow21
- Text item=tomorrow22
- Text item=tomorrow23
- }
+ Frame label="Car Loader" {
+ Switch item=CarActive
+ Text item=CarCountdown
+ Text item=CarStart
+ Text item=CarEnd
+ Text item=CarHours
+ }
+ Frame label="Current Prices" {
+ Text label="Current Net" item=currentnet
+ Text label="Current Gross" item=currentgross
+ Text label="Total Net" item=totalnet
+ Text label="Total Gross" item=totalgross
+ }
+ Frame label="Todays Prices (total gross)" {
+ Text item=today00
+ Text item=today01
+ Text item=today02
+ Text item=today03
+ Text item=today04
+ Text item=today05
+ Text item=today06
+ Text item=today07
+ Text item=today08
+ Text item=today09
+ Text item=today10
+ Text item=today11
+ Text item=today12
+ Text item=today13
+ Text item=today14
+ Text item=today15
+ Text item=today16
+ Text item=today17
+ Text item=today18
+ Text item=today19
+ Text item=today20
+ Text item=today21
+ Text item=today22
+ Text item=today23
+ }
+ Frame label="Tomorrows Prices (total gross)" {
+ Text item=tomorrow00
+ Text item=tomorrow01
+ Text item=tomorrow02
+ Text item=tomorrow03
+ Text item=tomorrow04
+ Text item=tomorrow05
+ Text item=tomorrow06
+ Text item=tomorrow07
+ Text item=tomorrow08
+ Text item=tomorrow09
+ Text item=tomorrow10
+ Text item=tomorrow11
+ Text item=tomorrow12
+ Text item=tomorrow13
+ Text item=tomorrow14
+ Text item=tomorrow15
+ Text item=tomorrow16
+ Text item=tomorrow17
+ Text item=tomorrow18
+ Text item=tomorrow19
+ Text item=tomorrow20
+ Text item=tomorrow21
+ Text item=tomorrow22
+ Text item=tomorrow23
+ }
}
```
Some notes:
-* If using a serial port connection, the baud rate in the projector OSD menu must be set to 9600 bps.
-* The _source_, _picturemode_ and _aspectratio_ channels include a dropdown with the most commonly used settings.
-* Not all pre-defined dropdown options will be usable if your particular projector does support a given option.
-* If your projector has an option that is not in the dropdown, the string code to access that option will be displayed by the channel when that option is selected by the remote control.
-* By using the sitemap mapping or a rule to send that code back to the channel, any options that are missing in the binding can be accessed.
-
-* On Linux, you may get an error stating the serial port cannot be opened when the benqprojector binding tries to load.
-* You can get around this by adding the `openhab` user to the `dialout` group like this: `usermod -a -G dialout openhab`.
-* Also on Linux you may have issues with the USB if using two serial USB devices e.g. benqprojector and RFXcom. See the [general documentation about serial port configuration](/docs/administration/serial.html) for more on symlinking the USB ports.
-* Here is an example of ser2net.conf you can use to share your serial port /dev/ttyUSB0 on IP port 4444 using [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) (take care, the baud rate is specific to the BenQ projector):
-
-```
+- If using a serial port connection, the baud rate in the projector OSD menu must be set to 9600 bps.
+- The _source_, _picturemode_ and _aspectratio_ channels include a dropdown with the most commonly used settings.
+- Not all pre-defined dropdown options will be usable if your particular projector does support a given option.
+- If your projector has an option that is not in the dropdown, the string code to access that option will be displayed by the channel when that option is selected by the remote control.
+- By using the sitemap mapping or a rule to send that code back to the channel, any options that are missing in the binding can be accessed.
+
+- On Linux, you may get an error stating the serial port cannot be opened when the benqprojector binding tries to load.
+- You can get around this by adding the `openhab` user to the `dialout` group like this: `usermod -a -G dialout openhab`.
+- Also on Linux you may have issues with the USB if using two serial USB devices e.g. benqprojector and RFXcom. See the [general documentation about serial port configuration](/docs/administration/serial.html) for more on symlinking the USB ports.
+- Here is an example of ser2net.conf you can use to share your serial port /dev/ttyUSB0 on IP port 4444 using [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) (take care, the baud rate is specific to the BenQ projector):
+
+```text
4444:raw:0:/dev/ttyUSB0:9600 8DATABITS NONE 1STOPBIT LOCAL
```
## Channels
-| Channel | Item Type | Purpose | Values |
-| ------------------ | --------- | --------------------------------------------------- | --------- |
-| power | Switch | Powers the projector on or off. | |
-| source | String | Retrieve or set the input source. | See above |
-| picturemode | String | Retrieve or set the picture mode. | See above |
-| aspectratio | String | Retrieve or set the aspect ratio. | See above |
-| freeze | Switch | Turn the freeze image mode on or off. | |
-| blank | Switch | Turn the screen blank mode on or off. | |
-| directcmd | String | Send a command directly to the projector. | Send only |
-| lamptime | Number | Retrieves the lamp hours. | Read only |
+| Channel | Item Type | Purpose | Values |
+| ------------------ | --------- | --------------------------------------------------- | --------- |
+| power | Switch | Powers the projector on or off. | |
+| source | String | Retrieve or set the input source. | See above |
+| picturemode | String | Retrieve or set the picture mode. | See above |
+| aspectratio | String | Retrieve or set the aspect ratio. | See above |
+| freeze | Switch | Turn the freeze image mode on or off. | |
+| blank | Switch | Turn the screen blank mode on or off. | |
+| directcmd | String | Send a command directly to the projector. | Send only |
+| lamptime | Number | Retrieves the lamp hours. | Read only |
## Full Example
things/benq.things:
-```
+```java
// serial port connection
benqprojector:projector-serial:hometheater "Projector" [ serialPort="COM5", pollingInterval=10 ]
items/benq.items
-```
+```java
Switch benqPower { channel="benqprojector:projector-serial:hometheater:power" }
String benqSource "Source [%s]" { channel="benqprojector:projector-serial:hometheater:source" }
String benqPictureMode "Picture Mode [%s]" { channel="benqprojector:projector-serial:hometheater:picturemode" }
sitemaps/benq.sitemap
-```
+```perl
sitemap benq label="BenQ Projector" {
Frame label="Controls" {
Switch item=benqPower label="Power"
### Manual Thing Creation
-Fan and light things can be manually created using the *UI*, or by placing a *.things* file in the *conf/things* directory.
+Fan and light things can be manually created using the _UI_, or by placing a _.things_ file in the _conf/things_ directory.
See example below.
## Device Discovery
Background discovery polls the network every few minutes for devices.
Background discovery is **enabled** by default.
-To **disable** background discovery, add the following line to the *conf/services/runtime.cfg* file:
+To **disable** background discovery, add the following line to the _conf/services/runtime.cfg_ file:
```text
discovery.bigassfan:background=false
### Manual Thing Creation
-Place a file named *bigassfan.things* in the *conf/things* directory.
+Place a file named _bigassfan.things_ in the _conf/things_ directory.
The file should contain lines formatted like this.
```java
# Airthings
-This extension adds support for [Airthings](https://www.airthings.com) indoor air quality monitor sensors.
+This extension adds support for [Airthings](https://www.airthings.com) indoor air quality monitor sensors.
## Supported Things
## Discovery
-As any other Bluetooth device, Airthings devices are discovered automatically by the corresponding bridge.
+As any other Bluetooth device, Airthings devices are discovered automatically by the corresponding bridge.
## Thing Configuration
airthings.things (assuming you have a Bluetooth bridge with the ID `bluetooth:bluegiga:adapter1`:
-```
+```java
bluetooth:airthings_wave_plus:adapter1:sensor1 "Airthings Wave Plus Sensor 1" (bluetooth:bluegiga:adapter1) [ address="12:34:56:78:9A:BC", refreshInterval=300 ]
```
airthings.items:
-```
+```java
Number:Temperature temperature "Temperature [%.1f %unit%]" { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:temperature" }
Number:Dimensionless humidity "Humidity [%d %unit%]" { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:humidity" }
Number:Pressure pressure "Air Pressure [%d %unit%]" { channel="bluetooth:airthings_wave_plus:adapter1:sensor1:pressure" }
|---------------|-------------------------------|
| am43 | AM43 Blind Drive Motor |
-
## Discovery
As any other Bluetooth device, AM43 Blind Drive Motors are discovered automatically by the corresponding bridge.
am43.things (assuming you have a Bluetooth bridge with the ID `bluetooth:bluegiga:adapter1`:
-```
+```java
bluetooth:am43:adapter1:motor1 "AM43 Blind Drive Motor 1" (bluetooth:bluegiga:adapter1) [ address="12:34:56:78:9A:BC", refreshInterval=300, invertPosition=false ]
```
am43.items:
-```
+```java
String direction "Direction [%s]" { channel="bluetooth:am43:adapter1:motor1:direction" }
Switch topLimitSet "Top Limit Set" { channel="bluetooth:am43:adapter1:motor1:topLimitSet" }
Switch bottomLimitSet "Bottom Limit Set" { channel="bluetooth:am43:adapter1:motor1:bottomLimitSet" }
Number:Dimensionless light_level "Light Level [%.0f]" { channel="bluetooth:am43:adapter1:motor1:lightLevel" }
Number:Dimensionless battery_level "Battery Level [%.0f %%]" { channel="bluetooth:am43:adapter1:motor1:electric" }
```
-
-
-
|----------------|---------------------------------------------------------------------------|
| bluegiga | A BlueGiga USB dongle using a BLED112 chip |
-
## Discovery
The adapter cannot be discovered; its serial port must be manually configured.
This is how a BlueGiga adapter can be configured textually in a *.things file:
-```
+```java
Bridge bluetooth:bluegiga:1 [ port="/dev/ttyS0", backgroundDiscovery=false ]
```
Also, in case you don't want to manually enable your bluetooth adapters with `bluetoothctl`, ensure that it's automatically enabled by setting the option `AutoEnable` in your `/etc/bluetooth/main.conf` to `true`.
Restart running services for changes to take effect.
-```
+```shell
systemctl restart dbus
systemctl restart bluetooth
systemctl restart openhab2
If BlueZ is enabled and can be accessed, all available adapters are automatically discovered.
-
## Bridge Configuration
The bluez bridge requires the configuration parameter `address`, which corresponds to the Bluetooth address of the adapter (in format "XX:XX:XX:XX:XX:XX").
This is how a BlueZ adapter can be configured textually in a *.things file:
-```
+```java
Bridge bluetooth:bluez:hci0 [ address="12:34:56:78:90:AB", backgroundDiscovery=false ]
```
# Blukii
-This extension adds support for [Blukii](https://www.blukii.com/) Sensor Beacons.
+This extension adds support for [Blukii](https://www.blukii.com/) Sensor Beacons.
## Supported Things
## Discovery
-As any other Bluetooth device, Blukii Beacons are discovered automatically by the corresponding bridge.
+As any other Bluetooth device, Blukii Beacons are discovered automatically by the corresponding bridge.
## Thing Configuration
demo.things:
-```
+```java
bluetooth:blukii:hci0:beacon "Blukii Sensor Beacon" (bluetooth:bluez:hci0) [ address="12:34:56:78:9A:BC" ]
```
demo.items:
-```
+```java
Number:Temperature temperature "Room Temperature [%.1f %unit%]" { channel="bluetooth:blukii:hci0:beacon:temperature" }
Number:Dimensionless humidity "Humidity [%.0f %unit%]" { channel="bluetooth:blukii:hci0:beacon:humidity" }
Number:Pressure pressure "Air Pressure [%.0f %unit%]" { channel="bluetooth:blukii:hci0:beacon:pressure" }
[BRC1H on Daikin website (EN)](https://www.daikin.eu/en_us/product-group/control-systems/BRC1H.html)
-
## Supported Things
-
| Thing Type ID | Description |
| ------------- | ----------- |
| brc1h | BRC1H BLE Thermostat |
-
## Discovery
As a pairing of the Thermostat is necessary (Bluetooth), no automatic discovery is implemented.
## Thing Configuration
-* address: The Bluetooth MAC Address of the BRC1H controller
+- address: The Bluetooth MAC Address of the BRC1H controller
Example with a DBusBlueZ Bluetooth Bridge:
-```
-
+```java
Bridge bluetooth:dbusbluez:hci0 [ address="00:1A:7D:DA:71:13" ]
Thing bluetooth:brc1h:hci0:salon (bluetooth:dbusbluez:hci0) [ address="00:CC:3F:B2:80:CA" ]
-
```
-
## Channels
_Here you should provide information about available channel types, what their meaning is and how they can be used._
### daikinmadoka.things:
-```
-
+```java
Bridge bluetooth:dbusbluez:hci0 [ address="00:1A:7D:DA:71:13" ]
Thing bluetooth:brc1h:hci0:salon (bluetooth:dbusbluez:hci0) [ address="00:CC:3F:B2:80:CA" ]
### daikinmadoka.items:
-```
-
+```java
Group g_climSalon "Salon" [ "Thermostat" ]
Switch climSalon_onOff "Climatisation Salon" (g_climSalon) { channel="bluetooth:brc1h:hci0:salon:onOffStatus" }
We suggest that the Bluetooth adapter is not being used by another component during the pairing phase.
As such, if you have other Bluetooth Things in your OpenHAB, it is suggested to stop the openHAB service before doing the pairing.
- * Ensure that your BRC1H has Bluetooth enabled in the menu
- * Open `bluetoothctl` on your openHAB server - preferably as `root`
- * start scanning by typing `scan on`
- * After few seconds, stop scanning `scan off`
- * Start the pairing process by typing `pair <mac address of your brc1h>`
- * On the BRC1H, confirm the pairing request, and quickly confirm as well on your server by typing `yes`
+- Ensure that your BRC1H has Bluetooth enabled in the menu
+- Open `bluetoothctl` on your openHAB server - preferably as `root`
+- start scanning by typing `scan on`
+- After few seconds, stop scanning `scan off`
+- Start the pairing process by typing `pair <mac address of your brc1h>`
+- On the BRC1H, confirm the pairing request, and quickly confirm as well on your server by typing `yes`
A successful pairing ends with `pairing successful`.
| --------------- | ------------------------- |
| ptm215b | The EnOcean PTM 215B Rocker |
-
These rockers are battery-less, the necessary energy for the BLE transmission is generated by the button click itself
and completely depleted after 3 attempts of a "fire & forget" (unidirectional) BLE transmission.
This means, the rockers are only "on" during the button click, so there is no possibility for openHAB to actively
demo.things:
-```
+```java
Bridge bluetooth:bluegiga:bluegiga0 "Bluegiga Adapter" [ port="/dev/ttyBLUEGIGA", discovery=false ] {
Thing ptm215b rocker_livingroom "Rocker Living Room" [ address = "E2:15:00:00:53:F9" ]
Thing ptm215b rocker_kitchen "Rocker Kitchen" [ address = "E2:15:00:00:53:98" ]
demo.items:
-```
+```java
Dimmer Light_LivingRoom { channel="milight:rgbLed:milight2:4:ledbrightness", channel="bluetooth:ptm215b:bluegiga0:rocker_livingroom:rocker1" [profile="rawrocker-to-on-off"], channel="bluetooth:ptm215b:bluegiga0:rocker_kitchen:rocker1" [profile="rawrocker-to-on-off"] } // We have a combined kitchen / livingroom, so we control the living room lights with switches from the living room and from the kitchen
Switch Light_Kitchen { channel="hue:group:1:kitchen-bulbs:switch", channel="bluetooth:ptm215b:bluegiga0:rocker_kitchen:rocker2" [profile="rawrocker-to-on-off"] }
```
## Channels
Channels will be dynamically created based on types of characteristics the device supports.
-This binding contains a mostly complete database of standardized GATT services and characteristics
+This binding contains a mostly complete database of standardized GATT services and characteristics
that is used to map characteristics to one or multiple channels.
Characteristics not in the database will be mapped to a single `String` channel labeled `Unknown`.
# Govee
-This extension adds support for [Govee](https://www.govee.com/) Bluetooth Devices.
+This extension adds support for [Govee](https://www.govee.com/) Bluetooth Devices.
## Supported Things
## Discovery
-As any other Bluetooth device, Govee devices are discovered automatically by the corresponding bridge.
+As any other Bluetooth device, Govee devices are discovered automatically by the corresponding bridge.
## Thing Configuration
| all | address | yes | | The Bluetooth address of the device (in format "XX:XX:XX:XX:XX:XX") |
| all | refreshInterval | | 300 | How often, in seconds, the sensor data of the device should be refreshed |
| goveeHygrometer<sup>1</sup> | temperatureCalibration | no | | Offset to apply to temperature<sup>2</sup> sensor readings |
-| goveeHygrometer<sup>1</sup> | humidityCalibration | no | | Offset to apply to humidity sensor readings |
+| goveeHygrometer<sup>1</sup> | humidityCalibration | no | | Offset to apply to humidity sensor readings |
| goveeHygrometerMonitor | temperatureWarningAlarm | | false | Enables warning alarms to be broadcast when temperature is out of specified range |
| goveeHygrometerMonitor | temperatureWarningMin | | 0 | The lower safe temperature<sup>2</sup> threshold <sup>3</sup> |
| goveeHygrometerMonitor | temperatureWarningMax | | 0 | The upper safe temperature<sup>2</sup> threshold <sup>3</sup> |
| goveeHygrometerMonitor | humidityWarningMax | | 0 | The upper safe humidity threshold <sup>3</sup> |
1. Available to both `goveeHygrometer` and `goveeHygrometerMonitor` thing types.
-2. In °C
-3. Only applies if alarm feature is enabled
+1. In °C
+1. Only applies if alarm feature is enabled
## Channels
| goveeHygrometerMonitor | humidityAlarm | Switch | Indicates if current humidity is out of range. <sup>2</sup> |
1. Available to both `goveeHygrometer` and `goveeHygrometerMonitor` thing types.
-2. Only applies if warning alarms are enabled in the configuration.
+1. Only applies if warning alarms are enabled in the configuration.
## Example
demo.things:
-```
+```java
bluetooth:goveeHygrometer:hci0:beacon "Govee Temperature Humidity Monitor" (bluetooth:bluez:hci0) [ address="12:34:56:78:9A:BC" ]
```
demo.items:
-```
+```java
Number:Temperature temperature "Room Temperature [%.1f %unit%]" { channel="bluetooth:goveeHygrometer:hci0:beacon:temperature" }
Number:Dimensionless humidity "Humidity [%.0f %unit%]" { channel="bluetooth:goveeHygrometer:hci0:beacon:humidity" }
Number:Dimensionless battery "Battery [%.0f %unit%]" { channel="bluetooth:goveeHygrometer:hci0:beacon:battery" }
`groupUIDs` must be formatted as a comma separated list of Bluetooth adapter thing UID values.
If the `groupUIDs` parameter is not specified or left empty then the Roaming adapter will track devices across all other Bluetooth adapters.
-Additionally, the Roaming bridge has the parameter `backgroundDiscovery` that can be set to `true` or `false`.
+Additionally, the Roaming bridge has the parameter `backgroundDiscovery` that can be set to `true` or `false`.
When set to `true`, a device discovered on any other adapter will have a corresponding `roaming` discovery.
The `backgroundDiscovery` parameter is true by default.
This is how a Roaming adapter can be configured textually in a *.things file:
-```
+```java
Bridge bluetooth:roaming:ctrl "BLE Roaming Adapter" [ backgroundDiscovery=true]
Bridge bluetooth:roaming:other "BLE Roaming Adapter" [ backgroundDiscovery=true, groupUIDs="bluetooth:bluez:hci0,bluetooth:bluez:hci1"]
```
# Ruuvi Tag
-This extension adds support for [Ruuvi Tag](https://ruuvi.com/) Sensor Beacons.
+This extension adds support for [Ruuvi Tag](https://ruuvi.com/) Sensor Beacons.
## Supported Things
| --------------- | ------------------------- |
| ruuvitag_beacon | A Ruuvi Tag Sensor Beacon |
-
Under normal conditions the ruuvitag should submit data every 10 seconds.
However, if no data has been retrieved after 1 minute the ruuvitag is set to OFFLINE and the state of channels is set to UNDEF.
When new data is retrieved when OFFLINE the ruuvtag is set ONLINE again.
## Discovery
-As any other Bluetooth device, Ruuvi Tag Beacons are discovered automatically by the corresponding bridge.
+As any other Bluetooth device, Ruuvi Tag Beacons are discovered automatically by the corresponding bridge.
## Thing Configuration
demo.things:
-```
+```java
bluetooth:ruuvitag:hci0:beacon "RuuviTag Sensor Beacon" (bluetooth:bluez:hci0) [ address="12:34:56:78:9A:BC" ]
```
demo.items:
-```
+```java
Number:Temperature temperature "Room Temperature [%.1f %unit%]" { channel="bluetooth:ruuvitag:hci0:beacon:temperature" }
Number:Dimensionless humidity "Humidity [%.0f %unit%]" { channel="bluetooth:ruuvitag:hci0:beacon:humidity" }
Number:Pressure pressure "Air Pressure [%.0f %unit%]" { channel="bluetooth:ruuvitag:hci0:beacon:pressure" }
# Bluetooth Binding overview
-
+
The Bluetooth binding is implemented to allow bundles to extend the main Bluetooth bundle (this one) in order to add new Bluetooth adapter as well as device support.
This architecture means that such extension bundles must utilise the binding name `bluetooth`.
A base class structure is defined in the `org.openhab.binding.bluetooth` bundle.
This includes the main classes required to implement Bluetooth:
-
-* `BluetoothAdapter`. This interface defines the main functionality required to be implemented by a Bluetooth adapter, including device discovery. Typically, this interface is implemented by a BridgeHandler and then registered as an OSGi service
-* `BluetoothDiscoveryParticipant`. An interface to be implemented by services that can identify specific Bluetooth devices.
-* `BluetoothDevice`. This implements a Bluetooth device. It manages the notifications of device notifications, Bluetooth service and characteristic management, and provides the main interface to communicate to a Bluetooth device.
-* `BluetoothService`. Implements the Bluetooth service. A service holds a number of characteristics.
-* `BluetoothCharacteristic`. Implements the Bluetooth characteristic. This is the basic component for communicating data to and from a Bluetooth device.
-* `BluetoothDescriptor`. Implements the Bluetooth descriptors for each characteristic.
-
+
+- `BluetoothAdapter`. This interface defines the main functionality required to be implemented by a Bluetooth adapter, including device discovery. Typically, this interface is implemented by a BridgeHandler and then registered as an OSGi service
+- `BluetoothDiscoveryParticipant`. An interface to be implemented by services that can identify specific Bluetooth devices.
+- `BluetoothDevice`. This implements a Bluetooth device. It manages the notifications of device notifications, Bluetooth service and characteristic management, and provides the main interface to communicate to a Bluetooth device.
+- `BluetoothService`. Implements the Bluetooth service. A service holds a number of characteristics.
+- `BluetoothCharacteristic`. Implements the Bluetooth characteristic. This is the basic component for communicating data to and from a Bluetooth device.
+- `BluetoothDescriptor`. Implements the Bluetooth descriptors for each characteristic.
+
## Implementing a new Bluetooth Adapter bundle
-
+
Bluetooth adapters are modelled as a bridge in openHAB.
The bridge handler provides the link with the Bluetooth hardware (eg a dongle, or system Bluetooth API).
An adapter bundle needs to implement two main classes: the `BridgeHandler` which should implement `BluetoothAdapter` (any be registered as a service), and a `ThingFactory`, which is required to instantiate the handler.
-
+
The bridge handler must implement any functionality required to interface to the Bluetooth layer.
It is responsible for managing the Bluetooth scanning, device discovery (i.e. the device interrogation to get the list of services and characteristics) and reading and writing of characteristics.
The bridge needs to manage any interaction between the interface with any things it provides – this needs to account for any constraints that an interface may impose such that things do not need to worry about any peculiarities imposed by a specific interface.
Classes such as `BluetoothCharacteristic` or `BluetoothService` may be extended to provide additional functionality to interface to a specific library if needed.
-
+
## Implementing specific Bluetooth device support
-
+
A specific Bluetooth thing handler provides the functionality required to interact with a specific Bluetooth device.
The new thing bundle needs to implement three main classes – a `BluetoothDiscoveryParticipant`, a `ThingHandler` and a `ThingFactory`, which is required to instantiate the handler.
-
+
Two fundamental communications methods can be employed in Bluetooth: beacons and connected mode. A Bluetooth thing handler can implement one or both of these communications
In practice, a connected mode Thing implementation would normally handle the beacons in order to provide as a minimum the RSSI data.
### Thing Naming
-To avoid naming conflicts with different Bluetooth bundles a strict naming policy for things and thing xml files is proposed.
+To avoid naming conflicts with different Bluetooth bundles a strict naming policy for things and thing xml files is proposed.
This should use the bundle name and the thing name, separated with an underscore - e.g. for a Yeelight binding Blue2 thing, the thing type would be `yeelight_blue2`.
-
+
### Connected Mode Implementation
-
+
The connected mode `BluetoothThingHandler` needs to handle the following functionality
-* Extend the connected bluetooth thing handler. This holds the `adapter` through which all communication is done.
-* Call the `adapter.getDevice()` method to get the `BluetoothDevice` class for the requested device. The `getDevice()` method will return a `BluetoothDevice` class even if the device is not currently known.
-* Implement the `BluetoothDeviceListener` methods. These provide callbacks for various notifications regarding device updates – e.g. when the connection state of a device changes, when the device discovery is complete, when a read and write completes, and when beacon messages are received.
-* The parent class calls the `device.connect()` method to connect to the device. Once the device is connected, the `BluetoothDeviceListener.onConnectionStateChange()` callback will be called.
-* The parent class calls the `device.discoverServices()` method to discover all the BluetoothServices and `BluetoothCharacteristic`s implemented by the device. Once this is complete, the `BluetoothDeviceListener.onServicesDiscovered()` callback will be called.
-* Call the `readCharacteristic` or `writeCharacteristic` methods to interact with the device. The `BluetoothDeviceListener.onCharacteristicReadComplete()` and `BluetoothDeviceListener.onCharacteristicWriteComplete()` methods will be called on completion.
-* Implement the `BluetoothDeviceListener.onCharacteristicUpdate()` method to process any read responses or unsolicited updates of a characteristic value.
-
+
+- Extend the connected bluetooth thing handler. This holds the `adapter` through which all communication is done.
+- Call the `adapter.getDevice()` method to get the `BluetoothDevice` class for the requested device. The `getDevice()` method will return a `BluetoothDevice` class even if the device is not currently known.
+- Implement the `BluetoothDeviceListener` methods. These provide callbacks for various notifications regarding device updates – e.g. when the connection state of a device changes, when the device discovery is complete, when a read and write completes, and when beacon messages are received.
+- The parent class calls the `device.connect()` method to connect to the device. Once the device is connected, the `BluetoothDeviceListener.onConnectionStateChange()` callback will be called.
+- The parent class calls the `device.discoverServices()` method to discover all the BluetoothServices and `BluetoothCharacteristic`s implemented by the device. Once this is complete, the `BluetoothDeviceListener.onServicesDiscovered()` callback will be called.
+- Call the `readCharacteristic` or `writeCharacteristic` methods to interact with the device. The `BluetoothDeviceListener.onCharacteristicReadComplete()` and `BluetoothDeviceListener.onCharacteristicWriteComplete()` methods will be called on completion.
+- Implement the `BluetoothDeviceListener.onCharacteristicUpdate()` method to process any read responses or unsolicited updates of a characteristic value.
+
### Beacon Mode Implementation
-
+
The beacon mode thing handler needs to handle the following functionality:
-* Extend the beacon Bluetooth thing handler. This holds the `adapter` through which all communication is done.
-* Call the `adapter.getDevice()` method to get the `BluetoothDevice` class for the requested device. The `getDevice()` method will return a `BluetoothDevice` class even if the device is not currently known.
-* Implement the `BluetoothDeviceListener.onScanRecordReceived()` method to process the beacons. The notification will provide the current receive signal strength (RSSI), the raw beacon data, and various elements of generally useful beacon data is provided separately.
+- Extend the beacon Bluetooth thing handler. This holds the `adapter` through which all communication is done.
+- Call the `adapter.getDevice()` method to get the `BluetoothDevice` class for the requested device. The `getDevice()` method will return a `BluetoothDevice` class even if the device is not currently known.
+- Implement the `BluetoothDeviceListener.onScanRecordReceived()` method to process the beacons. The notification will provide the current receive signal strength (RSSI), the raw beacon data, and various elements of generally useful beacon data is provided separately.
### Generic Bluetooth Device Support
In order to function, this binding requires a Bluetooth adapter to be present, which handles the wireless communication.
As there is no standard in Bluetooth for such dongles resp. chips, different adapters require a different implementation.
-This is why the Bluetooth binding itself does not come with any bridge handlers for such adapters itself, but instead is extensible by additional bundles which can implement support for a specific adapter.
+This is why the Bluetooth binding itself does not come with any bridge handlers for such adapters itself, but instead is extensible by additional bundles which can implement support for a specific adapter.
For Linux, there exists a special bundle which provides a Bluetooth bridge that talks to BlueZ.
This should be the best choice for any Linux-based single board computers like e.g. the Raspberry Pi.
|---------------|---------------------------------------------------------------------------------------------------------|
| beacon | A Bluetooth device that is not connected, but only broadcasts announcements. |
-
## Discovery
Discovery is performed through the Bluetooth bridge.
All bluetooth thing types require a configuration parameter `address`, which corresponds to the Bluetooth address of the device (in format "XX:XX:XX:XX:XX:XX").
Other configuration parameters may be required depending on the bluetooth thing type, look at the documentation for that thing type for details.
-
## Channels
Every Bluetooth thing has the following channel:
demo.things (assuming you have a Bluetooth bridge with the ID `bluetooth:bluez:hci0`):
-```
+```java
bluetooth:beacon:hci0:b1 "BLE Beacon" (bluetooth:bluez:hci0) [ address="68:64:4C:14:FC:C4" ]
```
demo.items:
-```
+```java
Number Beacon_RSSI "My Beacon [%.0f]" { channel="bluetooth:beacon:hci0:b1:rssi" }
```
demo.sitemap:
-```
+```perl
sitemap demo label="Main Menu"
{
Frame {
### `bond.things` File
-```
+```java
bondhome:bondBridge:BD123456 "Bond Bridge" [ ipAddress="192.168.0.10", localToken="abc123", serialNumber="BD123456" ]
bondhome:bondFan:BD123456:0d11f00 "Living Room Fan" (bondhome:bondBridge:BD123456) [ deviceId="0d11f00" ]
```
### `bond.items` File
-```
+```java
Switch GreatFan_Switch "Great Room Fan" { channel="bondhome:bondFan:BD123456:0d11f00:common#power" }
Dimmer GreatFan_Dimmer "Great Room Fan" { channel="bondhome:bondFan:BD123456:0d11f00:fan#speed" }
String GreatFan_Rotation "Great Room Fan Rotation" { channel="bondhome:bondFan:BD123456:0d11f00:fan#direction" }
## Thing Configuration
-Currently the binding supports ***indego*** mowers as a thing type with these configuration parameters:
+Currently the binding supports _**indego**_ mowers as a thing type with these configuration parameters:
| Parameter | Description | Default |
|--------------------|-------------------------------------------------------------------|---------|
### `indego.things` File
-```
+```java
boschindego:indego:lawnmower [username="mail@example.com", password="idontneedtocutthelawnagain", refresh=120]
```
### `indego.items` File
-```
+```java
Number Indego_State { channel="boschindego:indego:lawnmower:state" }
Number Indego_ErrorCode { channel="boschindego:indego:lawnmower:errorcode" }
Number Indego_StateCode { channel="boschindego:indego:lawnmower:statecode" }
### `indego.sitemap` File
-```
+```perl
Switch item=Indego_State mappings=[1="Mow", 2="Return",3="Pause"]
```
To only build the Bosch Smart Home binding code execute
- mvn -pl :org.openhab.binding.boschshc install
+```shell
+mvn -pl :org.openhab.binding.boschshc install
+```
## Execute
-After compiling a new ``org.openhab.binding.boschshc.jar``
+After compiling a new ``org.openhab.binding.boschshc.jar``
copy it into the ``addons`` folder of your openHAB test instance.
For the first time the jar is loaded automatically as a bundle.
To reload the bundle manually you need to execute in the openhab console:
- bundle:update "openHAB Add-ons :: Bundles :: Bosch Smart Home Binding"
-
+```shell
+bundle:update "openHAB Add-ons :: Bundles :: Bosch Smart Home Binding"
+```
+
or get the ID and update the bundle using the ID:
- bundle:list
- -> Get ID for "openHAB Add-ons :: Bundles :: Bosch Smart Home Binding"
- bundle:update <ID>
-
+```shell
+bundle:list
+```
+
+-> Get ID for "openHAB Add-ons :: Bundles :: Bosch Smart Home Binding"
+
+```shell
+bundle:update <ID>
+```
## Debugging
To get debug output and traces of the Bosch Smart Home binding code
-add the following lines into ``userdata/etc/log4j2.xml`` Loggers XML section.
+add the following lines into ``userdata/etc/log4j2.xml`` Loggers XML section.
- <!-- Bosch SHC for debugging -->
- <Logger level="TRACE" name="org.openhab.binding.boschshc"/>
+```xml
+<!-- Bosch SHC for debugging -->
+<Logger level="TRACE" name="org.openhab.binding.boschshc"/>
+```
or use the openhab console to change the log level
- log:set TRACE org.openhab.binding.boschshc
+```shell
+log:set TRACE org.openhab.binding.boschshc
+```
## Pairing and Certificates
A precondition for the secured connection to the Bosch SHC is a self singed key + certificate.
The key + certificate will be created and stored with the public Bosch SHC certificates in a Java Key store (jks).
-The public certificates files are from https://github.com/BoschSmartHome/bosch-shc-api-docs/tree/master/best_practice.
+The public certificates files are from <https://github.com/BoschSmartHome/bosch-shc-api-docs/tree/master/best_practice>.
File copies stored in ``src/main/resource``.
All three certificates and the key will be used for the HTTPS connection between
this openHAB binding and the Bosch SHC.
-During pairing the openHAB binding will exchange the self singed certificate with SHC.
\ No newline at end of file
+During pairing the openHAB binding will exchange the self singed certificate with SHC.
- [In-Wall Switch](#in-wall-switch)
- [Compact Smart Plug](#compact-smart-plug)
- [Twinguard Smoke Detector](#twinguard-smoke-detector)
- - [Door/Window Contact](#door-window-contact)
+ - [Door/Window Contact](#doorwindow-contact)
- [Motion Detector](#motion-detector)
- [Shutter Control](#shutter-control)
- [Thermostat](#thermostat)
A keystore file with a self-signed certificate is created automatically.
This certificate is used for pairing between the Bridge and the Bosch Smart Home Controller.
-*Press and hold the Bosch Smart Home Controller Bridge button until the LED starts blinking after you save your settings for pairing*.
+_Press and hold the Bosch Smart Home Controller Bridge button until the LED starts blinking after you save your settings for pairing_.
## Getting the device IDs
The log can also be called using the following command.
-```
+```bash
tail -f /var/log/openhab/openhab.log /var/log/openhab/events.log
```
-Alternatively, the log can be viewed using the OpenHab Log Viewer (frontail) via http://openhab:9001.
+Alternatively, the log can be viewed using the OpenHab Log Viewer (frontail) via <http://openhab:9001>.
Example:
-```
+```bash
2020-08-11 12:42:49.490 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Heizung id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
2020-08-11 12:42:49.495 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=-RoomClimateControl- id=roomClimateControl_hz_1
2020-08-11 12:42:49.497 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=-VentilationService- id=ventilationService
You define your Bosch devices by adding them either to a `.things` file in your `$OPENHAB_CONF/things` folder like this:
-```
+```java
Bridge boschshc:shc:1 [ ipAddress="192.168.x.y", password="XXXXXXXXXX" ] {
Thing in-wall-switch bathroom "Bathroom" [ id="hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX" ]
Thing in-wall-switch bedroom "Bedroom" [ id="hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX" ]
You define the items which should be linked to your Bosch devices via a `.items` file in your `$OPENHAB_CONF/items` folder like this:
-```
+```java
Switch Bosch_Bathroom "Bath Room" { channel="boschshc:in-wall-switch:1:bathroom:power-switch" }
Switch Bosch_Bedroom "Bed Room" { channel="boschshc:in-wall-switch:1:bedroom:power-switch" }
Switch Bosch_Kitchen "Kitchen" { channel="boschshc:in-wall-switch:1:kitchen:power-switch" }
This binding supports the Bose SoundTouch multiroom system.
## Supported Things
-
+
The following Bose devices are supported:
| Name | Thing Type |
| Bose SoundTouch Wireless Link Adapter | wirelessLinkAdapter |
| Bose SoundTouch SA-5 Amplifier | sa5Amplifier |
| Any other Bose SoundTouch device | device |
-
+
## Discovery
-
+
Speakers are automatically discovered using mDNS in the local network.
-
+
## Binding Configuration
-
+
The binding has no configuration options, all configuration is done at Thing level.
-
+
## Thing Configuration
-
+
All thing types have the same configuration parameters:
| Parameter Name | Type | Required | Description |
Note that the device might have two MAC addresses, one for ethernet and one for Wifi.
The authorization key is used to identify the client application when using the Notification API. It must be requested from the developer portal.
-
+
## Channels
All devices share the same set of channels, while some of them might not be available on all devices.
|---------------------------|-----------|--------------------------------------------------------------|
| keyCode | String | Simulates pushing a remote control button |
| mute | Switch | Mutes the sound |
-| notificationsound | String | Play a notification sound by a given URI |
+| notificationsound | String | Play a notification sound by a given URI |
| nowPlayingAlbum | String | Current playing album name |
| nowPlayingArtist | String | Current playing artist name |
| nowPlayingArtwork | Image | Artwork for the current playing song |
| skipPreviousEnabled | Switch | Current source allows scrolling through tracks |
| volume | Dimmer | Set or get the volume |
| bass | Number | Bass (-9 minimum, 0 maximum) |
-
-The *notificationsound* channel has the following optional configuration parameters:
+The _notificationsound_ channel has the following optional configuration parameters:
+
+- notificationVolume - Desired volume level while playing the notification, it must be between 10 and 70 (inclusive). A value outside this range will result in an error and not play the notification.
+- notificationService - The service providing the notification
+- notificationReason - The reason for the notification
+- notificationMessage - Further details about the notification
- - notificationVolume - Desired volume level while playing the notification, it must be between 10 and 70 (inclusive). A value outside this range will result in an error and not play the notification.
- - notificationService - The service providing the notification
- - notificationReason - The reason for the notification
- - notificationMessage - Further details about the notification
-
The texts for the notification service, reason and message appear on the device display (when available) and the SoundTouch application screen.
Upon completion of the notification, the speaker volume returns to its original value. If not present, the notification will play at the existing volume level.
-
+
## Full Example
Things:
-```
+```java
bosesoundtouch:device:demo @ "Living" [ host="192.168.1.2", macAddress="123456789ABC" ]
```
Items:
-```
+```java
Switch Bose1_Power "Power: [%s]" <switch> { channel="bosesoundtouch:device:demo:power" }
Dimmer Bose1_Volume "Volume: [%d %%]" <volume> { channel="bosesoundtouch:device:demo:volume" }
Number Bose1_Bass "Bass: [%d %%]" <volume> { channel="bosesoundtouch:device:demo:bass" }
Sitemap:
-```
+```perl
sitemap demo label="Bose Test Items"
{
- Frame label="Bose 1" {
+ Frame label="Bose 1" {
Switch item=Bose1_Power
- Slider item=Bose1_Volume
- Text item=Bose1_Bass
- Switch item=Bose1_Mute
- Text item=Bose1_OperationMode
- Text item=Bose1_PlayerControl
- Text item=Bose1_Preset
- Text item=Bose1_SaveAsPreset
- Text item=Bose1_KeyCode
- Text item=Bose1_nowPlayingAlbum
- Text item=Bose1_nowPlayingArtist
- Text item=Bose1_nowPlayingArtwork
- Text item=Bose1_nowPlayingDescription
- Text item=Bose1_nowPlayingGenre
- Text item=Bose1_nowPlayingItemName
- Text item=Bose1_nowPlayingStationLocation
- Text item=Bose1_nowPlayingTrack
- }
+ Slider item=Bose1_Volume
+ Text item=Bose1_Bass
+ Switch item=Bose1_Mute
+ Text item=Bose1_OperationMode
+ Text item=Bose1_PlayerControl
+ Text item=Bose1_Preset
+ Text item=Bose1_SaveAsPreset
+ Text item=Bose1_KeyCode
+ Text item=Bose1_nowPlayingAlbum
+ Text item=Bose1_nowPlayingArtist
+ Text item=Bose1_nowPlayingArtwork
+ Text item=Bose1_nowPlayingDescription
+ Text item=Bose1_nowPlayingGenre
+ Text item=Bose1_nowPlayingItemName
+ Text item=Bose1_nowPlayingStationLocation
+ Text item=Bose1_nowPlayingTrack
+ }
}
```
## Supported Things
-*Note:* So far only the Floureon Thermostat and Rm Mini 3 devices has been tested! The other things are "best guess" implementations.
+_Note:_ So far only the Floureon Thermostat and Rm Mini 3 devices has been tested! The other things are "best guess" implementations.
| Things | Description | Thing Type |
|-------------------------|---------------------------------------------------------------------|----------------------|
demo.things:
-```
+```java
Thing broadlinkthermostat:floureonthermostat:bathroomthermostat "Bathroom Thermostat" [ host="192.168.0.23", macAddress="00:10:FA:6E:38:4A"]
```
demo.items:
-```
+```java
Number:Temperature Bathroom_Thermostat_Temperature "Room temperature [%.1f %unit%]" <temperature> { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:roomtemperature"}
Number:Temperature Bathroom_Thermostat_Temperature_Ext "Room temperature (ext) [%.1f %unit%]" <temperature> { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:roomtemperature"}
Number:Temperature Bathroom_Thermostat_Setpoint "Setpoint [%.1f %unit%]" <temperature> { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:setpoint"}
bsblan.things:
-```
+```java
Bridge bsblan:bridge:heating [host="192.168.1.100", refreshInterval=30, username="atari", password="800xl"] {
Thing parameter p700 [id=700]
Thing parameter p710 [id=710]
bsblan.items:
-```
+```java
Number BsbParameter700NumberValue { channel="bsblan:parameter:heating:p700:number-value" }
Number BsbParameter710NumberValue { channel="bsblan:parameter:heating:p710:number-value" }
String BsbParameter8730Description { channel="bsblan:parameter:heating:p8730:description" }
bsblan.sitemap:
-```
+```perl
sitemap bsblan label="BSB-LAN" {
Selection item=BsbParameter700NumberValue label="Operating Mode" mappings=[0="Protection", 1="Automatic", 2="Reduced", 3="Comfort"] icon="heating"
Setpoint item=BsbParameter710NumberValue label="Room Temperature Comfort Setpoint [%.1f °C]" icon="temperature" minValue=22.0 maxValue=25.0 step=0.5
All BTicino Smarther Chronothermostat device models should be discoverable through this binding:
-* Flush mounting installation item (X8000)
-* Wall installation item (X8000W)
+- Flush mounting installation item (X8000)
+- Wall installation item (X8000W)
If you can control them from BTicino Thermostat mobile app on your iPhone/Android you should be able to add it as a thing.
### Account Creation
-Follow the instructions in the tutorial [here](https://developer.legrand.com/tutorials/getting-started/), under:
+Follow the instructions in the tutorial [here](https://developer.legrand.com/tutorials/getting-started/), under:
-* Step 1 : Create an account
-* Step 2 : Subscribe to a product and get subscription key
+- Step 1 : Create an account
+- Step 2 : Subscribe to a product and get subscription key
There's also a Step 3 in this tutorial, you can skip it as not needed to complete this process.
Simply write down your "Primary Key" as it will be needed later on in the bridge configuration phase.
### Application Creation
-Follow the instructions in the tutorial [here](https://developer.legrand.com/tutorials/create-an-application/), under:
+Follow the instructions in the tutorial [here](https://developer.legrand.com/tutorials/create-an-application/), under:
-* Step 1 : Register your application
-* Step 2 : Check scopes
-* Step 3 : Getting application details
+- Step 1 : Register your application
+- Step 2 : Check scopes
+- Step 3 : Getting application details
When registering your new Legrand Application for openHAB BTicino Smarther Bridge you have to specify the allowed Reply URL, aka white-listed address.
Here you have to specify the URL to the Bridge Authorization page on your server.
-For example if you run your openHAB server on http://openhabianpi:8080 you should set `http://openhabianpi:8080/bticinosmarther/connectsmarther` as the "First Reply URL" required field in Step 1.
+For example if you run your openHAB server on `http://openhabianpi:8080` you should set `http://openhabianpi:8080/bticinosmarther/connectsmarther` as the "First Reply URL" required field in Step 1.
Other Reply URLs (second, third, etc.) you can leave them blank.
This is **very important** since the authorize process with Legrand takes place using your client web browser and Legrand will have to know the right URL to your openHAB server for the authorization to be completed.
### Bridge Configuration
1. Install the binding and make sure the _BTicino Smarther Binding_ is listed on your server, if you have not already done so.
-2. Complete the [Account Creation](#account-creation) and [Application Creation](#application-creation) steps, if you have not already done so.
-3. Make sure you have your Legrand account _Primary Key_ and your Legrand application _Client ID_ and _Client Secret_ identities available.
-4. Go to your preferred openHAB admin UI and add a new Thing - select the **"BTicino Smarther Bridge"**.
-5. Choose new Id for the bridge, unless you like the generated one.
-6. Put in your _Primary Key_ (in _Subscription Key_ field), _Client ID_ and _Cliend Secret_ in their respective fields of the bridge configuration.
-7. Set _Use Notifications_ to `ON` if your openHAB server is reachable from a public https URL (see [Note on notifications](#note-on-notifications)), set `OFF` otherwise.
-8. You can leave the _Bridge Status Refresh Period_ as is.
-9. Save the bridge.
-10. The bridge thing will stay in state _INITIALIZING_ and eventually go _OFFLINE_ - this is fine, as you now have to authorize this bridge with Legrand.
-11. Go to the authorization page of your server (see [Application Creation](#application-creation)) `http://<your openHAB address>:<your openHAB port>/bticinosmarther/connectsmarther`; your newly added bridge should be listed there (along with the available locations).
-12. Press the _"Authorize Bridge"_ button; this will take you either to the login page of Legrand portal or directly to the authorization screen.
-13. Login and/or authorize the application; if the Reply URL is correct you will be returned and the entry should show your bridge is authorized with your Client ID; otherwise, go back to your application configuration on Legrand portal and ensure you have set the right Reply URL (see [Troubleshooting](#troubleshooting) below).
-14. The bridge will be updated with a refresh token and go _ONLINE_ (the refresh token is used to re-authorize the bridge with Legrand Smarther API whenever required).
+1. Complete the [Account Creation](#account-creation) and [Application Creation](#application-creation) steps, if you have not already done so.
+1. Make sure you have your Legrand account _Primary Key_ and your Legrand application _Client ID_ and _Client Secret_ identities available.
+1. Go to your preferred openHAB admin UI and add a new Thing - select the **"BTicino Smarther Bridge"**.
+1. Choose new Id for the bridge, unless you like the generated one.
+1. Put in your _Primary Key_ (in _Subscription Key_ field), _Client ID_ and _Cliend Secret_ in their respective fields of the bridge configuration.
+1. Set _Use Notifications_ to `ON` if your openHAB server is reachable from a public https URL (see [Note on notifications](#note-on-notifications)), set `OFF` otherwise.
+1. You can leave the _Bridge Status Refresh Period_ as is.
+1. Save the bridge.
+1. The bridge thing will stay in state _INITIALIZING_ and eventually go _OFFLINE_ - this is fine, as you now have to authorize this bridge with Legrand.
+1. Go to the authorization page of your server (see [Application Creation](#application-creation)) `http://<your openHAB address>:<your openHAB port>/bticinosmarther/connectsmarther`; your newly added bridge should be listed there (along with the available locations).
+1. Press the _"Authorize Bridge"_ button; this will take you either to the login page of Legrand portal or directly to the authorization screen.
+1. Login and/or authorize the application; if the Reply URL is correct you will be returned and the entry should show your bridge is authorized with your Client ID; otherwise, go back to your application configuration on Legrand portal and ensure you have set the right Reply URL (see [Troubleshooting](#troubleshooting) below).
+1. The bridge will be updated with a refresh token and go _ONLINE_ (the refresh token is used to re-authorize the bridge with Legrand Smarther API whenever required).
When configuring the bridge (see step 13 [here](#thing-configuration)), you can receive the following error from Legrand portal:
-```
+```json
{
"error": "invalid_request",
"error_description": "The reply url host xxxxx doesn't match with the ones configured on the application"
To solve the issue, either:
-* Correct the address you're accessing the `/bticinosmarther/connectsmarther` page from, to match the "Reply URL" attribute registered in your application, or
-* Should you have specified a wrong "Reply URL" attribute in your application, go to the Legrand portal and correct it accordingly then resubmit the application for approval.
+- Correct the address you're accessing the `/bticinosmarther/connectsmarther` page from, to match the "Reply URL" attribute registered in your application, or
+- Should you have specified a wrong "Reply URL" attribute in your application, go to the Legrand portal and correct it accordingly then resubmit the application for approval.
## Channels
bticinosmarther.things:
-```
+```java
Bridge bticinosmarther:bridge:mybridge "BTicino Smarther Bridge" [subscriptionKey="<your primary key>" clientId="<your client id>", clientSecret="<your client secret>"] {
Thing module thermo1 "Thermo 1" [plantId="<location plant id>" moduleId="<chronothermostat module id>"]
Thing module thermo2 "Thermo 2" [plantId="<location plant id>" moduleId="<chronothermostat module id>"]
bticinosmarther.items:
-```
+```java
// Measures items
Number:Temperature smaTemperature "In Temperature [%.1f %unit%]" { channel="bticinosmarther:module:mybridge:thermo1:measures#temperature" }
Number:Dimensionless smaHumidity "In Humidity [%.1f %unit%]" { channel="bticinosmarther:module:mybridge:thermo1:measures#humidity" }
bticinosmarther.sitemap:
-```
+```perl
sitemap bticinosmarther label="BTicino Smarther Sitemap" {
Frame label="Smarther Measures" {
bticinosmarther.rules:
-```
+```java
rule "BTicino Smarther - Set time visibility flag"
when
Item smaSetMode received update or Item smaSetDate received update
Legrand/BTicino Smarther topology considers the following dimensions:
-* topology : is the whole network of devices associated with a user account
-* plant : is the location where a module is installed (0..N plants per topology)
-* module : is the chronothermostat installed in a location (0..N modules per location)
+- topology : is the whole network of devices associated with a user account
+- plant : is the location where a module is installed (0..N plants per topology)
+- module : is the chronothermostat installed in a location (0..N modules per location)
You can add multiple bridges to allow controlling devices in the context of multiple Legrand user accounts.
# Buienradar Binding
-The Buienradar Binding periodically (5 minute intervals) retrieves rainfall predictions from the Dutch
-[buienradar.nl webservice API.](https://www.buienradar.nl/overbuienradar/gratis-weerdata).
+The Buienradar Binding periodically (5 minute intervals) retrieves rainfall predictions from the Dutch [buienradar.nl webservice API.](https://www.buienradar.nl/overbuienradar/gratis-weerdata).
-Using the binding, we can
+Using the binding, we can
-* warn of upcoming rainfall when there are open windows or doors
-* prevent watering the outside plants needlessly,
-* warn when we are about to leave the house.
+- warn of upcoming rainfall when there are open windows or doors
+- prevent watering the outside plants needlessly,
+- warn when we are about to leave the house.
## Supported Things
The configuration can be done by adding a Rain Forecast Thing using the UI, or by adding it to a `.things` file:
-```
+```java
Thing buienradar:rain_forecast:home [ location="52.198864211111925,5.4192629660193585" ]
```
and adding the relevant items as such in your `.items` file. Please note that the buienradar service only provides predictions in 5 minutes intervals with a maximum of two hours (120 minutes):
-```
+```java
Number RAIN_CURRENT "Current rain" (Rain) {channel="buienradar:rain_forecast:home:forecast_0" }
Number RAIN_5MIN "Rain 5 min." (Rain) {channel="buienradar:rain_forecast:home:forecast_5" }
Number RAIN_10MIN "Rain 10 min." (Rain) {channel="buienradar:rain_forecast:home:forecast_10" }
The mappings are as follows:
-* 0 – 0.01: None (rgba(204, 204, 204, 0))
-* 0.01 – 1: Very light (#badff4)
-* 1 – 5: Light (#6ed0e0)
-* 5 – 20: Medium (#1f78c1)
-* 20 – 50: Heavy (#ef843c)
-* 50 – 80: Very heavy (#e24d42)
-* 80 – 100: Extremely heavy (#890f02)
-
-
+- 0 – 0.01: None (rgba(204, 204, 204, 0))
+- 0.01 – 1: Very light (#badff4)
+- 1 – 5: Light (#6ed0e0)
+- 5 – 20: Medium (#1f78c1)
+- 20 – 50: Heavy (#ef843c)
+- 50 – 80: Very heavy (#e24d42)
+- 80 – 100: Extremely heavy (#890f02)
## Prerequisites
-For the binding to work the panel has also to be programmed appropriately.
+For the binding to work the panel has also to be programmed appropriately.
### Programming locations for the NX-8E control panel
The following is an example of a things file (caddx.things):
-```
+```java
Bridge caddx:bridge:thebridge "Bridge" [ protocol="Binary", serialPort="/dev/ttyUSB0", baud=38400, maxZoneNumber=18 ] {
Thing partition partition1 "Groundfloor alarm" [ partitionNumber=1 ]
Thing zone zone1 "Livingroom motion sensor" [ zoneNumber=1 ]
The following is an example of an items file (caddx.items):
-```
+```java
Group:Contact:OR(OPEN,CLOSED) MotionSensors "Motion Sensors [%s]" <motion>
Group:Contact:OR(OPEN,CLOSED) Windows "Windows open [%s]" <window>
The following is an example of a sitemap file (home.sitemap):
-```
+```perl
sitemap home label="Home" {
Frame label="Ground floor" {
Text item=Partition1_Armed
The following is a rule example with calling of an action on the binding
-```
+```java
rule "Zone Bypass on Chime Off"
when
Item caddx_partition_thebridge_partition1_partition_chime_mode_on changed from ON to OFF
First the CGate Connection bridge needs to be configured with the ip address of the computer running the C-Gate software.
After this a Bridge is creaed for each network configured on the CBus Network. The CBus Project Name and the network Id for that network
-
## Supported Things
This binding support 6 different things types
When a discovery scan is started in the UI, Things are discovered for the groups that are found on the CBus network.
-##Channels
+## Channels
At startup the binding will scan the network for the values of all the groups and set those on the appropriate channels.
It is not possible to fetch the value of a Trigger Group so those values will only be updated when a trigger is set on the CBus network.
Light things have 2 channels which show the current state of the group on the cbus network and can also set the state of the group:-
-* **state** - On/Off state of the light
-* **level** - The level of the channel between 0 and 100
+- **state** - On/Off state of the light
+- **level** - The level of the channel between 0 and 100
### Temperature
Temperature things have 1 channel which shows the current value. This is read-only and will not set the value on the CBus Network.
-* **temp** - Temperature value
+- **temp** - Temperature value
### Trigger
Trigger things have 1 channel which shows the current trigger value on the cbus network and can be used to set a trigger value on the CBus Network.
-* **value** - CBus Trigger value
+- **value** - CBus Trigger value
### Dali
Dali things have 1 channel which shows the current value on the cbus network and can be used to set a value on the CBus Network.
-* **level** - Value from the DALI node
+- **level** - Value from the DALI node
## Example
### cbus.things
-```
+```java
/* Need a cgate bridge to connect to cgate and then 1 network bridge for each network on that system */
Bridge cbus:cgate:cgatenetwork "file - cgate" [ ipAddress="127.0.0.1"] {
### cbus.items
-```
+```java
Dimmer light31Dimmer { channel="cbus:light:cgatenetwork:cbusnetwork:light31:level"}
Switch light31Switch { channel="cbus:light:cgatenetwork:cbusnetwork:light31:state"}
Number trigger1Value { channel="cbus:trigger:cgatenetwork:cbusnetwork:trigger1:value"}
### cbusdemo.sitemap
-```
+```perl
sitemap cbusdemo label="CBus Binding Demo"
{
Frame label="light" {
Configure a Callback URL when the Chromecast cannot connect using the Primary Address or Port, e.g. when:
-* proxying HTTP (port 80/443) using Apache/NGINX to openHAB (port 8080)
-* openHAB is running inside a Docker container that has its own IP Address
+- proxying HTTP (port 80/443) using Apache/NGINX to openHAB (port 8080)
+- openHAB is running inside a Docker container that has its own IP Address
## Supported Things
Auto-discovery is enabled by default.
To disable it, you can add the following line to `<openHAB-conf>/services/runtime.cfg`:
-```
+```shell
discovery.chromecast:background=false
```
This binding includes rule actions for casting media.
-* `playURL(String url)`
-* `playURL(String url, String mimeType)`
+- `playURL(String url)`
+- `playURL(String url, String mimeType)`
Examples:
-```
+```java
val castActions = getActions("chromecast","chromecast:chromecast:29fcf535da")
val success = castActions.playURL("http://192.168.1.160:81/mjpg/front1/video.mjpg")
val success2 = castActions.playURL("http://192.168.1.160:81/mjpg/front1/video.mjpg", "image/jpeg")
-
```
| switch | switchState | Switch | An On/Off switch |
| dimmer | lightDimmer | Dimmer | A dimmable device |
-**Example**
+### Example
-### Things
+#### Things
```perl
Bridge cm11a:cm11a:MyCm11a [ serialPort="COM3" ] {
}
```
-### Items
+#### Items
```java
SwitchA1 "Kitchen Plug" <light> (someGroup) { channel="cm11a:switch:MyCm11a:SwitchA1:switchstatus" }
## Known issues
-1. When openHAB starts up it doesn't restore the last state of each module. And, the cm11a does not provide a discovery service. Therefore it assumes everything off.
-2. The dimmer slider can get out of sync with the actual light because of the way X10 works. On some switches if you turn them on they will go to full bright and some switches will return to the previous dim level.
+1. When openHAB starts up it doesn't restore the last state of each module. And, the cm11a does not provide a discovery service. Therefore it assumes everything off.
+1. The dimmer slider can get out of sync with the actual light because of the way X10 works. On some switches if you turn them on they will go to full bright and some switches will return to the previous dim level.
## References
1. [CM11A (X10) Protocol Document](https://wanderingsamurai.net/electronics/cm11a-x10-protocol-document)
-2. [Heyu - control software for the cm11a](https://www.heyu.org/)
-3. cm11a Controllers are available for purchase from several sites on the internet
+1. [Heyu - control software for the cm11a](https://www.heyu.org/)
+1. cm11a Controllers are available for purchase from several sites on the internet
**NOTE:** This binding does not work with the ComfoAir Q-series (e.g. Q350 or Q450). These ventilation units use a CAN bus for communication and a different protocol.
-### Limitations
+## Limitations
-* Either the ComfoAir binding or the CCEase Comfocontrol can be active, but not together.
-* You must implement auto mode by yourself with rules, but it is more powerful.
+- Either the ComfoAir binding or the CCEase Comfocontrol can be active, but not together.
+- You must implement auto mode by yourself with rules, but it is more powerful.
-### Prerequisites
+## Prerequisites
Computer communication between ComfoAir device and openHAB via RS232 connection has to be set up.
The connection should be made with a 3-wire cable connecting pins: GND, TX, RX of RS232 sockets, but RX and TX pins should be crossed (TX of ComfoAir to RX of PC, RX of ComfoAir to TX of PC).
-### Serial Port Access Rights
+## Serial Port Access Rights
-* Take care that the user that runs openHAB has rights to access the serial port
-* On Ubuntu/Debian based systems (incl. openHABian) that usually means adding the user (e.g. openhab) to the group "dialout", i.e.
+- Take care that the user that runs openHAB has rights to access the serial port
+- On Ubuntu/Debian based systems (incl. openHABian) that usually means adding the user (e.g. openhab) to the group "dialout", i.e.
-```
+```shell
sudo usermod -a -G dialout openhab
```
## Supported Things
The binding supports thing types for different device types.
-They only differ in the available channels, where the generic *comfoair* thing type supports all available channels.
-If there is no thing type that matches your specific device you can safely choose the *comfoair* type.
+They only differ in the available channels, where the generic _comfoair_ thing type supports all available channels.
+If there is no thing type that matches your specific device you can safely choose the _comfoair_ type.
|Thing Type ID |Description |
|--------------|-----------------------------------------------------------------------------|
`.things` file:
-```
+```java
Thing comfoair:comfoair:myComfoAir "ComfoAir" [serialPort="/dev/ttyUSB0", refreshInterval="60"]
```
`.items` file:
-```
-Switch comfoairControl "Activate" <computer> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:bindingControl#activate"}
-Number comfoairFanLevel "Ventilation level [%d]" <chart> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanLevel"}
-Number comfoairErrorReset "Error reset" <service> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:resets#errorReset"}
-Number comfoairFilterReset "Filter reset" <service> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:resets#filterReset"}
-Number comfoairFilterPeriod "Filter period [%d weeks]" <clock> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP2#filterWeeks"}
+```java
+Switch comfoairControl "Activate" <computer> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:bindingControl#activate"}
+Number comfoairFanLevel "Ventilation level [%d]" <chart> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanLevel"}
+Number comfoairErrorReset "Error reset" <service> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:resets#errorReset"}
+Number comfoairFilterReset "Filter reset" <service> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:resets#filterReset"}
+Number comfoairFilterPeriod "Filter period [%d weeks]" <clock> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP2#filterWeeks"}
// Messages
-String comfoairError "Error: [%s]" (ComfoAir) {channel="comfoair:comfoair:myComfoAir:errors#errorsCurrent"}
-Number:Time comfoairFilterRuntime "Filter runtime [%.0f h]" (ComfoAir) {channel="comfoair:comfoair:myComfoAir:times#filterHours"}
+String comfoairError "Error: [%s]" (ComfoAir) {channel="comfoair:comfoair:myComfoAir:errors#errorsCurrent"}
+Number:Time comfoairFilterRuntime "Filter runtime [%.0f h]" (ComfoAir) {channel="comfoair:comfoair:myComfoAir:times#filterHours"}
// State
-Number:Temperature comfoairTargetTemperature "Comfort temperature [%.1f °C]" <temperature> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:temperatures#targetTemperature"}
-Number:Temperature comfoairOutdoorIncomingTemperature "Inlet air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#outdoorTemperatureIn"}
-Number:Temperature comfoairIndoorIncomingTemperature "Supply air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#indoorTemperatureIn"}
-Number:Temperature comfoairIndoorOutgoingTemperature "Return air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#indoorTemperatureOut"}
-Number:Temperature comfoairOutdoorOutgoingTemperature "Exhaust air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#outdoorTemperatureOut"}
-Number comfoairIncomingFan "Supply capacity [%d %%]" <fan_in> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanInPercent"}
-Number comfoairOutgoingFan "Exhaust capacity [%d %%]" <fan_out> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanOutPercent"}
-Number comfoairFanIn0 "Supply capacity - level 0 [%d %%]" <fan_in> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanIn0"}
-Number comfoairFanOut0 "Exhaust capacity - level 0 [%d %%]" <fan_out> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanOut0"}
-Switch comfoairBypassMode "Bypass [MAP(comfoair_bypass.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#bypassState"}
-Switch comfoairGHXMode "GHX [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#ewtState"}
-Switch comfoairChimneyMode "Fire programme [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#chimneyState"}
-Switch comfoairHeaterMode "Heater [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#heaterState"}
-Switch comfoairCookerHoodMode "Extractor hood [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#cookerhoodState"}
-Switch comfoairEnthalpyMode "Enthalpy [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#enthalpyState"}
-Switch comfoairFreezeMode "Freeze [MAP(comfoair_freeze.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#frostState"}
+Number:Temperature comfoairTargetTemperature "Comfort temperature [%.1f °C]" <temperature> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:temperatures#targetTemperature"}
+Number:Temperature comfoairOutdoorIncomingTemperature "Inlet air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#outdoorTemperatureIn"}
+Number:Temperature comfoairIndoorIncomingTemperature "Supply air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#indoorTemperatureIn"}
+Number:Temperature comfoairIndoorOutgoingTemperature "Return air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#indoorTemperatureOut"}
+Number:Temperature comfoairOutdoorOutgoingTemperature "Exhaust air temperature [%.1f °C]" <temperature> (ComfoAir, comfoairTemps_Chart) {channel="comfoair:comfoair:myComfoAir:temperatures#outdoorTemperatureOut"}
+Number comfoairIncomingFan "Supply capacity [%d %%]" <fan_in> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanInPercent"}
+Number comfoairOutgoingFan "Exhaust capacity [%d %%]" <fan_out> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanOutPercent"}
+Number comfoairFanIn0 "Supply capacity - level 0 [%d %%]" <fan_in> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanIn0"}
+Number comfoairFanOut0 "Exhaust capacity - level 0 [%d %%]" <fan_out> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:ventilation#fanOut0"}
+Switch comfoairBypassMode "Bypass [MAP(comfoair_bypass.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#bypassState"}
+Switch comfoairGHXMode "GHX [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#ewtState"}
+Switch comfoairChimneyMode "Fire programme [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#chimneyState"}
+Switch comfoairHeaterMode "Heater [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#heaterState"}
+Switch comfoairCookerHoodMode "Extractor hood [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#cookerhoodState"}
+Switch comfoairEnthalpyMode "Enthalpy [MAP(comfoair_on-off.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#enthalpyState"}
+Switch comfoairFreezeMode "Freeze [MAP(comfoair_freeze.map):%s]" <climate> (ComfoAir) {channel="comfoair:comfoair:myComfoAir:menuP9#frostState"}
```
`.sitemap` file:
-```
+```perl
sitemap comfoair label="ComfoAir" {
- Frame label="Main" {
- Text item=comfoairError labelcolor=[!="No Errors"="red"] valuecolor=[!="No Errors"="red"]
- Switch item=comfoairControl mappings=[OFF="CCEase", ON="Computer"]
- Switch item=comfoairErrorReset mappings=[1="Reset"]
- Switch item=comfoairFilterReset mappings=[1="Reset"]
- }
- Frame label="Control" {
- Selection item=comfoairFanLevel
- Setpoint item=comfoairTargetTemperature step=0.5 minValue=15 maxValue=28 valuecolor=["black"]
- }
- Frame label="State" {
- Text item=comfoairOutdoorIncomingTemperature valuecolor=["black"]
- Text item=comfoairOutdoorOutgoingTemperature valuecolor=["black"]
- Text item=comfoairIndoorIncomingTemperature valuecolor=["black"]
- Text item=comfoairIndoorOutgoingTemperature valuecolor=["black"]
- }
- Frame {
- Text item=comfoairIncomingFan valuecolor=["black"]
- Text item=comfoairBypassMode valuecolor=["black"]
- Text item=comfoairOutgoingFan valuecolor=["black"]
- Text item=comfoairGHXMode valuecolor=[OFF="silver", ON="black"]
- Text item=comfoairEfficiency valuecolor=["black"]
- Text item=comfoairFreezeMode valuecolor=[OFF="black", ON="red"]
- Text item=comfoairFilterRuntime_Message valuecolor=["black"]
- Text item=comfoairChimneyMode valuecolor=[OFF="silver", ON="black"]
- }
+ Frame label="Main" {
+ Text item=comfoairError labelcolor=[!="No Errors"="red"] valuecolor=[!="No Errors"="red"]
+ Switch item=comfoairControl mappings=[OFF="CCEase", ON="Computer"]
+ Switch item=comfoairErrorReset mappings=[1="Reset"]
+ Switch item=comfoairFilterReset mappings=[1="Reset"]
+ }
+ Frame label="Control" {
+ Selection item=comfoairFanLevel
+ Setpoint item=comfoairTargetTemperature step=0.5 minValue=15 maxValue=28 valuecolor=["black"]
+ }
+ Frame label="State" {
+ Text item=comfoairOutdoorIncomingTemperature valuecolor=["black"]
+ Text item=comfoairOutdoorOutgoingTemperature valuecolor=["black"]
+ Text item=comfoairIndoorIncomingTemperature valuecolor=["black"]
+ Text item=comfoairIndoorOutgoingTemperature valuecolor=["black"]
+ }
+ Frame {
+ Text item=comfoairIncomingFan valuecolor=["black"]
+ Text item=comfoairBypassMode valuecolor=["black"]
+ Text item=comfoairOutgoingFan valuecolor=["black"]
+ Text item=comfoairGHXMode valuecolor=[OFF="silver", ON="black"]
+ Text item=comfoairEfficiency valuecolor=["black"]
+ Text item=comfoairFreezeMode valuecolor=[OFF="black", ON="red"]
+ Text item=comfoairFilterRuntime_Message valuecolor=["black"]
+ Text item=comfoairChimneyMode valuecolor=[OFF="silver", ON="black"]
+ }
}
```
`comfoair_bypass.map` file:
-```
+```text
ON=Opened
OFF=Closed
undefined=unknown
`comfoair_on-off.map` file:
-```
+```text
ON=active
OFF=inactive
undefined=unknown
`comfoair_freeze.map` file:
-```
+```text
ON=frozen
OFF=OK
undefined=unknown
# CoronaStats Binding
-This binding provides the statistic about cases of COVID-19 from the website https://corona-stats.online/.
-
+This binding provides the statistic about cases of COVID-19 from the website [https://corona-stats.online/](https://corona-stats.online/).
## Supported Things
## Discovery
-This binding adds a default `world` thing to the Inbox.
+This binding adds a default `world` thing to the Inbox.
This can be used as bridge for country things you may add manually.
## Thing Configuration
| ------------- | :-----: | :------: | ------------------------------------------------- |
| `countryCode` | - | yes | 2-letter code for the country you want to display |
-For the correct 2-letter country code have a look at the website https://corona-stats.online/
+For the correct 2-letter country code have a look at the website [https://corona-stats.online/](https://corona-stats.online/)
## Channels
### Things
-```
+```java
Bridge coronastats:world:stats "Corona Stats World" @ "Corona" [refresh=15] {
Thing country usa "Corona Stats USA" @ "Corona" [countryCode="US"]
Thing country germany "Corona Stats Germany" @ "Corona" [countryCode="DE"]
### Items
-```
+```java
Number:Dimensionless coronaCasesWorld "Total Cases World [%,d]"
{channel="coronastats:world:stats:cases"}
### Sitemap
-```
+```perl
Text label="Corona" {
Frame label="World" {
Text item=coronaCasesWorld
Background discovery polls the network every minute for devices.
Background discovery is **enabled** by default.
-To **disable** background discovery, add the following line to the *conf/services/runtime.cfg* file:
+To **disable** background discovery, add the following line to the _conf/services/runtime.cfg_ file:
```text
discovery.daikin:background=false
## Thing Configuration
-* `host` - The hostname of the Daikin air conditioner. Typically you'd use an IP address such as `192.168.0.5` for this field.
-* `refresh` - The frequency with which to refresh information from the Daikin air conditioner specified in seconds. Defaults to 60 seconds.
+- `host` - The hostname of the Daikin air conditioner. Typically you'd use an IP address such as `192.168.0.5` for this field.
+- `refresh` - The frequency with which to refresh information from the Daikin air conditioner specified in seconds. Defaults to 60 seconds.
### Additional Thing configurations for BRP072C42 adapter
-* `secure` - Must be set to true for BRP072C42 to access it through https.
-* `uuid` - A UUID used to access the BRP072C42 adapter. A handy UUID generator can be found at <https://www.uuidgenerator.net/>.
-* `key` - The 13-digit key from the Daikin adapter.
+- `secure` - Must be set to true for BRP072C42 to access it through https.
+- `uuid` - A UUID used to access the BRP072C42 adapter. A handy UUID generator can be found at <https://www.uuidgenerator.net/>.
+- `key` - The 13-digit key from the Daikin adapter.
## Channels
daikin.things:
-```
+```java
// for BRP069B41 or BRP072A42
daikin:ac_unit:living_room_ac [ host="192.168.0.5" ]
// for BRP072C42
daikin.items:
-```
+```java
// for BRP069B41, BRP072A42 or BRP072C42
Switch DaikinACUnit_Power { channel="daikin:ac_unit:living_room_ac:power" }
Number:Temperature DaikinACUnit_SetPoint { channel="daikin:ac_unit:living_room_ac:settemp" }
daikin.sitemap:
-```
+```perl
// for BRP069B41, BRP072A42 or BRP072C42
Switch item=DaikinACUnit_Power
Setpoint item=DaikinACUnit_SetPoint visibility=[DaikinACUnit_Power==ON]
Currently, these things are supported:
- - daliserver (bridge)
- - device (single device/ballast on the DALI bus)
- - group (group of DALI devices)
- - rgb (virtual device consisting of three directly addressed devices that represent r/g/b (LED) color channels)
- - device-dt8 (single device/ballast supporting DT8 (single-channel RGB & color temperature control))
- - group-dt8 (group of DALI devices supporting DT8)
-
+- daliserver (bridge)
+- device (single device/ballast on the DALI bus)
+- group (group of DALI devices)
+- rgb (virtual device consisting of three directly addressed devices that represent r/g/b (LED) color channels)
+- device-dt8 (single device/ballast supporting DT8 (single-channel RGB & color temperature control))
+- group-dt8 (group of DALI devices supporting DT8)
+
This binding was tested on a DALI 1 bus with daliserver 0.2.
## Discovery
.things file
-```
+```java
Bridge dali:daliserver:237dbae7 "Daliserver" [ host="localhost", port=55825] {
Thing rgb 87bf0403-a45d-4037-b874-28f4ece30004 "RGB Lights" [ targetIdR=0, targetIdG=1, targetIdB=2 ]
Thing device 995e16ca-07c4-4111-9cda-504cb5120f82 "Warm White" [ targetId=3 ]
}
```
-
.items file
-```
+```java
Dimmer WarmWhiteLivingRoom "Warm White Living Room" {channel="dali:device:237dbae7:995e16ca-07c4-4111-9cda-504cb5120f82:dimImmediately"}
Color ColorLivingRoom "Light Color Living Room" {channel="dali:device:237dbae7:87bf0403-a45d-4037-b874-28f4ece30004:color"}
Switch LightsLivingRoom "Lights Living Room On/Off" {channel="dali:device:237dbae7:31da8dac-8e09-455a-bc7a-6ed70f740001:dimImmediately"}
# DanfossAirUnit Binding
This binding supports controlling and monitoring [Danfoss air units](https://www.danfoss.com/en/products/energy-recovery-devices/dhs/heat-recovery-ventilation/air-units/) via Ethernet connection.
-
+
## Supported Things
-This binding has been tested/reported to work with the Danfoss Air w2 / a2 / a3 devices.
+This binding has been tested/reported to work with the Danfoss Air w2 / a2 / a3 devices.
## Discovery
-Air units in the LAN are automatically discovered via broadcast and added to the Inbox.
+Air units in the LAN are automatically discovered via broadcast and added to the Inbox.
## Thing Configuration
These are the available configuration parameters:
- `host` Hostname/IP of the air unit (automatically set by discovery service)
-- `refreshInterval` Time (in seconds) between monitoring requests to the air unit. Smaller values mean more network load, typically set between a few seconds and a minute. Defaults to 10 seconds.
-- `updateUnchangedValuesEveryMillis` Minimum time between state updates sent to the event bus for a particular channel when the state of the channel didn't change. This should avoid spamming the event bus with unnecessary updates. When set to 0, all channel state are updated every time the air unit requests are sent (see refresh interval). When set to a non zero value, unchanged values are only reported after the configured timespan has passed. Changed values are always sent to the event bus. Defaults to 60.000 (one minute), so updates are sent every minute or if the state of the channel changes.
+- `refreshInterval` Time (in seconds) between monitoring requests to the air unit. Smaller values mean more network load, typically set between a few seconds and a minute. Defaults to 10 seconds.
+- `updateUnchangedValuesEveryMillis` Minimum time between state updates sent to the event bus for a particular channel when the state of the channel didn't change. This should avoid spamming the event bus with unnecessary updates. When set to 0, all channel state are updated every time the air unit requests are sent (see refresh interval). When set to a non zero value, unchanged values are only reported after the configured timespan has passed. Changed values are always sent to the event bus. Defaults to 60.000 (one minute), so updates are sent every minute or if the state of the channel changes.
## Channels
| filter_life | service | Number | RO | Remaining life of filter until exchange is necessary (percentage) |
| filter_period | service | Number | RW | Number of months between filter replacements (between 3 and 12). This value affects calculation of filter_life by the unit, and might get overwritten by Air Dial or Link CC Controller. |
-
## Full Example
### Things
(e. g. if you want to have a portable configuration):
Create a new file, e. g. `danfoss.things`, in your _things_ configuration folder:
-```
+```java
Thing danfossairunit:airunit:myairunit [host="192.168.0.7",
refreshInterval=5,
updateUnchangedValuesEveryMillis=30000]
### Items
-```
+```java
Dimmer DanfossHRV_ManualFanStep "Manual Fan Step [%s]" {channel = "danfossairunit:airunit:myairunit:main#manual_fan_step"}
Number DanfossHRV_SupplyFanSpeed "Supply Fan Speed" {channel = "danfossairunit:airunit:myairunit:main#supply_fan_speed"}
Number DanfossHRV_ExtractFanSpeed "Extract Fan Speed" {channel = "danfossairunit:airunit:myairunit:main#extract_fan_speed"}
### Sitemap
-```
+```perl
sitemap danfoss label="Danfoss" {
Frame label="Control" {
Selection item=DanfossHRV_Mode mappings=[DEMAND="Demand", OFF="Off", PROGRAM="Program", MANUAL="Manual"]
Some use cases can be:
- Integrate a device that stores its data in a database
-- Query derived data from you openHAB persistence, for example with Influx2 tasks you can process your data to create a new one
+- Query derived data from you openHAB persistence, for example with Influx2 tasks you can process your data to create a new one
- Bypass limitations of current openHAB persistence queries
## Supported Things
### query
-The `Query` thing defines a native query that provides several channels that you can bind to items.
+The `Query` thing defines a native query that provides several channels that you can bind to items.
#### Query parameters
|--------------|----------|----------|-----------------------------------------------------------------------|
| query | true | | Query string in native syntax |
| interval | false | 0 | Interval in seconds in which the query is automatically executed |
-| hasParameters| false | false | True if the query has parameters, false otherwise |
+| hasParameters| false | false | True if the query has parameters, false otherwise |
| timeout | false | 0 | Query execution timeout in seconds |
| scalarResult | false | true | If query always returns a single value or not |
| scalarColumn | false | | In case of multiple columns, it indicates which to use for scalarResult|
The query the items represents in the native language of your database:
- - Flux for `influxdb2`
-
+- Flux for `influxdb2`
+
#### hasParameters
If `hasParameters=true` you can use parameters in the query string that can be dynamically set with the `setQueryParameters` action.
-
+
For InfluxDB use the `${paramName}` syntax for each parameter, and keep in mind that the values from that parameters must be from a trusted source as current
parameter substitution is subject to query injection attacks.
-
+
#### timeout
A time-out in seconds to wait for the query result, if it's exceeded, the result will be discarded and the addon will do its best to cancel the query.
Currently it's ignored and it will be implemented in a future version.
-#### scalarResult
+#### scalarResult
If `true` the query is expected to return a single scalar value that will be available to `result` channels as string, number, boolean,...
If the query can return several rows and/or several columns per row then it needs to be set to `false` and the result can be retrieved in `resultString`
-channel as JSON or using the `getLastQueryResult` action.
+channel as JSON or using the `getLastQueryResult` action.
#### scalarColumn
The `resultString` channel is the only valid one if `scalarResult=false`, and in that case it contains the query result serialized to JSON in that format:
- {
- correct : true,
- data : [
- {
- column1 : value,
- column2 : value
- },
- { ... }, //row2
- { ... } //row3
- ]
- }
-
+```json
+{
+ correct : true,
+ data : [
+ {
+ column1 : value,
+ column2 : value
+ },
+ { ... }, //row2
+ { ... } //row3
+ ]
+}
+```
+
### Channel Triggers
#### calculateParameters
Triggers when there's a need to calculate parameters before query execution.
When a query has `hasParameters=true` it fires the `calculateParameters` channel trigger and pauses the execution until `setQueryParameters` action is call in
that query.
-
+
In the case a query has parameters, it's expected that there is a rule that catches the `calculateParameters` trigger, calculate the parameters with the corresponding logic and then calls the `setQueryParameters` action, after that the query will be executed.
-
+
## Actions
### For DatabaseBridge
-#### executeQuery
+#### executeQuery
It allows executing a query synchronously from a script/rule without defining it in a Thing.
- isScalarResult: It returns if the result is scalar one (only one row with one column)
- resultAsScalar: It returns the result as a scalar if possible, if not returns null
-
Example (using Jython script):
- from core.log import logging, LOG_PREFIX
- log = logging.getLogger("{}.action_example".format(LOG_PREFIX))
- map = {"time" : "-2h"}
- influxdb = actions.get("dbquery","dbquery:influxdb2:sampleQuery") //Get bridge thing
- result = influxdb.executeQuery("from(bucket: \"default\") |> range(start:-2h) |> filter(fn: (r) => r[\"_measurement\"] == \"go_memstats_frees_total\") |> filter(fn: (r) => r[\"_field\"] == \"counter\") |> mean()",{},5)
- log.info("execute query result is "+str(result.data))
-
+```python
+from core.log import logging, LOG_PREFIX
+log = logging.getLogger("{}.action_example".format(LOG_PREFIX))
+map = {"time" : "-2h"}
+influxdb = actions.get("dbquery","dbquery:influxdb2:sampleQuery") //Get bridge thing
+result = influxdb.executeQuery("from(bucket: \"default\") |> range(start:-2h) |> filter(fn: (r) => r[\"_measurement\"] == \"go_memstats_frees_total\") |> filter(fn: (r) => r[\"_field\"] == \"counter\") |> mean()",{},5)
+log.info("execute query result is "+str(result.data))
+```
Use this action with care, because as the query is executed synchronously, it is not good to execute long-running queries that can block script execution.
Example (using Jython script):
- params = {"time" : "-2h"}
- dbquery = actions.get("dbquery","dbquery:query:queryWithParams") //Get query thing
- dbquery.setQueryParameters(params)
+```python
+params = {"time" : "-2h"}
+dbquery = actions.get("dbquery","dbquery:query:queryWithParams") //Get query thing
+dbquery.setQueryParameters(params)
+```
#### getLastQueryResult
Example (using Jython script):
- dbquery = actions.get("dbquery","dbquery:query:queryWithParams") //Get query thing
- result = dbquery.getLastQueryResult()
-
+```python
+dbquery = actions.get("dbquery","dbquery:query:queryWithParams") //Get query thing
+result = dbquery.getLastQueryResult()
+```
## Examples
-### The Simplest case
+### The Simplest case
Define an InfluxDB2 database thing and a query with an interval execution.
That executes the query every 15 seconds and punts the result in `myItem`.
- # Bridge Thing definition
- Bridge dbquery:influxdb2:mydatabase "InfluxDB2 Bridge" [ bucket="default", user="admin", url="http://localhost:8086", organization="openhab", token="*******" ]
-
- # Query Thing definition
- Thing dbquery:query:myquery "My Query" [ interval=15, hasParameters=false, scalarResult=true, timeout=0, query="from(bucket: \"default\") |> range(start:-1h) |> filter(fn: (r) => r[\"_measurement\"] == \"go_memstats_frees_total\") |> filter(fn: (r) => r[\"_field\"] == \"counter\") |> mean()", scalarColumn="_value" ]
-
- # Item definition
- Number myItem "QueryResult" {channel="dbquery:query:myquery:resultNumber"}
+```java
+# Bridge Thing definition
+Bridge dbquery:influxdb2:mydatabase "InfluxDB2 Bridge" [ bucket="default", user="admin", url="http://localhost:8086", organization="openhab", token="*******" ]
+
+# Query Thing definition
+Thing dbquery:query:myquery "My Query" [ interval=15, hasParameters=false, scalarResult=true, timeout=0, query="from(bucket: \"default\") |> range(start:-1h) |> filter(fn: (r) => r[\"_measurement\"] == \"go_memstats_frees_total\") |> filter(fn: (r) => r[\"_field\"] == \"counter\") |> mean()", scalarColumn="_value" ]
+
+# Item definition
+Number myItem "QueryResult" {channel="dbquery:query:myquery:resultNumber"}
+```
### A query with parameters
Using the previous example you change the `range(start:-1h)` for `range(start:${time})`
-Create a rule that is fired
+Create a rule that is fired
+
+- **When** `calculateParameters` is triggered in `myquery`
+- **Then** executes the following script action (in that example Jython):
- - **When** `calculateParameters` is triggered in `myquery`
- - **Then** executes the following script action (in that example Jython):
-
- map = {"time" : "-2h"}
- dbquery = actions.get("dbquery","dbquery:query:myquery")
- dbquery.setQueryParameters(map)
+```text
+map = {"time" : "-2h"}
+dbquery = actions.get("dbquery","dbquery:query:myquery")
+dbquery.setQueryParameters(map)
+```
| Air quality Sensor | ZHAAirQuality | `airqualitysensor` |
| Color Controller | ZBT-Remote-ALL-RGBW | `colorcontrol` |
-
Additionally lights, window coverings (blinds), door locks and thermostats are supported:
| Device type | Resource Type | Thing type |
### Things
All non-bridge things share the mandatory `id` parameter, an integer assigned to the device while pairing to deconz.
-Auto-discovered things do not need to be configured.
+Auto-discovered things do not need to be configured.
All sensor-things have an additional `lastSeenPolling` parameter.
Due to limitations in the API of deCONZ, the `lastSeen` channel (available some sensors) is only available when using polling.
If you use the textual configuration, the thing file without an API key will look like this, for example:
-```
+```java
Bridge deconz:deconz:homeserver [ host="192.168.0.10" ]
```
The generated key can be queried from the configuration using the openHAB console.
To do this log into the [console](https://www.openhab.org/docs/administration/console.html) and use the command `things show` to display the configuration parameters, e.g:
-```
+```shell
things show deconz:deconz:homeserver
```
Afterwards the API key has to be inserted in the `.thing` file as `apikey` configuration value, e.g.:
-```
+```java
Bridge deconz:deconz:homeserver [ host="192.168.0.10", apikey="ABCDEFGHIJ" ]
```
| Channel Type ID | Item Type | Access Mode | Description | Thing types |
|-------------------|--------------------------|:-----------:|---------------------------------------|-------------------------------------------------|
-| brightness | Dimmer | R/W | Brightness of the light | `dimmablelight`, `colortemperaturelight` |
+| brightness | Dimmer | R/W | Brightness of the light | `dimmablelight`, `colortemperaturelight` |
| switch | Switch | R/W | State of an ON/OFF device | `onofflight` |
| color | Color | R/W | Color of an multi-color light | `colorlight`, `extendedcolorlight`, `lightgroup`|
| color_temperature | Number | R/W | Color temperature in Kelvin. The value range is determined by each individual light | `colortemperaturelight`, `extendedcolorlight`, `lightgroup` |
| effect | String | R/W | Effect selection. Allowed commands are set dynamically | `colorlight` |
| effectSpeed | Number | W | Effect Speed | `colorlight` |
-| lock | Switch | R/W | Lock (ON) or unlock (OFF) the doorlock| `doorlock` |
+| lock | Switch | R/W | Lock (ON) or unlock (OFF) the doorlock| `doorlock` |
| ontime | Number:Time | W | Timespan for which the light is turned on | all lights |
| position | Rollershutter | R/W | Position of the blind | `windowcovering` |
| heatsetpoint | Number:Temperature | R/W | Target Temperature in °C | `thermostat` |
| alert | String | W | Turn alerts on. Allowed commands are `none`, `select` (short blinking), `lselect` (long blinking) | `warningdevice`, `lightgroup`, `dimmablelight`, `colorlight`, `extendedcolorlight`, `colortemperaturelight` |
| all_on | Switch | R | All lights in group are on | `lightgroup` |
| any_on | Switch | R | Any light in group is on | `lightgroup` |
-| scene | String | W | Recall a scene. Allowed commands are set dynamically | `lightgroup` |
+| scene | String | W | Recall a scene. Allowed commands are set dynamically | `lightgroup` |
**NOTE:** For groups `color` and `color_temperature` are used for sending commands to the group.
Their state represents the last command send to the group, not necessarily the actual state of the group.
## Full Example
-### Things file ###
+### Things file
-```
+```java
Bridge deconz:deconz:homeserver [ host="192.168.0.10", apikey="ABCDEFGHIJ" ] {
presencesensor livingroom-presence "Livingroom Presence" [ id="1" ]
temperaturesensor livingroom-temperature "Livingroom Temperature" [ id="2" ]
}
```
-### Items file ###
+### Items file
-```
+```java
Switch Livingroom_Presence "Presence Livingroom [%s]" <motion> { channel="deconz:presencesensor:homeserver:livingroom-presence:presence" }
Number:Temperature Livingroom_Temperature "Temperature Livingroom [%.1f °C]" <temperature> { channel="deconz:temperaturesensor:homeserver:livingroom-temperature:temperature" }
Number:Dimensionless Livingroom_Humidity "Humidity Livingroom [%.1f %%]" <humidity> { channel="deconz:humiditysensor:homeserver:livingroom-humidity:humidity" }
### Events
-```php
+```java
rule "example trigger rule"
when
Channel "deconz:switch:homeserver:livingroom-hue-tap:buttonevent" triggered 34 // Hue Tap Button 1 pressed
| Channel Type ID | Item Type | Description |
|-------------------------|--------------|--------------|
-| *General* | |
+| _General_ | |
| general#power | Switch (RW) | Power on/off
| general#surroundProgram | String (R) | current surround program (e.g. STEREO)
| general#artist | String (R) | artist of current track
| general#album | String (R) | album of current track
| general#track | String (R) | title of current track
| general#command | String (W) | Command to send to the AVR (for use in Rules)
-| *Main zone* | |
+| _Main zone_ | |
| mainZone#power | Switch (RW) | Main zone power on/off
| mainZone#volume | Dimmer (RW) | Main zone volume
| mainZone#volumeDB | Number (RW) | Main zone volume in dB (-80 offset)
| mainZone#mute | Switch (RW) | Main zone mute
| mainZone#input | String (RW) | Main zone input (e.g. TV, TUNER, ..)
-| *Zone 2* | |
+| _Zone 2_ | |
| zone2#power | Switch (RW) | Zone 2 power on/off
| zone2#volume | Dimmer (RW) | Zone 2 volume
| zone2#volumeDB | Number (RW) | Zone 2 volume in dB (-80 offset)
| zone2#mute | Switch (RW) | Zone 2 mute
| zone2#input | String (RW) | Zone 2 input
-| *Zone 3* | |
+| _Zone 3_ | |
| zone3#power | Switch (RW) | Zone 3 power on/off
| zone3#volume | Dimmer (RW) | Zone 3 volume
| zone3#volumeDB | Number (RW) | Zone 3 volume in dB (-80 offset)
| zone3#mute | Switch (RW) | Zone 3 mute
| zone3#input | String (RW) | Zone 3 input
-| *Zone 4* | |
+| _Zone 4_ | |
| zone4#power | Switch (RW) | Zone 4 power on/off
| zone4#volume | Dimmer (RW) | Zone 4 volume
| zone4#volumeDB | Number (RW) | Zone 4 volume in dB (-80 offset)
`.things` file:
-```
+```java
Thing denonmarantz:avr:1 "Receiver" @ "Living room" [host="192.168.1.100"]
```
`.items` file:
-```
+```java
Switch marantz_power "Receiver" <switch> {channel="denonmarantz:avr:1:general#power"}
Dimmer marantz_volume "Volume" <soundvolume> {channel="denonmarantz:avr:1:mainZone#volume"}
Number marantz_volumeDB "Volume [%.1f dB]" {channel="denonmarantz:avr:1:mainzone#volume"}
`.sitemap` file:
-```
+```perl
...
Group item=marantz_input label="Receiver" icon="receiver" {
Default item=marantz_power
- [AVR-X2000/E400](http://www2.aerne.com/Public/dok-sw.nsf/0c6187bc750a16fcc1256e3c005a9740/96a2ba120706d10dc1257bdd0033493f/$FILE/AVRX2000_E400_PROTOCOL(10.1.0)_V04.pdf)
- [AVR-X4000](https://usa.denon.com/us/product/hometheater/receivers/avrx4000?docname=AVRX4000_PROTOCOL(10%203%200)_V03.pdf)
- [AVR-3311CI/AVR-3311/AVR-991](https://www.awe-europe.com/documents/Control%20Docs/Denon/Archive/AVR3311CI_AVR3311_991_PROTOCOL_V7.1.0.pdf)
-- [Denon/Marantz Control Protocol] (https://assets.eu.denon.com/DocumentMaster/DE/AVR1713_AVR1613_PROTOCOL_V8.6.0.pdf)
+- [Denon/Marantz Control Protocol](https://assets.eu.denon.com/DocumentMaster/DE/AVR1713_AVR1613_PROTOCOL_V8.6.0.pdf)
To configure a timetable you first need to register at Deutsche Bahn developer portal and register for timetable API to get an access key.
1. Go to [DB API Marketplace](https://developers.deutschebahn.com/)
-2. Register new account or login with an existing one
-3. If no application is configured yet (check Tab "Anwendungen" at top) create a new application. Only the name is required, for example openHAB, any other fields can be left blank.
-4. Remember the shown **Client ID** and **Client Secret**.
-5. Go to **Katalog** and search for **Timetables** api.
-6. Within **Zugehörige APIs** select the Timetables api.
-7. Select **Abonnieren** at top left of the page.
-8. Select the Nutzungsplan **Free** by clicking **Abonnieren**.
-9. Select the previously created application.
-10. Click **Next**.
-11. Click **Fertig**.
-12. Now you have successfully registered the api within an application. The **Client ID** and **Client Secret** can now be used during bridge configuration.
+1. Register new account or login with an existing one
+1. If no application is configured yet (check Tab "Anwendungen" at top) create a new application. Only the name is required, for example openHAB, any other fields can be left blank.
+1. Remember the shown **Client ID** and **Client Secret**.
+1. Go to **Katalog** and search for **Timetables** api.
+1. Within **Zugehörige APIs** select the Timetables api.
+1. Select **Abonnieren** at top left of the page.
+1. Select the Nutzungsplan **Free** by clicking **Abonnieren**.
+1. Select the previously created application.
+1. Click **Next**.
+1. Click **Fertig**.
+1. Now you have successfully registered the api within an application. The **Client ID** and **Client Secret** can now be used during bridge configuration.
### Determine the EVA-No of your station
| `trainFilter` | | Yes | Selects the trains that will be displayed in the timetable. Either only arrivals, only departures or all trains can be displayed. |
| `additionalFilter` | | No | Specifies additional filters for trains, that should be displayed within the timetable. |
-** Additional filter **
+**Additional filter**
If you only want to display certain trains within your timetable, you can specify an additional filter. This will be evaluated when loading trains,
and only trains that matches the given filter will be contained within the timetable.
To specify an advanced filter you can
-- specify a filter for the value of a given channel. Therefore, you must specify the channel name (with channel group) and specify a compare value like this:
+- specify a filter for the value of a given channel. Therefore, you must specify the channel name (with channel group) and specify a compare value like this:
`departure#line="RE60"` this will select all trains with line RE60
- use regular expressions for expected channel values, for example: `departure#line="RE.*"`, this will match all lines starting with "RE".
- combine multiple statements as "and" conjunction by using `&`. If used, both parts must match, for example: `departure#line="RE60" & trip#category="WFB"`
|-|-|-|-|
| `position` | | Yes | The position of the train within the timetable. |
-
## Channels
Each train has a set of channels, that provides access to any information served by the timetable API. A detailed description of the values and their meaning can be found within
the [Timetables V1 API Description](https://developers.deutschebahn.com/db-api-marketplace/apis/product/timetables).
The information are grouped into three channel-groups:
The first channel group (trip) contains all information for the trip of the train, for example the category (like ICE, RE, S).
-The second and third channel group contains information about the arrival and the departure of the train at the given station.
+The second and third channel group contains information about the arrival and the departure of the train at the given station.
Both of the groups may provide an 'UNDEF' channel value, when the train does not arrive / depart at this station
-(due it starts or ends at the given station). If you have configured your timetable to contain only departures (with property trainFilter) the departure channel values will always be defined
+(due it starts or ends at the given station). If you have configured your timetable to contain only departures (with property trainFilter) the departure channel values will always be defined
and if you have selected only arrivals the arrival channel values will always be defined.
Channels will have a 'NULL' channel value, when the corresponding attribute is not set.
Basically most information are available as planned and changed value. This allows to easy display changed values (for example the delay or changed platform).
+### Channels for trip information
-**Channels for trip information**
| channel | type | description |
|----------|--------|------------------------------|
| category | String | Provides the category of the trip, e.g. "ICE" or "RE". |
| trip-type | String | Provides the type of the trip. |
| owner | String | Provides the owner of the train. A unique short-form and only intended to map a trip to specific evu (EisenbahnVerkehrsUnternehmen). |
+### Channels for arrival / departure
-**Channels for arrival / departure**
| channel | type | description |
|----------|--------|------------------------------|
| planned-path | String | Provides the planned path of a train. |
timetable.things
-```
+```java
Bridge deutschebahn:timetable:timetableLehrte "Fahrplan Lehrte" [ accessToken="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", trainFilter="departures", evaNo="8000226" ] {
Thing deutschebahn:train:timetableLehrte:lehrteZug1 "Zug 1" [ position="1" ]
Thing deutschebahn:train:timetableLehrte:lehrteZug2 "Zug 2" [ position="2" ]
timetable.items
-```
+```java
// Groups
Group zug1 "Zug 1"
Group zug1Fahrt "Zug 1 Fahrt" (zug1)
Example widget for displaying train details
-```
+```yaml
uid: timetable_train_details
tags:
- card
text-align: right
```
-
Using the widget for displaying the next four departures:
Once `PRT3 Module` is added and communication with the alarm system confirmed by its `online` status, please start discovery process to automatically discover (and add as new Things) all zones and areas defined in the alarm system.
-
## Binding Configuration
There is no binding level configuration required.
For example, the following sitemap item can be used to send commands to the area and receive response status as modified color of a label:
-```
+```java
Switch item=areaControl label="Actions[]" mappings=[QA="Regular Quick Arm",QS="Stay Quick Arm",D1111="Disarm"] labelcolor=[Ok="green",Fail="red"]
```
### digitalSTROM-Server
-The digitalSTROM-Server is required for accessing any other digitalSTROM-Devices. It acts like a *"bridge"*.
+The digitalSTROM-Server is required for accessing any other digitalSTROM-Devices. It acts like a _"bridge"_.
### digitalSTROM-Devices
-At this point almost all available **GE**, **SW**, **GR** and **BL** digitalSTROM-Devices with a set output-mode, unequal *disabled*, are supported by this binding.
+At this point almost all available **GE**, **SW**, **GR** and **BL** digitalSTROM-Devices with a set output-mode, unequal _disabled_, are supported by this binding.
Furthermore sensor devices like the **dS-iSens200** and **SW-devices** with binary-inputs are supported.
Last but not least the **circuit** (dS-Meter) is supported, too. They will provide the power consumption and electric meter as channels.
-For that there are identically named thing types. Only the *GR* type has a channel (shade), which cannot be changed.
+For that there are identically named thing types. Only the _GR_ type has a channel (shade), which cannot be changed.
The other types add their channels dynamically affected by the set color-group and output-mode.
They also automatically change or add the channels, if the color-group or output-mode has changed through the dSS-web-configuration or the configured sensor priorities of the thing has changed.
| zoneScene | Zone-Scene | Represents a digitalSTROM Zone-Scene. |
| groupScene | Group-Scene | Represents a digitalSTROM Group-Scene. |
| namedScene | Named-Scene | Represents a digitalSTROM Scene, which has a user-defined name. |
-
+
### digitalSTROM-Zone-Temperature-Control
Last but not least, the digitalSTROM-Zone-Temperature-Control is also supported, if a zone-temerature-control is configured, as thing-type **zone_temperature_control**.
-The difference between the digitalSTROM-heating-control-app is, that there are no operation-modes, like *comfort* or *eco*.
-You can directly set the target temperature, in case *pid-control* is configured, otherwise you can set the value in percent of heating valves at the zone.
-The needed channels will be added automatically, as it is also the case for the devices.
+The difference between the digitalSTROM-heating-control-app is, that there are no operation-modes, like _comfort_ or _eco_.
+You can directly set the target temperature, in case _pid-control_ is configured, otherwise you can set the value in percent of heating valves at the zone.
+The needed channels will be added automatically, as it is also the case for the devices.
## Discovery
-The digitalSTROM-Server is discovered by mDNS or *dss.local.* at the local network.
+The digitalSTROM-Server is discovered by mDNS or _dss.local._ at the local network.
Once the server is added as a thing, you have to set a user name and password or insert a valid application-token to authenticate with the server.
-If the binding is authorized, it automatically reads all supported devices, the dS-Meters and temperature controlled configured zones, that are set up on the digitalSTROM-System, and puts them into the *inbox*.
-
+If the binding is authorized, it automatically reads all supported devices, the dS-Meters and temperature controlled configured zones, that are set up on the digitalSTROM-System, and puts them into the _inbox_.
+
digitalSTROM-Scenes can be discovered, too.
The background scene-discovery is deactivated by default to not flood the inbox.
Otherwise it will discover so many scenes, that it can be difficult to find the searched devices.
-
+
Discoverable scenes are all user named scenes, group scenes that are reachable by local push-buttons, zone scenes and apartment scenes.
The discovery also will discover all called scenes, if they aren't automatically discovered yet.
-Temperature control scenes, like *eco* will be ignored, so they cannot be discovered.
+Temperature control scenes, like _eco_ will be ignored, so they cannot be discovered.
If you only want to discover one of the thing types, you can start a discovery scan on the thing type you want to have discovered.
You can use the command line command, e.g.: ``openhab:discovery start digitalstrom:namedScene`` to start the scan.
-Which thing types this binding supports, please have a look at **Supported Things**.
+Which thing types this binding supports, please have a look at **Supported Things**.
## Thing Configuration and Properties
### digitalSTROM-Server
-The digitalSTROM-Server thing has the following configuration parameter groups: *Connection configuration*, *Server information* and *General configurations*.
+The digitalSTROM-Server thing has the following configuration parameter groups: _Connection configuration_, _Server information_ and _General configurations_.
#### Connection configuration
If the digitalSTROM-Server isn’t found automatically, e.g. because the server isn’t placed at the local network or the mDNS-service is deactivated, you have to insert the network address or URL and the authentication data manually through the graphical user interface or type it into the \*.thing with textual configuration.
If you use your user name and password for authentication and there is already a token for this application, it will be automatically retrieved from the digitalSTROM-Server, otherwise a new application-token will be generated.
-| Parameter Label | Parameter ID | Description | Required | Advanced
+| Parameter Label | Parameter ID | Description | Required | Advanced
|--------------|------------|--------------------------------|----------------- |------------- |
| Network address | dSSAddress | Network address of the digitalSTROM-Server.| true | false |
| User name | userName | Name of a registered user to authenticate to the digitalSTROM-Server.| user name and password or Application-Token | false |
| Application-Token | applicationToken | The Application-Token to authenticate to the digitalSTROM-Server. | user name and password or Application-Token| false |
#### Server information
-
-The parameter group *Server information* only includes informative parameters, which have no special functionality.
+The parameter group _Server information_ only includes informative parameters, which have no special functionality.
-| Parameter Label | Parameter ID | Description | Required | Advanced
+| Parameter Label | Parameter ID | Description | Required | Advanced
|-----------------|-------------|--------------------------|---------- |------------- |
-| dSID | dSID | The unique identifier of a digitalSTROM-server. | false| false |
+| dSID | dSID | The unique identifier of a digitalSTROM-server. | false| false |
#### General configuration:
-Here you can set general binding configuration parameters, which are shown in following table:
+Here you can set general binding configuration parameters, which are shown in following table:
-| Parameter Label | Parameter ID| Description | Required | Advanced | default
+| Parameter Label | Parameter ID| Description | Required | Advanced | default
|-----------------|------------------|-----------------------------------------|---------------- |------------- | ----------------- |
| Sensor update interval | sensorDataUpdateInterval | Sets the seconds after the digitalSTROM-Device sensor data will be updated. If the priority is higher than 'never'. | false | false | 60 |
| Total power update interval | totalPowerUpdateInterval | Sets the interval in seconds, after the digitalSTROM total power consumption and total electric meter sensor data will be updated. | false | false | 30 |
| Days to be slaked trash bin devices | defaultTrashBinDeleateTime| Sets the days after the temporary saved digitalSTROM-Device configuration from not reachable digitalSTROM-Devices get permanently deleted. | false | false | 7 |
-| Wait time sensor reading | sensorWaitTime| Waiting time between the evaluation of the sensor values and the reading of the scenes in seconds. **ATTENTION:** digitalSTROM rule 8 and 9 require a waiting period of 1 minute. Values less than 60 seconds could affect the digitalSTROM system. | false | true | 60 |
+| Wait time sensor reading | sensorWaitTime| Waiting time between the evaluation of the sensor values and the reading of the scenes in seconds. **ATTENTION:** digitalSTROM rule 8 and 9 require a waiting period of 1 minute. Values less than 60 seconds could affect the digitalSTROM system. | false | true | 60 |
At the thing file, a manual configuration looks e.g. like
-```
+```java
Bridge digitalstrom:dssBridge:dssBridge1 [ dSSAddress="dss.local.", userName="dssadmin", password="dssadmin", sensorDataUpdateInterval=180]
```
| Serial | The digitalSTROM-Server hardware serial number. |
| Ethernet | The digitalSTROM-Server IEEE mac address. |
| MachineID | The digitalSTROM-Server unique id. |
-| Kernel | The digitalSTROM-Server Linux kernel release string. |
+| Kernel | The digitalSTROM-Server Linux kernel release string. |
### digitalSTROM-Devices
-The digitalSTROM-Device things have the following configuration parameter groups *Device information* and *Sensor setup*.
-
+The digitalSTROM-Device things have the following configuration parameter groups _Device information_ and _Sensor setup_.
+
#### Device information
Each digitalSTROM-Device needs the device ID named dSID as configuration parameter.
The device ID is printed as serial number at the digitalSTROM-Device and can also be found within the web-interface of the digitalSTROM-Server.
-The following table shows the parameter:
+The following table shows the parameter:
-| Parameter Label | Parameter ID| Description | Required | Advanced
+| Parameter Label | Parameter ID| Description | Required | Advanced
|-----------------|------------------------|--------------|----------------- |------------- |
| ID | dSID| The unique identifier of a digitalSTORM-device. | true | false |
#### Properties
Furthermore a supported digitalSTROM-Device has some informative properties.
-The following table shows all informative properties:
+The following table shows all informative properties:
| Property-Name | Description |
| ------------- | ------------------------------------- |
-|dSUID | The unique identifier of a digitalSTORM-device with virtual devices. |
-| deviceName | he name of a digitalSTROM-Device. |
+|dSUID | The unique identifier of a digitalSTORM-device with virtual devices. |
+| deviceName | he name of a digitalSTROM-Device. |
| meterDSID | Identifier of the meter to which the device is connected. |
| hwInfo | The hardware type from this digitalSTROM-Device. |
| zoneID |The digitalSTROM-Device is part of this zone. |
| Property-Name | Description |
| ------------- | ------------------------------------- |
-| scene[sceneID] | {Scene: [sceneID], dontcare: [don't care flag], localPrio: [local prio flag], specialMode: [special mode flag]}(0..1), {sceneValue: [scene value], sceneAngle: [scene angle]}(0..1) |
+| scene[sceneID] | {Scene: [sceneID], dontcare: [don't care flag], localPrio: [local prio flag], specialMode: [special mode flag]}(0..1), {sceneValue: [scene value], sceneAngle: [scene angle]}(0..1) |
### digitalSTROM-Meter
-A digitalSTROM-Meter needs, like the digitalSTROM-Devices, only the unique digitalSTROM device ID named dSID as configuration parameter, which has the same parameters, so please have a look at the point *Device information*.
+A digitalSTROM-Meter needs, like the digitalSTROM-Devices, only the unique digitalSTROM device ID named dSID as configuration parameter, which has the same parameters, so please have a look at the point _Device information_.
#### Properties
### digitalSTROM-Zone-Temperature-Control
-The thing type of a digitalSTROM-Zone-Temperature-Control is **zone_temperature_control**.
+The thing type of a digitalSTROM-Zone-Temperature-Control is **zone_temperature_control**.
As configuration only the zone ID or the zone name, to identify the controlled zone, is needed.
-| Parameter Label | Parameter ID| Description | Required | Advanced |
+| Parameter Label | Parameter ID| Description | Required | Advanced |
|-----------------|------------------------|----------------------------------|----------------- |------------- |
-| Zone ID or name | zoneID | The zone id or zone name of the temperature controlled zone. | true | false |
+| Zone ID or name | zoneID | The zone id or zone name of the temperature controlled zone. | true | false |
#### Properties
The digitalSTROM-Scenes can be defined with following parameters.
-| Parameter Label | Parameter ID| Description | Required | Advanced |
+| Parameter Label | Parameter ID| Description | Required | Advanced |
|-----------------|------------------------|----------------------------------|----------------- |------------- |
-| Zone ID or name | zoneID | The zone ID or zone name of the called scene. 0 or empty is broadcast to all. | false | false |
-| Group ID or name | groupID | The group ID or group name of the called scene. 0 or empty is broadcast to all. | false | false |
-| Scene ID or name | sceneID |The call scene ID or scene name, e.g. preset 1 for scene ID 5. Callable scenes are from 0 to 126. | false | false |
-
-The Scene-Thing-Type *Named-Scene* and *Group-Scene* have all parameters.
-The *Apartment-Scene* only has the parameters *Scene name* and *Scene ID* an the *Zone-Scene* has all parameters without *Group ID or name*.
+| Zone ID or name | zoneID | The zone ID or zone name of the called scene. 0 or empty is broadcast to all. | false | false |
+| Group ID or name | groupID | The group ID or group name of the called scene. 0 or empty is broadcast to all. | false | false |
+| Scene ID or name | sceneID |The call scene ID or scene name, e.g. preset 1 for scene ID 5. Callable scenes are from 0 to 126. | false | false |
+The Scene-Thing-Type _Named-Scene_ and _Group-Scene_ have all parameters.
+The _Apartment-Scene_ only has the parameters _Scene name_ and _Scene ID_ an the _Zone-Scene_ has all parameters without _Group ID or name_.
### Textual configuration examples
Usually the discovery works reliable, so that a manual configuration is not needed.
-However, at the thing file, a manual configuration looks e.g. like
+However, at the thing file, a manual configuration looks e.g. like
#### digitalSTROM-Devices
-```
+```java
Thing digitalstrom:GE:GE-KM200 (digitalstrom:dssBridge:myDssBridge) [ dSID="3504175fe0000000000043d4", activePowerRefreshPriority="low", electricMeterRefreshPriority=“medium", outputCurrentRefreshPriority="high"]
Thing digitalstrom:GR:GR-KL200 (digitalstrom:dssBridge:myDssBridge) [ dSID="3504175fe0000000000043d5"]
```
#### digitalSTROM-Meters
-```
+```java
Thing digitalstrom:circuit:circuit (digitalstrom:dssBridge:myDssBridge) [ dSID="3504175fe0000000000043d5"]
```
#### digitalSTROM-Zone-Temperature-Control
-```
+```java
Thing digitalstrom:zone_temperature_control:zone_temperature_control3 (digitalstrom:dssBridge:myDssBridge) [ zoneID="3"]
```
#### digitalSTROM-Group-Scene
-```
+```java
Thing digitalstrom:groupScene:preset1 (digitalstrom:dssBridge:myDssBridge) [ zoneID="3", groupID="1", sceneID="5"]
```
| Channel Type ID | Item Type | Description | supported device type |
|-------|---------|------------------------------------|----------------- |
-| light_dimmer | Dimmer | The *light_dimm* channel allows to dimm a light device. | GE, SW |
-| light_switch | Switch | The *light_switch* channel allows to turn a light device on or off. | GE, SW |
-| light_2_stage | String| The *light_2_stage* channel allows to turn both light devices on or off or switch only 1 of the both light device on or off. | SW-UMR200 |
-| light_3_stage | String | The *light_3_stage* channel allows to turn both light devices on or off or switch both light devices separated from each other on or off. | SW-UMR200 |
-| shade | Rollershutter | The *shade* channel allows to control shade device e.g. a roller shutter or awnings. | GR |
-| shade_angle | Dimmer | The *shade_angle* channel allows to control the relative slat position in percent of blinds. | GR |
-| general_dimmer | Dimmer | The *general_dimmer* channel allows to control the power of a device e.g. a ceiling fan. | SW |
-| general_switch | Switch | The *general_switch* channel allows to turn a device on or off e.g. a HIFI-System. | SW |
-| general_2_stage | String | The *general_2_stage* channel allows to turn both relais of the device on or off or switch only 1 of the both relais on or off. | SW-UMR200 |
-| general_3_stage | String | The *general_3_stage* channel allows to turn both relais of the device on or off or switch both relais of the device separated from each other on or off. | SW-UMR200 |
-| heating_switch | Switch | The *heating_switch* channel allows to turn a heating device on or off. | BL |
-| heating_dimmer | Dimmer | The *heating_switch* channel allows to control the value in percent of heating valve. | BL |
+| light_dimmer | Dimmer | The _light_dimm_ channel allows to dimm a light device. | GE, SW |
+| light_switch | Switch | The _light_switch_ channel allows to turn a light device on or off. | GE, SW |
+| light_2_stage | String| The _light_2_stage_ channel allows to turn both light devices on or off or switch only 1 of the both light device on or off. | SW-UMR200 |
+| light_3_stage | String | The _light_3_stage_ channel allows to turn both light devices on or off or switch both light devices separated from each other on or off. | SW-UMR200 |
+| shade | Rollershutter | The _shade_ channel allows to control shade device e.g. a roller shutter or awnings. | GR |
+| shade_angle | Dimmer | The _shade_angle_ channel allows to control the relative slat position in percent of blinds. | GR |
+| general_dimmer | Dimmer | The _general_dimmer_ channel allows to control the power of a device e.g. a ceiling fan. | SW |
+| general_switch | Switch | The _general_switch_ channel allows to turn a device on or off e.g. a HIFI-System. | SW |
+| general_2_stage | String | The _general_2_stage_ channel allows to turn both relais of the device on or off or switch only 1 of the both relais on or off. | SW-UMR200 |
+| general_3_stage | String | The _general_3_stage_ channel allows to turn both relais of the device on or off or switch both relais of the device separated from each other on or off. | SW-UMR200 |
+| heating_switch | Switch | The _heating_switch_ channel allows to turn a heating device on or off. | BL |
+| heating_dimmer | Dimmer | The _heating_switch_ channel allows to control the value in percent of heating valve. | BL |
digitalSTROM-Zone-Temperature-Controlled
-| Channel Type ID | Item Type | Description |
+| Channel Type ID | Item Type | Description |
|-------|---------|------------------------------------|
-| heating_temperature_controled | Number | The *heating_temperature_controled* channel allows to set a target temperature of a zone. |
-| heating_dimmer | Dimmer | The *heating_switch* channel allows to control the value in percent of heating valve. |
+| heating_temperature_controled | Number | The _heating_temperature_controled_ channel allows to set a target temperature of a zone. |
+| heating_dimmer | Dimmer | The _heating_switch_ channel allows to control the value in percent of heating valve. |
### Sensor-Channels
| Channel Type ID | Item Type | Description | supported device type |
|-------|---------|------------------------------------|----------------- |
-| active_power | Number | This channel indicates the current active power in watt (W) of the device." | GE, SW, BL |
-| output_current | Number | This channel indicates the current output current in milliamper (mA) of the device." | GE, SW, BL |
-| electric_meter | Number | This channel indicates the current electric meter value in killowatts hours (kWh) of the device. | GE, SW, BL |
+| active_power | Number | This channel indicates the current active power in watt (W) of the device." | GE, SW, BL |
+| output_current | Number | This channel indicates the current output current in milliamper (mA) of the device." | GE, SW, BL |
+| electric_meter | Number | This channel indicates the current electric meter value in killowatts hours (kWh) of the device. | GE, SW, BL |
| temperature_indoors | Number | This channel indicates the current temperature indoors in Celsius (°C) of the device. | dS-iSens200 |
| temperature_outdoors | Number | This channel indicates the current temperature outdoors in Celsius (°C) of the device. | --- |
| brightness_indoors | Number | This channel indicates the current brightness indoors in Lux (Lx) of the device. | --- |
| room_temperation_set_point | Number | This channel indicates the current room temperation set point in Celsius (°C) of the device. | --- |
| room_temperation_control_variable | Number | This channel indicates the current room temperation control variable in Celsius (°C) of the device. | --- |
-*If no supported device type is at the table, digitalSTROM currently does not offer a device, which support this type of sensor.
+*If no supported device type is at the table, digitalSTROM currently does not offer a device, which support this type of sensor.
### Binary-Input-Channels
### Metering-Channels
-The digitalSTROM-Meters
+The digitalSTROM-Meters
| Channel Type ID | Item Type | Description | supported device type |
|-------|---------|------------------------------------|----------------- |
-| consumption_Wh | Number | The *consumption_Wh* channel indicates the current power consumption in watt (W) of the circuit. | circuit |
-| energy_Wh | Number | The *energy_Wh* channel indicates the current electric meter value in killowatt hours of the circuit. | circuit |
+| consumption_Wh | Number | The _consumption_Wh_ channel indicates the current power consumption in watt (W) of the circuit. | circuit |
+| energy_Wh | Number | The _energy_Wh_ channel indicates the current electric meter value in killowatt hours of the circuit. | circuit |
-The digitalSTROM-Server
+The digitalSTROM-Server
| Channel Type ID | Item Type | Description | supported device type |
|-------|---------|------------------------------------|----------------- |
-| total_consumption_Wh | Number | The *total_consumption_Wh* channel indicates the current consumption power in watt (W) of all connected circuits to the digitalSTROM-System. | dssBridge |
-| total_energy_Wh | Number | The *total_energy_Wh* channel indicates the current electric meter value in killowatt hours of all connected circuits to the digitalSTROM-System. | dssBridge |
+| total_consumption_Wh | Number | The _total_consumption_Wh_ channel indicates the current consumption power in watt (W) of all connected circuits to the digitalSTROM-System. | dssBridge |
+| total_energy_Wh | Number | The _total_energy_Wh_ channel indicates the current electric meter value in killowatt hours of all connected circuits to the digitalSTROM-System. | dssBridge |
### Scenes
| Channel Type ID | Item Type | Description | supported device type |
|-------|---------|------------------------------------|----------------- |
-| scene | Switch | The scene channel allows to call or undo a scene from digitalSTROM. | all scene-types |
+| scene | Switch | The scene channel allows to call or undo a scene from digitalSTROM. | all scene-types |
-**Notes: **
+**Notes:**
-*Generally:*
+_Generally:_
-* The digitalSTROM-Server only informs the binding about scene-commands. So if you set the output value of devices e.g. through the dSS-App, the binding will not be informed about the changes and you have to send a "refresh-command" to update the channel.
-* If you press a physical switch at your digitalSTROM-installation and the called scene-value is not red out yet, it can take a bit time to read it out and change the state of the channel.
+- The digitalSTROM-Server only informs the binding about scene-commands. So if you set the output value of devices e.g. through the dSS-App, the binding will not be informed about the changes and you have to send a "refresh-command" to update the channel.
+- If you press a physical switch at your digitalSTROM-installation and the called scene-value is not red out yet, it can take a bit time to read it out and change the state of the channel.
It the scene-value is red out, the state will change immediately.
-See also *General-Informations/digitalSTROM-Scenes*.
+See also _General-Informations/digitalSTROM-Scenes_.
-*Channels with accepted command type increase and decrease:*
+_Channels with accepted command type increase and decrease:_
- * digitalSTROM will only evaluate increase and decrease commands, if a scene was called before which turn the device on.
-
-*Blinds:*
+- digitalSTROM will only evaluate increase and decrease commands, if a scene was called before which turn the device on.
- * Increase, decrease and up, down commands of the shade channel changes the angle in digitalSTROM, too. If you want to set only the position, you have to set the value directly.
- * To protect the slats digitalSTROM changes the position by setting the angle, too, if the position is very high or low. So if you want to see the correct position, you have to send a refresh or stop command, if the blind is ready.
+_Blinds:_
+
+- Increase, decrease and up, down commands of the shade channel changes the angle in digitalSTROM, too. If you want to set only the position, you have to set the value directly.
+- To protect the slats digitalSTROM changes the position by setting the angle, too, if the position is very high or low. So if you want to see the correct position, you have to send a refresh or stop command, if the blind is ready.
## Full Example
### demo.things:
-```
+```java
Bridge digitalstrom:dssBridge:dSS [ dSSAddress="urlOfMyDss", userName="dssadmin", password="mySecretPassword", sensorDataUpdateInterval=180] {
GE GE-KM-200 [ dSID="3504175fe000000000010db9", activePowerRefreshPriority="low", electricMeterRefreshPriority="medium", outputCurrentRefreshPriority="high"]
SW SW-ZWS-200 [ dSID="3504175fe0000000000651c0"]
### demo.items:
-```
+```java
//dSS
Number TotalActivePower { channel="digitalstrom:dssBridge:dSS:total_consumption_wh" }
Number TotalElectricMeter { channel="digitalstrom:dssBridge:dSS:total_energy_wh" }
### demo.sitemap:
-```
+```perl
sitemap demo label="Main Menu"
{
Frame label="System" {
### digitalSTROM-Scenes
-The device scene configuration will be saved persistently to the thing properties, if the thing is not textual configured (because textual configured things will not be persisted), to update the device state faster.
-For that each scene configuration of each device has to be read out first, because of the digitalSTROM-rule 9 that requires a waiting period of one minute, that take some time so that at the first start a scene call can be take some time to read it out and update the device state.
-To read it out faster only the discovered or called scenes will be read out.
-
+The device scene configuration will be saved persistently to the thing properties, if the thing is not textual configured (because textual configured things will not be persisted), to update the device state faster.
+For that each scene configuration of each device has to be read out first, because of the digitalSTROM-rule 9 that requires a waiting period of one minute, that take some time so that at the first start a scene call can be take some time to read it out and update the device state.
+To read it out faster only the discovered or called scenes will be read out.
+
**Note:**
Because the digitalSTROM-Server can't inform the binding about save scene events at this time, the persistently saved scene configurations can't be updated.
The current troubleshooting to read out the new scene configuration after a save scene action at the digitalSTROM-Server is the following:
1. delete the thing to delete the persistently saved scene configuration
-2. restart the server to delete the temporary saved scene configuration
-3. add the thing again to read out the scene configuration again.
+1. restart the server to delete the temporary saved scene configuration
+1. add the thing again to read out the scene configuration again.
### Initial state of digitalSTROM-Scenes and devices
Because of that there are two things to be observed:
1. If a device status has changed through a device scene or a directly set output value, the status is maybe not correct.
-2. If the last called group scene was not read out yet, it can takes some time until the status will be updated.
+1. If the last called group scene was not read out yet, it can takes some time until the status will be updated.
### Textual configuration notice
-If you configure your system with textual configuration files, like *\*.thing*, there is one things you have to consider.
+If you configure your system with textual configuration files, like _\*.thing_, there is one things you have to consider.
-* The feature of the persisting of scene-configurations, to get the scene-configurations after a restart faster (see *digitalSTROM-Scenes* above), will not support textural configured things, because the properties cannot be persist in this case.
+- The feature of the persisting of scene-configurations, to get the scene-configurations after a restart faster (see _digitalSTROM-Scenes_ above), will not support textural configured things, because the properties cannot be persist in this case.
### Rule specific notice
If you want to create a rule, which uses things of the digitalSTROM-Binding, there are also two things you have to consider.
1. If the rule contains several digitalSTROM-Devices, which can be summarized in a digitalSTROM-Scene, e.g. some lights in a zone, please use an equivalent supported scene. That will significantly reduce the communication to the digitalSTROM-Server, increases performance and does not bypass the digitalSTROM state-machine.
-2. If you implement your own temperature control algorithm for a zone/room, e.g. because you want to use other temperature sensors, and call more than one digitalSTROM-BL-KM200, please use the *zone_temperature_control* for valve value control. The *zone_temperature_control* for valve value control will call all digitalSTROM-BL-KM200 with one command and increases the performance. To get the needed channel at the *zone_temperature_control* you have to choose a control mode unequal to *pid-controlled* for the affected zone at the digitalSTROM-heating-control-app.
+1. If you implement your own temperature control algorithm for a zone/room, e.g. because you want to use other temperature sensors, and call more than one digitalSTROM-BL-KM200, please use the _zone_temperature_control_ for valve value control. The _zone_temperature_control_ for valve value control will call all digitalSTROM-BL-KM200 with one command and increases the performance. To get the needed channel at the _zone_temperature_control_ you have to choose a control mode unequal to _pid-controlled_ for the affected zone at the digitalSTROM-heating-control-app.
# DMX Binding
-The DMX binding integrates DMX devices. There are different output devices supported as well as Dimmers and Chasers.
+The DMX binding integrates DMX devices. There are different output devices supported as well as Dimmers and Chasers.
-Each output device (bridges) is representing exactly one universe, each thing is bound to a bridge.
-At least one bridge and one thing is needed for the binding to work properly.
+Each output device (bridges) is representing exactly one universe, each thing is bound to a bridge.
+At least one bridge and one thing is needed for the binding to work properly.
## Supported Things
### Bridges
-Two DMX over Ethernet devices are supported as DMX output: ArtNet and sACN/E1.31.
-The ArtNet bridge can only be operated in unicast mode (broadcast mode is not supported as the specification recommends using it if more than 40 nodes are connected, which is unlikely in the case of a smarthome).
-The sACN bridge supports both, unicast and multicast.
+Two DMX over Ethernet devices are supported as DMX output: ArtNet and sACN/E1.31.
+The ArtNet bridge can only be operated in unicast mode (broadcast mode is not supported as the specification recommends using it if more than 40 nodes are connected, which is unlikely in the case of a smarthome).
+The sACN bridge supports both, unicast and multicast.
Additionally Lib485 devices are supported via the Lib485 bridge.
### Things
-The most generic thing is a dimmer.
-A dimmer can contain one or more DMX channels.
-It can be bound to Switch and Dimmer items.
-If more than one DMX channel is defined, the item will be updated according to the state of the first DMX channel.
-There are two other things similar to the dimmer thing.
-One is the color thing, it can be bound to Switch, Dimmer or Color Items and is best used for RGB lamps.
+The most generic thing is a dimmer.
+A dimmer can contain one or more DMX channels.
+It can be bound to Switch and Dimmer items.
+If more than one DMX channel is defined, the item will be updated according to the state of the first DMX channel.
+There are two other things similar to the dimmer thing.
+One is the color thing, it can be bound to Switch, Dimmer or Color Items and is best used for RGB lamps.
The second one is the tunable white thing, it allows to control the color temperature of lamps with seperate DMX channels for cool white and warm white.
-The last supported thing is a chaser.
-It can contain one or more DMX channels and binds to Switch items only.
-If the thing receives an ON command all running fades in all channels are either suspended (if resumeAfter is set to true) or cleared and replaced with the fades defined in this thing.
-An OFF command stops the fades and either restores the previously suspended fades (if resumeAfter is set to true) or just holds the current values.
-If any of the DMX channels in a chaser receives a command from another thing, the status of the chaser is updated to OFF.
+The last supported thing is a chaser.
+It can contain one or more DMX channels and binds to Switch items only.
+If the thing receives an ON command all running fades in all channels are either suspended (if resumeAfter is set to true) or cleared and replaced with the fades defined in this thing.
+An OFF command stops the fades and either restores the previously suspended fades (if resumeAfter is set to true) or just holds the current values.
+If any of the DMX channels in a chaser receives a command from another thing, the status of the chaser is updated to OFF.
Chaser things define a control channel that can be used to dynamically change the chasers fade configuration.
## Discovery
## Thing Configuration
-Since the brightness perception of the human eye is not linear, all bridges support `applycurve`, a list of channels `applycurve` that have a CIE 1931 lightness correction (cf. [Poynton, C.A.: “Gamma” and its Disguises: The Nonlinear Mappings of Intensity in Perception, CRTs, Film and Video, SMPTE Journal Dec. 1993, pp. 1099 - 1108](https://www.poynton.com/PDFs/SMPTE93_Gamma.pdf)) applied.
-This list follows the format of the thing channel definition.
+Since the brightness perception of the human eye is not linear, all bridges support `applycurve`, a list of channels `applycurve` that have a CIE 1931 lightness correction (cf. [Poynton, C.A.: “Gamma” and its Disguises: The Nonlinear Mappings of Intensity in Perception, CRTs, Film and Video, SMPTE Journal Dec. 1993, pp. 1099 - 1108](https://www.poynton.com/PDFs/SMPTE93_Gamma.pdf)) applied.
+This list follows the format of the thing channel definition.
This is used regardless of the thing(s) that are associated to the channel.
-All bridges can make use of the `refreshrate` option.
-It determines at what frequency the DMX output is refreshed.
-The achievable refresh rate depends on the number of channels and the output type.
+All bridges can make use of the `refreshrate` option.
+It determines at what frequency the DMX output is refreshed.
+The achievable refresh rate depends on the number of channels and the output type.
A value of `0` disables the output, the default value is 30 Hz.
### ArtNet Bridge (`artnet-bridge`)
-The ArtNet bridge has one mandatory configuration value: network address (`address`).
+The ArtNet bridge has one mandatory configuration value: network address (`address`).
The network address defines the IP address of the receiving node, it is also allowed to use a FQDN if DNS resolution is available.
If necessary the default port 6454 can be changed by adding `:<port>` to the address.
Multiple receivers can be added, separated by a comma.
-The universe (`universe`) can range from 0-32767, this value defaults to 0.
+The universe (`universe`) can range from 0-32767, this value defaults to 0.
-There are two more configuration values that usually don't need to be touched.
-The address and port of the sender will be automatically selected by the kernel, if they need to be set to a fixed value, this can be done with `localaddress`.
-The format is identical to the receiver address.
+There are two more configuration values that usually don't need to be touched.
+The address and port of the sender will be automatically selected by the kernel, if they need to be set to a fixed value, this can be done with `localaddress`.
+The format is identical to the receiver address.
Unlike DMX512-A (E1.11), the ArtNet standard allows to suppress repeated transmissions of unchanged universes for a certain time.
This is enabled by default and will re-transmit unchanged data with a fixed refresh rate of 800ms.
If for some reason continuous transmission is needed, the `refreshmode` can be set to `always`, opposed to the default `standard`.
### sACN/E1.31 Bridge (`sacn-bridge`)
The sACN bridge has one mandatory configuration value: transmission mode (`mode`).
-The transmission mode can be set to either `unicast` or `multicast`, where the later one is the default value.
+The transmission mode can be set to either `unicast` or `multicast`, where the later one is the default value.
If unicast mode is selected, it is mandatory to define the network address (`address`) of the receiving node.
This can be an IP address but it is also allowed to use a FQDN if DNS resolution is available.
If necessary the default port 5568 can be changed by adding `:<port>` to the address.
Multiple receivers can be added, separated by a comma.
-The universe (`universe`) can range from 1-63999, this value defaults to 1.
+The universe (`universe`) can range from 1-63999, this value defaults to 1.
There are some more configuration values that usually don't need to be touched.
The address and port of the sender will be automatically selected by the kernel, if they need to be set to a fixed value, this can be done with `localaddress`.
-The format is identical to the receiver address.
+The format is identical to the receiver address.
Unlike DMX512-A (E1.11), the E1.31 standard allows to suppress repeated transmissions of unchanged universes for a certain time.
This is enabled by default and will re-transmit unchanged data with a fixed refresh rate of 800ms.
### Chaser Thing (`chaser`)
-There are two mandatory configuration values for a chaser thing: the `dmxid` and `steps`.
+There are two mandatory configuration values for a chaser thing: the `dmxid` and `steps`.
The `dmxid` is a list of DMX channels that are associated with this thing.
-There are several possible formats: `channel,channel,channel,...` or `channel/width` or a combination of both.
+There are several possible formats: `channel,channel,channel,...` or `channel/width` or a combination of both.
The `steps` value is a list of steps that shall be run by the chaser.
The format of a single step is `fadetime:value,value2, ...:holdtime`, two or more steps are concatenated by `step1|step2|...`.
There is one mandatory configuration value for a dimmer thing.
It is the `dmxid`, a list of DMX channels that are associated with this thing.
-There are several possible formats: `channel1,channel2,channel3,...` or `channel/width` or a combination of both.
+There are several possible formats: `channel1,channel2,channel3,...` or `channel/width` or a combination of both.
The `fadetime` option allows a smooth transition from the current to the new value.
The time unit is ms and the interval is for a fade from 0-100%.
If the current value is 25% and the new value is 75% the time needed for this change is half of `fadetime`.
-`fadetime`is used for absolute values or ON/OFF commands send to the `brightness` channel.
+`fadetime`is used for absolute values or ON/OFF commands send to the `brightness` channel.
Related is the `dimtime` option: it defines the time in ms from 0-100% if incremental dimming (`INCREASE`/`DECREASE`) is used.
For convenient use `dimtime` usually is set to a larger value than `fadetime`.
-Typical values are 500-1000 ms for `fadetime` and 2000-5000 ms for `dimtime`.
+Typical values are 500-1000 ms for `fadetime` and 2000-5000 ms for `dimtime`.
-Advanced options are the `turnonvalue`and the `turnoffvalue`.
+Advanced options are the `turnonvalue`and the `turnoffvalue`.
They default to 255 (equals 100%) and 0 (equals 0%) respectively.
This value can be set individually for all DMX channels, the format is `value1,value2, ...` with values from 0 to 255.
If less values than DMX channels are defined, the values will be re-used from the beginning (i.e. if two values are defined, value1 will be used for channel1, channel3, ... and value2 will be used for channel2, channel4, ...).
-These values will be used if the thing receives an ON or OFF command.
+These values will be used if the thing receives an ON or OFF command.
The `dynamicturnonvalue` can be set to `true` or `false` (default).
If enabled, thing overwrites the previous turn-on value with the current channel values.
-The next `ON` command uses these values instead of the default (or configuration supplied) values.
+The next `ON` command uses these values instead of the default (or configuration supplied) values.
### Color Thing (`color`)
There is one mandatory configuration value for a dimmer thing.
It is the `dmxid`, a list of DMX channels that are associated with this thing.
There are several possible formats: `channel1,channel2,channel3,...` or `channel/width` or a combination of both.
-The number of channels has to be a multiple of three.
+The number of channels has to be a multiple of three.
The `fadetime` option allows a smooth transition from the current to the new value.
The time unit is ms and the interval is for a fade from 0-100%.
If the current value is 25% and the new value is 75% the time needed for this change is half of `fadetime`.
-`fadetime`is used for absolute values or ON/OFF commands send to the `brightness` channel.
+`fadetime`is used for absolute values or ON/OFF commands send to the `brightness` channel.
Related is the `dimtime` option: it defines the time in ms from 0-100% if incremental dimming (`INCREASE`/`DECREASE`) is used.
For convenient use `dimtime` usually is set to a larger value than `fadetime`.
Typical values are 500-1000 ms for `fadetime` and 2000-5000 ms for `dimtime`.
This value can be set individually for all DMX channels, the format is `value1,value2, ...` with values from 0 to 255.
If less values than DMX channels are defined, the values will be re-used from the beginning (i.e. if two values are defined, value1 will be used for channel1, channel3, ... and value2 will be used for channel2, channel4, ...).
For color things the number of values has to be a multiple of three.
-These values will be used if the thing receives an ON or OFF command.
+These values will be used if the thing receives an ON or OFF command.
The `dynamicturnonvalue` can be set to `true` or `false` (default).
If enabled, thing overwrites the previous turn-on value with the current channel values.
-The next `ON` command uses these values instead of the default (or configuration supplied) values.
+The next `ON` command uses these values instead of the default (or configuration supplied) values.
### Tunable White Thing (`tunablewhite`)
-There is one mandatory configuration value for a dimmer thing.
+There is one mandatory configuration value for a dimmer thing.
It is the `dmxid`, a list of DMX channels that are associated with this thing.
There are several possible formats: `channel1,channel2,channel3,...` or `channel/width` or a combination of both.
The number of channels has to be even. In the order "cool white, warm white".
-Additionally a channel for cool and warm white brightness as well as color temperature (`0` being the coolest, `100` being the warmest) will be provided.
+Additionally a channel for cool and warm white brightness as well as color temperature (`0` being the coolest, `100` being the warmest) will be provided.
The `fadetime` option allows a smooth transition from the current to the new value.
The time unit is ms and the interval is for a fade from 0-100%.
If the current value is 25% and the new value is 75% the time needed for this change is half of `fadetime`.
-`fadetime`is used for absolute values or ON/OFF commands send to the `brightness` channel.
+`fadetime`is used for absolute values or ON/OFF commands send to the `brightness` channel.
Related is the `dimtime` option: it defines the time in ms from 0-100% if incremental dimming (`INCREASE`/`DECREASE`) is used.
For convenient use `dimtime` usually is set to a larger value than `fadetime`.
Typical values are 500-1000 ms for `fadetime` and 2000-5000 ms for `dimtime`.
Advanced options are the `turnonvalue`and the `turnoffvalue`.
They default to 255 (equals 100%) and 0 (equals 0%) respectively.
This value can be set individually for all DMX channels, the format is `value1,value2, ...` with values from 0 to 255.
-If less values than DMX channels are defined, the values will be re-used from the beginning (i.e. if two values are defined, value1 will be used for channel1, channel3, ... and value2 will be used for channel2, channel4, ...).
+If less values than DMX channels are defined, the values will be re-used from the beginning (i.e. if two values are defined, value1 will be used for channel1, channel3, ... and value2 will be used for channel2, channel4, ...).
For tunable white things the number of values has to be a multiple of two.
-These values will be used if the thing receives an ON or OFF command.
-
+These values will be used if the thing receives an ON or OFF command.
+
The `dynamicturnonvalue` can be set to `true` or `false` (default).
If enabled, thing overwrites the previous turn-on value with the current channel values.
-The next `ON` command uses these values instead of the default (or configuration supplied) values.
-
-
+The next `ON` command uses these values instead of the default (or configuration supplied) values.
+
## Channels
| Type-ID | Thing | Item | Description |
|switch |chaser |Switch | turns the chaser ON or OFF |
|mute |(all bridges) |Switch | mutes the DMX output of the bridge |
-*Note:* the string send to the control channel of chaser things has to be formatted like the `steps` configuration of the chaser thing.
+_Note:_ the string send to the control channel of chaser things has to be formatted like the `steps` configuration of the chaser thing.
If the new string is invalid, the old configuration will be used.
## Rule Actions
### demo.things:
-```
+```java
Bridge dmx:sacn-bridge:mybridge [ mode="unicast", address="192.168.0.60", universe=2 ] {
color rgb [dmxid="5/3", fadetime=1000, dimtime=10000 ]
dimmer single [dmxid="50", fadetime=1000, turnonvalue="230", turnoffvalue="25" ]
### demo.items:
-```
+```java
Color MyColorItem "My Color Item" { channel="dmx:color:mybridge:rgb:color" }
Dimmer MyDimmerItem "My Dimmer Item" { channel="dmx:dimmer:mybridge:single:brightness" }
Switch MyChaserItem "My Chaser Item" { channel="dmx:chaser:mybridge:ampel:switch" }
### demo.sitemap:
-```
+```perl
sitemap demo label="Main Menu"
{
Frame {
# Dominoswiss Binding
-This binding allows the control of rollershutters, using an eGate as gateway and Dominoswiss radio receivers.
-The eGate-gateway is connected via ethernet to openHAB and sends its commands via radio to all rollershutters.
-See https://www.brelag.com/ for more information.
-
+This binding allows the control of rollershutters, using an eGate as gateway and Dominoswiss radio receivers.
+The eGate-gateway is connected via ethernet to openHAB and sends its commands via radio to all rollershutters.
+See <https://www.brelag.com/> for more information.
## Supported Things
eGate: Dominoswiss eGate Server. The eGate is the gateway which sends the commands to the connected rollershutters. The bridge-type ID is egate.
Blind: represents one rollershutter, that can be controlled via eGate. The thing-type ID is blind.
-
## Discovery
-Unfortunately no automatic discovery is possible due to protocol restrictions.
+Unfortunately no automatic discovery is possible due to protocol restrictions.
Every rollershutter must be known by eGate and can be called by it's number of storage-place on eGate gateway.
-
-
## Thing Configuration
-The bridge "eGate" has one channel "getconfig" which returns the config of this bridge.
+The bridge "eGate" has one channel "getconfig" which returns the config of this bridge.
The eGate is configured with both an `ipAddress` and a port.
|Property|Default|Required|Description|
|ipAddress|none|Yes|The IP or host name of the Dominoswiss EGate Serve|
|port|1318|Yes|Port interface of the Dominoswiss EGate Server|
-```
+```java
Bridge dominoswiss:egate:myeGate "My eGate Server" @ "Home" [ ipAddres="localhost", port=5700 ]
```
-
The thing blind represents one blind on the eGate. Each blind is represented by an id set on your eGate.
-```
+```java
Thing blind officeBlind "Office" @ "1stFloor" [ id="1"]
```
|continuousDown|Rollershutter|send a continous down to this blind. The blind will automatically stop as it is fully down.|
|stop|Rollershutter|stop the action of the blind. The command will be imadiatly sent to the blind.|
|shutter|Rollershutter|this is used to bind the channel to the shutter item. There are no further rules needed this channel will handel the up/down/stop commands. See example for usage.|
-|tilt|Rollershutter|same as shutter, this will handel all up/down/stop - tilt commands to be used with the shutter-item.|
-|tiltUp|Rollershutter|sends 3 pulse-up commands to this blind to tilt the blind. If your blind needs more than 3 pulse-up, create a rule yourself with three pluse-up commands. Between each pulse-up you should wait 150ms to let the command be processed.
+|tilt|Rollershutter|same as shutter, this will handel all up/down/stop - tilt commands to be used with the shutter-item.|
+|tiltUp|Rollershutter|sends 3 pulse-up commands to this blind to tilt the blind. If your blind needs more than 3 pulse-up, create a rule yourself with three pluse-up commands. Between each pulse-up you should wait 150ms to let the command be processed.
|tiltDown|Rollershutter|sends 3 pulse-down commands to this blind to tilt the blind. If your blind needs more than 3 pulse-down, create a rule yourself with three pluse-down commands. Between each pulse-down you should wait 150ms to let the command be processed. |
## Full Example
Sample things file:
-```
+```java
Bridge dominoswiss:egate:myeGate "My eGate Server" @ "Home" [ ipAddres="localhost", port="5500" ]
{
Thing blind officeBlind "Office" @ "1stFloor" [ id="1"]
Sample items file:
-```
+```java
Rollershutter OfficeBlindShutter "Office blind" <rollershutter> (g_blinds) { channel="dominoswiss:blind:myeGate:officeBlind:shutter"}
Rollershutter OfficeBlindShutterTilt "Tilt Office" <rollershutter> (g_blinds_tilt) { channel="dominoswiss:blind:meGgate:bueroBlind:tilt"}
Sample sitemap file
-```
+```perl
Switch item=OfficeBlindShutter
Switch item=OfficeBlindShutterTilt
```
This example moves the blind of the office up as the sun passed 110 azimuth (so the sun is no longer shining directly into the office).
-```
+```java
rule "OneSide up"
when
Item Azimuth changed
## Profiles
-Using the system default switch profile *rawbutton-on-off-switch* in a *doorbell* channel item definition will cause ON/OFF
+Using the system default switch profile _rawbutton-on-off-switch_ in a _doorbell_ channel item definition will cause ON/OFF
states to be set when the doorbell is pressed and released.
-See *Items* example below.
+See _Items_ example below.
## Rule Actions
The binding supports the following actions.
In classic rules these are accessible as shown in this example (adjust getActions with your ThingId):
-
+
### void restart()
-
+
Restarts the Doorbird device.
### void sipHangup()
Example
-```
+```java
val actions = getActions("doorbird","doorbird:d101:doorbell")
if(actions === null) {
logInfo("actions", "Actions not found, check thing ID")
### Things
-```
+```java
Thing doorbird:d101:doorbell "Doorbird D101 Doorbell" [doorbirdHost="192.168.1.100",userId="dtfubb0004",userPassword="HG7afc5TvN",imageRefreshRate=60,doorbellOffDelay=3,motionOffDelay=30,montageNumImages=3,montageScaleFactor=35]
Thing doorbird:a1081:controller "Doorbird A1081 Controller" [doorbirdHost="192.168.1.100",userId="dtfubb0004",userPassword="HG7afc5TvN"]
### Items
-```
+```java
Switch Doorbell_Pressed "Doorbell Pressed [%s]" <switch> ["Switch"] { channel="doorbird:d101:doorbell:doorbell" [profile="rawbutton-on-off-switch"] }
DateTime Doorbell_PressedTimestamp "Doorbell Pressed Timestamp [%1$tA, %1$tm/%1$td/%1$tY %1$tl:%1$tM %1$tp]" <time> { channel="doorbird:d101:doorbell:doorbellTimestamp" }
Image Doorbell_PressedImage "Doorbell Pressed Image [%s]" { channel="doorbird:d101:doorbell:doorbellImage" }
### Sitemap
-```
+```perl
Frame {
Text label="Doorbird" {
Frame label="Image" {
Using the doorbell trigger channel to detect if the doorbell has been pressed:
-```
+```java
rule "Doorbell Button Pressed"
when
Channel "doorbird:d101:doorbell:doorbell" triggered PRESSED
end
```
-Alternatively, detecting a doorbell press using an item that references the *rawbutton-on-off-switch* profile:
+Alternatively, detecting a doorbell press using an item that references the _rawbutton-on-off-switch_ profile:
-```
+```java
rule "Doorbell Button Pressed"
when
Item Doorbell_Pressed received command ON
Using the doorbell motion channel to detect motion:
-```
+```java
rule "Motion Detected"
when
Item Doorbell_Motion received command ON
There are a few ways to obtain this, assuming you have already configured the system using the Wiser App.
1. Temporarily install a packet sniffing tool on your mobile device. Every request made includes the `secret` in the header.
-2. Enable setup mode on the HeatHub. Connect a machine temporarily to the `WiserHeat_XXXXX` network and browse to `http://192.168.8.1/secret` to obtain the `secret`.
+1. Enable setup mode on the HeatHub. Connect a machine temporarily to the `WiserHeat_XXXXX` network and browse to `http://192.168.8.1/secret` to obtain the `secret`.
The `refresh` interval defines in seconds, how often the binding will poll the controller for updates.
### .things file
-```
+```java
Bridge draytonwiser:heathub:HeatHub [ networkAddress="192.168.1.X", refresh=60, secret="secret from hub", awaySetPoint=10 ] {
boiler-controller controller "Controller"
room livingroom "Living Room" [ name="Living Room" ]
### .items file
-```
+```java
Switch Heating_Override "Heating Override" <fire> (gHouse) { channel="draytonwiser:boiler-controller:HeatHub:controller:heatingOverride" }
Number Heating_Demand "Heating Demand [%.0f %%]" <heating> (gHouse) { channel="draytonwiser:boiler-controller:HeatHub:controller:heatChannel1Demand" }
Switch Heating_Requesting_Heat "Heating On" <fire> (gHouse) { channel="draytonwiser:boiler-controller:HeatHub:controller:heatChannel1DemandState" }
### Sitemap
-```
+```perl
Text label="Living Room" icon="sofa" {
Text item=livingroom_temperature
Setpoint item=livingroom_setpoint step=0.5
The following table shows the available configuration parameters for each thing.
<table>
- <tr><td><b>Thing</b></td><td><b>Configuration Parameters</b></td></tr>
-
<tr><td>envisalink</td><td><table><tr><td><b>ipAddress</b> - IP address for the Envisalink adapter - Required.</td></tr><tr><td><b>port</b> - TCP port for the Envisalink adapter - Not Required - default = 4025.</td></tr><tr><td><b>password</b> - Password to login to the Envisalink bridge - Not Required.</td></tr><tr><td><b>connectionTimeout</b> - TCP socket connection timeout in milliseconds - Not Required - default=5000.<br/></td></tr><tr><td><b>pollPeriod</b> - Period of time in minutes between the poll command being sent to the Envisalink bridge - Not Required - default=1.</td></tr></table></td></tr>
-
<tr><td>it100</td><td><table><tr><td><b>serialPort</b> - Serial port for the IT-100s bridge - Required.</td></tr><tr><td><b>baud</b> - Baud rate of the IT-100 bridge - Not Required - default = 9600.</td></tr><tr><td><b>pollPeriod</b> - Period of time in minutes between the poll command being sent to the IT-100 bridge - Not Required - default=1.</td></tr></table></td></tr>
+ <tr><td><b>Thing</b></td><td><b>Configuration Parameters</b></td></tr>
+ <tr><td>envisalink</td><td><table><tr><td><b>ipAddress</b> - IP address for the Envisalink adapter - Required.</td></tr><tr><td><b>port</b> - TCP port for the Envisalink adapter - Not Required - default = 4025.</td></tr><tr><td><b>password</b> - Password to login to the Envisalink bridge - Not Required.</td></tr><tr><td><b>connectionTimeout</b> - TCP socket connection timeout in milliseconds - Not Required - default=5000.<br/></td></tr><tr><td><b>pollPeriod</b> - Period of time in minutes between the poll command being sent to the Envisalink bridge - Not Required - default=1.</td></tr></table></td></tr>
+ <tr><td>it100</td><td><table><tr><td><b>serialPort</b> - Serial port for the IT-100s bridge - Required.</td></tr><tr><td><b>baud</b> - Baud rate of the IT-100 bridge - Not Required - default = 9600.</td></tr><tr><td><b>pollPeriod</b> - Period of time in minutes between the poll command being sent to the IT-100 bridge - Not Required - default=1.</td></tr></table></td></tr>
<tr><td>tcpserver</td><td><table><tr><td><b>ipAddress</b> - IP address for the TCP Server - Required.</td></tr><tr><td><b>port</b> - TCP port for the TCP Server - Required.</td></tr><tr><td><b>connectionTimeout</b> - TCP socket connection timeout in milliseconds - Not Required - default=5000.<br/></td></tr><tr><td><b>pollPeriod</b> - Period of time in minutes between the poll command being sent to the TCP Server bridge - Not Required - default=1.</td></tr><tr><td><b>protocol</b> - The protocol used to interact with the DSC Alarm. Valid values are 1 for IT100 API or 2 for Envisalink TPI. The default is 1. - Not Required.</td></tr></table></td></tr>
<tr><td>panel</td><td><table><tr><td><b>userCode</b> - User code for the DSC alarm panel - Not Required.</td></tr><tr><td><b>suppressAcknowledgementMsgs</b> - Suppress the display of acknowledgement messages when received - Not Required - default = false.</td></tr></table></td></tr>
- <tr><td>partition</td><td><b>partitionNumber</b> - Partition number (1-8) - Required.</td></tr>
-
<tr><td>zone</td><td><table><tr><td><b>partitionNumber</b> - Partition number (1-8) - Not Required - default=1.</td></tr><tr><td><b>zoneNumber</b> - Zone number (1-64) - Required.</td></tr></table></td></tr>
- <tr><td>keypad</td><td>No parameters</td></tr>
+ <tr><td>partition</td><td><b>partitionNumber</b> - Partition number (1-8) - Required.</td></tr>
+ <tr><td>zone</td><td><table><tr><td><b>partitionNumber</b> - Partition number (1-8) - Not Required - default=1.</td></tr><tr><td><b>zoneNumber</b> - Zone number (1-64) - Required.</td></tr></table></td></tr>
+ <tr><td>keypad</td><td>No parameters</td></tr>
</table>
The binding can be configured manually if discovery is not used.
<tr><td>keypad_lcd_cursor</td><td>String</td><td>LCD Cursor Position for The IT-100</td></tr>
</table>
-##Example
+## Example
The following is an example of an item file (dscalarm.items):
This binding reads the P1-port of:
-* Dutch Smart Meters that comply to NTA8130, DSMR v2.1, DSMR v2.2, DSMR v3.0, DSMR v4.0, DSMR v4.04, and DSMR 5.0.
-* Belgium Smart Meters that comply to e-MUCS v1.0.
-* Luxembourg’s electricity meter "Smarty" that comply to V1.0.
-* Austrian electricity meters.
+- Dutch Smart Meters that comply to NTA8130, DSMR v2.1, DSMR v2.2, DSMR v3.0, DSMR v4.0, DSMR v4.04, and DSMR 5.0.
+- Belgium Smart Meters that comply to e-MUCS v1.0.
+- Luxembourg’s electricity meter "Smarty" that comply to V1.0.
+- Austrian electricity meters.
Although DSMR v4.2 is not an official specification, the binding has support for this version.
| additionalKey | Additional key for meters that require a secondary key. Some meters in Austria require this |
| receivedTimeout | The time out period in which messages are expected to arrive, default is 120 seconds |
-
-**Note:** *The manual configuration is only needed if the DSMR-device requires non DSMR-standard Serial Port parameters (i.e. something different then `115200 8N1` or `9600 7E1`)*
+**Note:** _The manual configuration is only needed if the DSMR-device requires non DSMR-standard Serial Port parameters (i.e. something different then `115200 8N1` or `9600 7E1`)_
### Troubleshooting
| ACE4000 GTMM Mk3 Gas meter | `gas_ace4000` | 3 | 1 hour |
| DSMR V2.1 Gas meter | `gas_v2_1` | 0 | 24 hours |
| DSMR V2.2 Gas meter | `gas_v2_2` | 0 | 24 hours |
-| DSMR V3.0 Gas meter | `gas_v3_0` | *note 1* | 1 hour |
-| e-MUCS V1.0 Gas meter | `gas_emucs_v1_0` | *note 1* | ? |
+| DSMR V3.0 Gas meter | `gas_v3_0` | _note 1_ | 1 hour |
+| e-MUCS V1.0 Gas meter | `gas_emucs_v1_0` | _note 1_ | ? |
| ACE4000 GTMM Mk3 Cooling meter | `cooling_ace4000` | 6 | 1 hour |
| DSMR V2.2 Cooling meter | `cooling_v2_2` | 0 | 1 hour |
| ACE4000 GTMM Mk3 Heating meter | `heating_ace4000` | 4 | 1 hour |
| DSMR V2.2 Heating meter | `heating_v2_2` | 0 | 1 hour |
| ACE4000 GTMM Mk3 Water meter | `water_ace4000` | 5 | 1 hour |
| DSMR V2.2 Water meter | `water_v2_2` | 0 | 1 hour |
-| DSMR V3.0 Water meter | `water_v3_0` | *note 1* | 1 hour |
+| DSMR V3.0 Water meter | `water_v3_0` | _note 1_ | 1 hour |
| ACE4000 GTMM Mk3 1st Slave Electricity meter | `slave_electricity1_ace4000` | 1 | 1 hour |
| ACE4000 GTMM Mk3 2nd Slave Electricity meter | `slave_electricity2_ace4000` | 2 | 1 hour |
-| DSMR V4.x Slave Electricity meter | `slave_electricity_v4` | *note 1* | 1 hour |
-| DSMR V5 Slave Electricity meter | `slave_electricity_v5` | *note 1* | 5 minutes |
-| DSMR V3.0 Generic meter | `generic_v3_0` | *note 1* | 1 hour |
-| DSMR V3.0 Giga Joule meter (heating or cooling) | `gj_v3_0` | *note 1* | 1 hour |
-| DSMR V4.x Giga Joule meter (heating or cooling) | `gj_v4` | *note 1* | 1 hour |
-| DSMR V5 Giga Joule meter (heating or cooling) | `gj_v5_0` | *note 1* | 5 minutes |
-| DSMR V4.x m3 meter (gas or water) | `m3_v4` | *note 1* | 1 hour |
-| DSMR V5 m3 meter (gas or water) | `m3_v5_0` | *note 1* | 5 minutes |
-
-*note 1*. The channel of these meters is dependent on the physical installation and corresponds to the M-Bus channel.
-You can ask your supplier / installer for this information or you can retrieve it from the logfiles (see *Determine M-Bus channel*).
+| DSMR V4.x Slave Electricity meter | `slave_electricity_v4` | _note 1_ | 1 hour |
+| DSMR V5 Slave Electricity meter | `slave_electricity_v5` | _note 1_ | 5 minutes |
+| DSMR V3.0 Generic meter | `generic_v3_0` | _note 1_ | 1 hour |
+| DSMR V3.0 Giga Joule meter (heating or cooling) | `gj_v3_0` | _note 1_ | 1 hour |
+| DSMR V4.x Giga Joule meter (heating or cooling) | `gj_v4` | _note 1_ | 1 hour |
+| DSMR V5 Giga Joule meter (heating or cooling) | `gj_v5_0` | _note 1_ | 5 minutes |
+| DSMR V4.x m3 meter (gas or water) | `m3_v4` | _note 1_ | 1 hour |
+| DSMR V5 m3 meter (gas or water) | `m3_v5_0` | _note 1_ | 5 minutes |
+
+_note 1_. The channel of these meters is dependent on the physical installation and corresponds to the M-Bus channel.
+You can ask your supplier / installer for this information or you can retrieve it from the logfiles (see _Determine M-Bus channel_).
-#### Configuration
+### Configuration
The configuration for the meters consists of the following parameters:
| refresh | Time in seconds with which the state of the device is updated. Default is 60 seconds |
| channel | M-Bus channel. See the table above |
+#### Examples
-**Examples**
-
-```
+```java
Bridge dsmr:dsmrBridge:myDSMRDevice [serialPort="/dev/ttyUSB0"] {
Things:
device_v5 dsmrDeviceV5 [channel=-1]
- \- channel is not supported
- O channel is supported only if the device has this functionality
-
| Channel Type ID | Item Type | Description | Ace4000 | DSMR V2.1 | DSMR V2.2 | DSMR V3.0 | DSMR V4.0 | DSMR V4.0.4 | DSMR V4.2 | DSMR V5 | SMARTY V1.0 | e-MUCS V1.0 | Austian |
|--------------------------------------------------|--------------------------|------------------------------------------------------------------------|---------|-----------|-----------|-----------|-----------|-------------|-----------|---------|-------------|-------------|---------|
| | | **Channels for the generic device** | | | | | | | | | | | |
| `emeter_power_failures` | Number | Number of power failures | - | - | - | - | Y | Y | Y | Y | Y | - | - |
| `emeter_long_power_failures` | Number | Number of long power failures | - | - | - | - | Y | Y | Y | Y | - | - | - |
| `emeter_power_failure_log_entries` | Number | Number of entries in the power failure log | - | - | - | - | Y | Y | Y | Y | Y | - | - |
-| `emeter_power_failure_log_timestamp[x]` *note 2* | DateTime | Timestamp for entry [x] in the power failure log | - | - | - | - | Y | Y | Y | Y | Y | - | - |
-| `emeter_power_failure_log_duration[x]` *note 2* | Number:Time | Duration for entry [x] the power failure log | - | - | - | - | Y | Y | Y | Y | Y | - | - |
+| `emeter_power_failure_log_timestamp[x]` _note 2_ | DateTime | Timestamp for entry [x] in the power failure log | - | - | - | - | Y | Y | Y | Y | Y | - | - |
+| `emeter_power_failure_log_duration[x]` _note 2_ | Number:Time | Duration for entry [x] the power failure log | - | - | - | - | Y | Y | Y | Y | Y | - | - |
| `emeter_voltage_sags_l1` | Number | Number of voltage sags L1 | - | - | - | - | Y | Y | Y | Y | Y | - | - |
| `emeter_voltage_sags_l2` | Number | Number of voltage sags L2 | - | - | - | - | O | O | O | O | O | - | - |
| `emeter_voltage_sags_l3` | Number | Number of voltage sags L3 | - | - | - | - | O | O | O | O | O | - | - |
| `wmeter_value_v3` | Number:Volume | Water Delivery past period | - | - | - | Y | - | - | - | - | - | - | - |
| `meter_valve_switch_position` | Number | Water Meter Valve position | - | - | - | Y | - | - | - | - | - | - | - |
-*note 2*. The power failure log has a dynamic number of entries starting at `0`.
+_note 2_. The power failure log has a dynamic number of entries starting at `0`.
So `emeter_power_failure_log_timestamp0`, `emeter_power_failure_log_duration0` refers to the first entry,
`emeter_power_failure_log_timestamp1`, `emeter_power_failure_log_duration1` refers to the second entry, etc.
The following configuration must to be added to an item configuration file. E.g. `things/dsmr.items`
-```
+```java
ItemType <name> "<description>" (<Group>) {channel="<Channel identifier>"}
```
-**Examples**
+##### Examples
-```
+```java
Number:Energy MeterDeliveryTariff0 "Delivered Low Tariff [%.3f kWh]" {channel="dsmr:electricity_v5_0:mysmartmeter:electricityV5:emeter_delivery_tariff1}
```
`things/dsmr.things`
-```
+```java
Bridge dsmr:dsmrBridge:mysmartmeter [serialPort="/dev/ttyUSB0"] {
Things:
device_v5 dsmrV5Device [channel=-1]
`things/dsmr.items`
-```
+```java
String P1Version "P1 Version output" {channel="dsmr:device_v5:mysmartmeter:dsmrV5Device:p1_version_output"}
Number:Energy MeterDeliveryTariff0 "Delivered Low Tariff [%.3f kWh]" {channel="dsmr:electricity_v5_0:mysmartmeter:electricityV5:emeter_delivery_tariff1"}
Number:Energy MeterDeliveryTariff1 "Delivered High Tariff [%.3f kWh]" {channel="dsmr:electricity_v5_0:mysmartmeter:electricityV5:emeter_delivery_tariff2"}
Here you find the ThingTypeID (it is stated only in capitals) and the M-Bus channel. The above example would lead to the following Thing definition
-```
+```java
Bridge definition {
Things:
m3_v5_0 mygasmeter [channel=1]
# DWD Pollenflug Binding
-The "Deutsche Wetterdienst" (DWD) reports the current pollen count index for Germany on a daily base and a forecast for tomorrow and the day after tomorrow.
-This binding allows you to retrieve this data for your region or partregion. You can find a map of the data here:
-
-https://isabel.dwd.de/DE/leistungen/gefahrenindizespollen/gefahrenindexpollen.html
-
+The "Deutsche Wetterdienst" (DWD) reports the current pollen count index for Germany on a daily base and a forecast for tomorrow and the day after tomorrow.
+This binding allows you to retrieve this data for your region or partregion.
+You can find a map of the data [here](https://isabel.dwd.de/DE/leistungen/gefahrenindizespollen/gefahrenindexpollen.html)
## Supported Things
-This binding supports a bridge thing (`bridge`), which polls the dataset for Germany in an adjustable interval.
+This binding supports a bridge thing (`bridge`), which polls the dataset for Germany in an adjustable interval.
And it supports a region thing (`region`), representing the data for all pollen types of a region or partregion.
## Discovery
-This binding adds a default `bridge` thing to the Inbox.
+This binding adds a default `bridge` thing to the Inbox.
This can be used for `region` things you may add manually.
## Thing Configuration
| ---------- | :-----: | :------: | ------------------------------------------------------------------- |
| `regionID` | - | yes | The id of the region. The available options are in the table below. |
-#### Manual region or partregion selection ####
+#### Manual region or partregion selection
-The region ID is the partregion_id or if there is no partregion the region_id from this [json](https://opendata.dwd.de/climate_environment/health/alerts/s31fg.json) of DWD.
+The region ID is the partregion_id or if there is no partregion the region_id from this [json](https://opendata.dwd.de/climate_environment/health/alerts/s31fg.json) of DWD.
You can refer to the following table.
| regionID | Region | Partregion |
## Full Example
-### Things file for region "Brandenburg und Berlin" and partregion "Bayern - Mainfranken" ###
+### Things file for region "Brandenburg und Berlin" and partregion "Bayern - Mainfranken"
-```
+```java
Bridge dwdpollenflug:bridge:dwd "DWD pollen count Bridge" [refresh="15"] {
Thing region region50 "DWD pollen count region" @ "APIS" [regionID="50"]
Thing region partregion124 "DWD pollen count partregion" @ "APIS" [regionID="124"]
}
```
-### Items example for region "Brandenburg und Berlin" and pollen type ash-tree ###
+### Items example for region "Brandenburg und Berlin" and pollen type ash-tree
-```
+```java
String pollenTodayEsche
"Esche [MAP(pollen.map):%s]"
{channel="dwdpollenflug:region:dwd:region50:ash#today"}
```
-### Transform map file pollen.map ###
+### Transform map file pollen.map
-```
+```text
0=keine (0)
0-1=keine bis gering (0-1)
1=gering (1)
NULL=keine Daten
```
-### Sitemap example for region "Brandenburg und Berlin" and pollen type ash-tree ###
+### Sitemap example for region "Brandenburg und Berlin" and pollen type ash-tree
-```
+```perl
Text label="Pollenflugindex" {
Frame {
Text item=pollenTodayEsche
The DWD provides weather warnings for Germany.
Regions outside of Germany are not supported.
-
## Supported Things
This binding supports one thing, the Weather Warning.
Each Thing provides one or more warnings for a city.
-
## Thing Configuration
| Property | Default | Required | Description |
| refresh | 30 | No | Time between API requests in minutes. Minimum 15 minutes. |
| warningCount | 1 | No | Number of warnings to provide. |
-
### Cell ID
<!-- See page 10-13 (in German) of https://www.dwd.de/DE/wetter/warnungen_aktuell/objekt_einbindung/einbindung_karten_geodienste.pdf?__blob=publicationFile&v=14 for Cell ID documentation. -->
Use [this list](https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv) of valid IDs, please notice that **only IDs starting with an eight (8) and nine digits are supported** by this binding.
Exeception for Berlin, where the ID of the city's districts are used. Those start with a seven (7).
-Using the percent sign (%) as a wildcard, it is possible to query multiple cells.
+Using the percent sign (%) as a wildcard, it is possible to query multiple cells.
For example, the value `8111%` retrieves all cell IDs that start with `8111`.
More explanation (in German) for CellID can be found on page 10-13 of [PDF: DWD-Geoserver: Nutzung von WMS-Diensten für eigene Websites](https://www.dwd.de/DE/wetter/warnungen_aktuell/objekt_einbindung/einbindung_karten_geodienste.pdf?__blob=publicationFile&v=14).
Example:
-```
+```java
dwdunwetter:dwdwarnings:cologne "Warnings Cologne" [ cellId="805315000", refresh=15, warningCount=1 ]
```
-
## Channels
The are multiple channels for every weather warning.
The warnings will be sorted first by `Severity` and then by the `Valid From` date.
This ensures that the channels for the first warning will always be the highest Severity.
If the API returns more warnings than the configured number in the Thing, the warnings with the lowest Severity will be dropped.
-
+
| Channel | Type | Description |
|--------------|-----------------|-----------------------------------------------------------------------------------|
| warningN | Switch | ON if a warning is present |
All channels are readonly.
The main purpose of the channel `warningN` is to be used for controlling visibility in sitemaps.
-The channel can also be used in rules to check if there is a warning present.
-It should not be used for rules that need to fire if a new warning shows up.
-If a warning is replaced by another warning, that channel stays at ON, and there will be no state change.
-For rules that need to fire if a new warning occurs, there is the trigger channel `updatedN`.
+The channel can also be used in rules to check if there is a warning present.
+It should not be used for rules that need to fire if a new warning shows up.
+If a warning is replaced by another warning, that channel stays at ON, and there will be no state change.
+For rules that need to fire if a new warning occurs, there is the trigger channel `updatedN`.
That trigger channel fires an event whenever a warning is sent for the first time.
It also triggers if a warning is replaced by another.
More explanations about the specific values of the channels can be found in the PDF documentation of the DWD at: [CAP DWD Profile 1.2](https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_dwd_profile_en_pdf_1_12.html).
-Please note that this binding only supports *Gemeinden* (COMMUNE) for *WarncellID*.
+Please note that this binding only supports _Gemeinden_ (COMMUNE) for _WarncellID_.
## Full Example
dwdunwetter.things:
-```
+```java
dwdunwetter:dwdwarnings:cologne "Warnings Cologne" [ cellId="805315000", refresh=15, warningCount=1 ]
```
to get two warnings like in the item example, set `warningCount=2` in things file
-```
+```java
dwdunwetter:dwdwarnings:cologne "Warnings Cologne" [ cellId="805315000", refresh=15, warningCount=2 ]
```
dwdunwetter.items:
-```
+```java
Switch WarningCologne_1 "Weather warning [MAP(dwdunwetter_de.map):%s]" { channel="dwdunwetter:dwdwarnings:cologne:warning1" }
String WarningCologneServerity_1 "Severity [MAP(dwdunwetter_severity_de.map):%s]" { channel="dwdunwetter:dwdwarnings:cologne:severity1" }
String WarningCologneBeschreibung_1 "[%s]" { channel="dwdunwetter:dwdwarnings:cologne:description1" }
demo.sitemap:
-```
+```perl
sitemap demo label="Main Menu" {
Frame {
Text item=WarningCologneTitel visibility=[WarningCologne==ON]
dwdunwetter.rules
-```
+```java
rule "New Warnung"
when
Channel 'dwdunwetter:dwdwarnings:cologne:updated1' triggered NEW
dwdunwetter_de.map
-```
+```text
ON=aktiv
OFF=inaktiv
NULL=undefiniert
dwdunwetter_severity_de.map
-```
+```text
Minor=Wetterwarnung
Moderate=Markante Wetterwarnung
Severe=Unwetterwarnung
dwdunwetter_urgency_de.map
-```
+```text
Immediate=Warnung
Future=Vorabinformation
NULL=undefiniert
UNDEF=undefiniert
```
-If you're unsure if the binding is working correctly, you can access the data directly by visiting https://maps.dwd.de/geoserver/dwd/ows?service=WFS&version=2.0.0&request=GetFeature&typeName=dwd:Warnungen_Gemeinden&CQL_FILTER=WARNCELLID%20LIKE%20%27CELL_ID%27 (replace `CELL_ID` with your Cell ID), allowing the download and opening the downloaded `.xml` file.
+If you're unsure if the binding is working correctly, you can access the data directly by visiting `https://maps.dwd.de/geoserver/dwd/ows?service=WFS&version=2.0.0&request=GetFeature&typeName=dwd:Warnungen_Gemeinden&CQL_FILTER=WARNCELLID%20LIKE%20%27CELL_ID%27` (replace `CELL_ID` with your Cell ID), allowing the download and opening the downloaded `.xml` file.
Das Binding unterstützt genau ein Thing - Unwetterwarnungen.
Ein Thing stellt dabei eine oder mehrere Warnungen für eine Gemeinde bereit.
-
## Thing Konfiguration
| Property | Standard | Erforderlich | Beschreibung |
Beispiel:
-```
+```java
dwdunwetter:dwdwarnings:koeln "Warnungen Köln" [ cellId="805315000", refresh=15, warningCount=1 ]
```
## Channels
-Für jede bereitgestellte Warnung werden mehrere Channels bereitgestellt.
-Die Channels sind jeweils durchnummeriert, Channels die mit 1 enden sind für die erste Warnung, Channels die mit 2 enden für die zweite Warnung usw.
-Die vom DWD gelieferten Warnungen werden dabei nach Severity (Warnstufe) sortiert und innerhalb der Warnstufe nach Beginndatum.
-Dadurch ist sichergestellt, dass in den Channels für die erste Warnung (...1) immer die Warnung mit der höchsten Warnstufe steht.
+Für jede bereitgestellte Warnung werden mehrere Channels bereitgestellt.
+Die Channels sind jeweils durchnummeriert, Channels die mit 1 enden sind für die erste Warnung, Channels die mit 2 enden für die zweite Warnung usw.
+Die vom DWD gelieferten Warnungen werden dabei nach Severity (Warnstufe) sortiert und innerhalb der Warnstufe nach Beginndatum.
+Dadurch ist sichergestellt, dass in den Channels für die erste Warnung (...1) immer die Warnung mit der höchsten Warnstufe steht.
Werden mehr Warnungen vom DWD geliefert, als an Channels konfiguriert ist, werden dadurch die Warnungen mit der niedrigsten Warnstufe verworfen.
| Channel | Type | Beschreibung |
Sämtliche Channels sind ReadOnly!
-Der Channel _warningN_ dient hauptsächlich dazu, um z.B. in Sitemaps dynamisch Warnungen ein- oder auszublenden, bzw. um in Regeln zu prüfen, ob überhaupt eine Warnung vorliegt.
-Er ist nicht geeignet um auf das Erscheinen einer Warnung zu prüfen.
-Denn wenn eine Warnung durch eine neue Warnung ersetzt wird, bleibt der Zustand ON, es gibt keinen Zustandswechsel.
-Um auf das erscheinen einer Warnung zu prüfen, sollte der Trigger-Channel _updatedN_ genutzt werden.
-Der feuert immer dann, wenn eine Warnung das erste mal gesendet wird.
-Das heißt, der feuert auch dann, wenn eine Warnung durch eine neue Warnung ersetzt wird.
+Der Channel _warningN_ dient hauptsächlich dazu, um z.B. in Sitemaps dynamisch Warnungen ein- oder auszublenden, bzw. um in Regeln zu prüfen, ob überhaupt eine Warnung vorliegt.
+Er ist nicht geeignet um auf das Erscheinen einer Warnung zu prüfen.
+Denn wenn eine Warnung durch eine neue Warnung ersetzt wird, bleibt der Zustand ON, es gibt keinen Zustandswechsel.
+Um auf das erscheinen einer Warnung zu prüfen, sollte der Trigger-Channel _updatedN_ genutzt werden.
+Der feuert immer dann, wenn eine Warnung das erste mal gesendet wird.
+Das heißt, der feuert auch dann, wenn eine Warnung durch eine neue Warnung ersetzt wird.
Weitere Erläuterungen der Bedeutungen finden sich in der Dokumentation des DWDs unter [CAP DWD Profile 1.2](https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_dwd_profile_de_pdf.pdf?__blob=publicationFile&v=7).
-Bitte bedenke, dass dieses Binding nur *Gemeinden* unterstützt.
+Bitte bedenke, dass dieses Binding nur _Gemeinden_ unterstützt.
## Vollständiges Beispiel
demo.things:
-```
+```java
dwdunwetter:dwdwarnings:koeln "Warnungen Köln" [ cellId="805315000", refresh=15, warningCount=1 ]
```
demo.items:
-```
+```java
Switch WarnungKoeln "Warnung vorhanden" { channel="dwdunwetter:dwdwarnings:koeln:warning1" }
String WarnungKoelnServerity "Warnstufe [%s]" { channel="dwdunwetter:dwdwarnings:koeln:severity1" }
String WarnungKoelnBeschreibung "[%s]" { channel="dwdunwetter:dwdwarnings:koeln:description1" }
demo.sitemap:
-```
+```perl
sitemap demo label="Main Menu" {
Frame {
Text item=WarnungKoelnTitel visibility=[WarnungKoeln==ON]
demo.rules
-```
+```java
rule "Neue Warnung"
when
Channel 'dwdunwetter:dwdwarnings:koeln:updated1' triggered NEW
end
```
+
dwdunwetter_de.map
-```
+```text
ON=aktiv
OFF=inaktiv
NULL=undefiniert
dwdunwetter_severity_de.map
-```
+```text
Minor=Wetterwarnung
Moderate=Markante Wetterwarnung
Severe=Unwetterwarnung
dwdunwetter_urgency_de.map
-```
+```text
Immediate=Warnung
Future=Vorabinformation
NULL=undefiniert
UNDEF=undefiniert
```
-Wenn du unsicher bist, ob das Binding korrekt funktioniert, kannst du die Wetterdaten direkt mit deinem Browser abrufen, indem du https://maps.dwd.de/geoserver/dwd/ows?service=WFS&version=2.0.0&request=GetFeature&typeName=dwd:Warnungen_Gemeinden&CQL_FILTER=WARNCELLID%20LIKE%20%27CELL_ID%27 (ersetze `CELL_ID` mit deiner Cell ID) besuchst, den Datei Download zulässt und die heruntergeladene `.xml` Datei öffnest.
+Wenn du unsicher bist, ob das Binding korrekt funktioniert, kannst du die Wetterdaten direkt mit deinem Browser abrufen, indem du `https://maps.dwd.de/geoserver/dwd/ows?service=WFS&version=2.0.0&request=GetFeature&typeName=dwd:Warnungen_Gemeinden&CQL_FILTER=WARNCELLID%20LIKE%20%27CELL_ID%27` (ersetze `CELL_ID` mit deiner Cell ID) besuchst, den Datei Download zulässt und die heruntergeladene `.xml` Datei öffnest.
## Supported Things
-This binding provides three thing types:
+This binding provides three thing types:
| Thing/Bridge | Thing Type | Description |
|---------------------|---------------------|-----------------------------------------------------------------------------------------------|
| thing | charger | the physical charger which is connected to a circuit within the given site |
| thing | mastercharger | like the "normal" charger but with additional capability to control the circuit |
-
Basically any Easee wallbox that supports the Cloud API should automatically be supported by this binding.
## Discovery
|-------------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| username | yes | The username to login at Easee Cloud service. This should be an e-mail address or phone number. |
| passord | yes | Your password to login at Easee Cloud service. |
-| siteId | yes | The ID of the site containing the wallbox(es) and circuit(s) that should be integrated into openHAB. The ID of your site can be found via the sites overview (https://easee.cloud/sites). You just need to click one of the sites listed there, the id will be part of the URL which is then opened. It will be a number with typically 6 digits. |
+| siteId | yes | The ID of the site containing the wallbox(es) and circuit(s) that should be integrated into openHAB. The ID of your site can be found via the sites overview (<https://easee.cloud/sites>). You just need to click one of the sites listed there, the id will be part of the URL which is then opened. It will be a number with typically 6 digits. |
| dataPollingInterval | no | Interval (seconds) in which live data values are retrieved from the Easee Cloud API. (default = 120) |
## Thing configuration
## Full Example
-### Thing
+### Thing
#### Minimum configuration
-```
+```java
Bridge easee:site:mysite1 [ username="abc@def.net", password="secret", siteId="123456" ]
```
#### Manual configuration with two chargers, pollingInterval set to 60 seconds.
-```
+```java
Bridge easee:site:mysite1 [ username="abc@def.net", password="secret", siteId="471111", dataPollingInterval=60 ] {
Thing mastercharger myCharger1 [ id="EHXXXXX1", circuitId="1234567" ]
Thing charger myCharger2 [ id="EHXXXXX2" ]
}
```
-
### Items
-```
+```java
Number:ElectricCurrent Easee_Circuit_Phase1 "Phase 1" { channel="easee:mastercharger:mysite1:myCharger1:dynamicCurrent#phase1" }
Number:ElectricCurrent Easee_Circuit_Phase2 "Phase 2" { channel="easee:mastercharger:mysite1:myCharger1:dynamicCurrent#phase2" }
Number:ElectricCurrent Easee_Circuit_Phase3 "Phase 3" { channel="easee:mastercharger:mysite1:myCharger1:dynamicCurrent#phase3" }
### Sitemap
-```
+```java
Switch item=Easee_Circuit_Dynamic_Phases mappings=["0;0;0"="0.00 kW", "6;0;0"="1.44 kW", "7;0;0"="1.68 kW", "8;0;0"="1.92 kW", "9;0;0"="2.16 kW", "10;0;0"="2.40 kW", "16;0;0"="3.72 kW", "16;16;16"="11.1 kW"] icon="energy"
```
easeePhases.map will make the phase setting more readable.
-```
+```text
0;0;0=0.00 kW
6;0;0=1.44 kW
7;0;0=1.68 kW
# EchonetLite Binding
-This binding supports devices that make use of the Echonet Lite specification (https://echonet.jp/spec_v113_lite_en/).
+This binding supports devices that make use of the [Echonet Lite specification](https://echonet.jp/spec_v113_lite_en/).
## Supported Things
-* Mitsubishi Electric MAC-568IF-E Wi-Fi interface (common on most Mitsubishi Heat Pumps).
+- Mitsubishi Electric MAC-568IF-E Wi-Fi interface (common on most Mitsubishi Heat Pumps).
## Discovery
The bridge configuration defaults should be applicable in most scenarios.
If device discovery is not working, this is most likely caused by the inability to receive multicast traffic from the device nodes.
-* __port__: Port used for messaging both to and from device nodes, defaults to 3610.
-* __multicastAddress__: Multicast address used to discover device nodes and to receive asynchronous notifications from devices.
+- **port**: Port used for messaging both to and from device nodes, defaults to 3610.
+- **multicastAddress**: Multicast address used to discover device nodes and to receive asynchronous notifications from devices.
## Thing Configuration
-* __hostname__: Hostname or IP address of the device node.
-* __port__: Port used to communicate with the device.
-* __groupCode__: Group code as specified in "APPENDIX Detailed Requirements for ECHONET Device objects" (https://echonet.jp/spec_object_rp1_en/).
+- **hostname**: Hostname or IP address of the device node.
+- **port**: Port used to communicate with the device.
+- **groupCode**: Group code as specified in "APPENDIX Detailed Requirements for ECHONET Device objects" (<https://echonet.jp/spec_object_rp1_en/>).
For Air Conditioners the value is '1'.
-* __classCode__: Class code for the device, see __groupCode__ for reference information.
+- **classCode**: Class code for the device, see **groupCode** for reference information.
The value for Home Air Conditioners is '48' (0x30).
-* __instance__: Instance identifier if multiple instances are running on the same IP address.
+- **instance**: Instance identifier if multiple instances are running on the same IP address.
Typically, this value will be '1'.
-* __pollIntervalMs__: Interval between polls of the device for its current status.
+- **pollIntervalMs**: Interval between polls of the device for its current status.
If multicast is not working this will determine the latency at which changes made directly on the device will be propagated back to openHAB, default is 30 000ms.
-* __retryTimeoutMs__: Length of time the bridge will wait before resubmitting a request, default is 2 000ms.
+- **retryTimeoutMs**: Length of time the bridge will wait before resubmitting a request, default is 2 000ms.
Because the binding uses UDP, packets can be lost on the network, so retries are necessary.
Testing has shown that 2 000ms is a reasonable default that allows for timely retries without rejecting slow, but legitimate responses.
## Channels
Channels are derived from the Echonet Lite specification and vary from device to device depending on capabilities.
-The full set of potential channels is available from "APPENDIX Detailed Requirements for ECHONET Device objects" (https://echonet.jp/spec_object_rp1_en/)
+The full set of potential channels is available from "APPENDIX Detailed Requirements for ECHONET Device objects" (<https://echonet.jp/spec_object_rp1_en/>)
The channels currently implemented are:
## Full Example
-
### Things
-```
+```java
Bridge echonetlite:bridge:1 [port="3610", multicastAddress="224.0.23.0"] {
Thing device HeatPump_Bedroom1 "HeatPump Bedroom 1" @ "Bedroom 1" [hostname="192.168.0.55", port="3610", groupCode="1", classCode="48", instance="1", pollIntervalMs="30000", retryTimeoutMs="2000"]
}
### Items
-```
+```java
Switch HeatPumpBedroom1_OperationStatus "HeatPump Bedroom1 Operation Status" {channel="echonetlite:device:1:HeatPump_Bedroom1:operationStatus"}
```
# Ecobee Binding
-[Ecobee Inc.](https://www.ecobee.com/) of Toronto, Canada, sells a range of Wi-Fi
-enabled thermostats, principally in the Americas.
-This binding communicates with the
-[Ecobee API](https://www.ecobee.com/home/developer/api/introduction/index.shtml) over a secure,
-RESTful API to Ecobee's servers.
-Monitoring ambient temperature and humidity, changing HVAC mode, changing heat or cool setpoints,
-changing the backlight intensity, and even sending textual messages to one or a group of thermostats,
+[Ecobee Inc.](https://www.ecobee.com/) of Toronto, Canada, sells a range of Wi-Fi
+enabled thermostats, principally in the Americas.
+This binding communicates with the
+[Ecobee API](https://www.ecobee.com/home/developer/api/introduction/index.shtml) over a secure,
+RESTful API to Ecobee's servers.
+Monitoring ambient temperature and humidity, changing HVAC mode, changing heat or cool setpoints,
+changing the backlight intensity, and even sending textual messages to one or a group of thermostats,
can be accomplished through this binding.
## Supported Things
## Discovery
-Once an Account has been set up, and the API key has been authorized, Thermostats and Remote
+Once an Account has been set up, and the API key has been authorized, Thermostats and Remote
Sensors will be discovered automatically.
First, the thermostats will be added to the inbox.
-Then, once a Thermostat thing has been created, the Remote Sensors associated with that
+Then, once a Thermostat thing has been created, the Remote Sensors associated with that
thermostat will be added to the inbox.
-The binding will detect the capabilities (e.g. temperature, humidity, occupancy) supported by the
+The binding will detect the capabilities (e.g. temperature, humidity, occupancy) supported by the
sensor, and then dynamically create channels for those capabilities.
## Getting Started
1. First you need to register your thermostat(s) with Ecobee.
To complete this step, follow the directions in your Ecobee set up documentation.
-2. Once the thermostats are registered, the next step is to sign up as a developer.
+1. Once the thermostats are registered, the next step is to sign up as a developer.
Do this from the Ecobee [developer portal](https://www.ecobee.com/developers/).
-3. Now that you are set up as an Ecobee developer, login to your Ecobee [web portal](https://www.ecobee.com/).
+1. Now that you are set up as an Ecobee developer, login to your Ecobee [web portal](https://www.ecobee.com/).
Once logged in, select the **Developer** option from the menu.
If you don't see the **Developer** option on the menu, then something went wrong with the previous step.
-4. Finally, create a new application.
+1. Finally, create a new application.
Give the application a name and fill in the application summary.
Select the **Ecobee PIN** Authorization Method, then press **Create**.
The PIN code will be valid for several minutes.
The status message will look something like this.
-```
+```text
Enter PIN 'JULO-RVLA' in MyApps. PIN expires in 257 minutes.
```
To complete the authorization, the PIN code must be entered into the Ecobee **My Apps** settings in your account at ecobee.com.
This will authorize the binding to work with the thermostats associated with your Ecobee account.
-Once authorization is complete, the binding will retrieve information about the available thermostats,
+Once authorization is complete, the binding will retrieve information about the available thermostats,
and add those thermostats to the inbox.
## Ecobee Authorization Changes Effective 1 December 2020
| dryContact | String | | Dry contact status reported by the sensor |
| vocPPM | String | | Volatile organic compounds (VOC) reported by the sensor (low-high) |
-
## Thing Actions
### Acknowledge
The acknowledge function allows an alert to be acknowledged by specifying the alert's acknowledgement ref.
-##### acknowledge - acknowledge an alert
+#### acknowledge - acknowledge an alert
```java
boolean acknowledge(String ackRef, String ackType, Boolean remindMeLater)
```
-```
+```text
Parameters:
ackRef - The acknowledge ref of alert.
ackType - The type of acknowledgement. Valid values: accept, decline, defer, unacknowledged.
Creates a hold for the on or off state of the plug for the specified duration.
Note that an event is created regardless of whether the program is in the same state as the requested state.
-##### controlPlug - Control the on/off state of a plug
+#### controlPlug - Control the on/off state of a plug
```java
boolean controlPlug(String plugName, String plugState, Date startDateTime, Date endDateTime, String holdType, Number holdHours)
```
-```
+```text
Parameters:
plugName - Name of plug to be controlled.
plugState - State to which plug should be set (on, off, resume).
If the start/end date/times are not provided for the vacation event,
the vacation event will begin immediately and last 14 days.
-If both the coolHoldTemp and heatHoldTemp parameters provided to this function have the same value,
+If both the coolHoldTemp and heatHoldTemp parameters provided to this function have the same value,
and the Thermostat is in auto mode, then the two values will be adjusted during processing to be
separated by the value stored in thermostat.settings.heatCoolMinDelta.
-##### createVacation - Create a vacation event on the thermostat
+#### createVacation - Create a vacation event on the thermostat
```java
boolean createVacation(String name, QuantityType<Temperature> coolHoldTemp, QuantityType<Temperature> heatHoldTemp, Date startDateTime, Date endDateTime, String fan, Number fanMinOnTime)
```
-```
+```text
Parameters:
name - The vacation event name. It must be unique.
coolHoldTemp - The temperature to set the cool vacation hold at.
### Delete Vacation
The delete vacation function deletes a vacation event from a thermostat.
-This is the only way to cancel a vacation event.
+This is the only way to cancel a vacation event.
This method is able to remove vacation events not yet started and scheduled in the future.
-##### deleteVacation - delete a vacation event from a thermostat
+#### deleteVacation - delete a vacation event from a thermostat
```java
boolean deleteVacation(String name)
```
-```
+```text
Parameters:
name - Name of vacation to be deleted.
### Reset Preferences
-The reset preferences function sets all of the user configurable settings back
-to the factory default values.
-This function call will not only reset the top level thermostat settings such
-as hvacMode, lastServiceDate and vent, but also all of the user configurable
+The reset preferences function sets all of the user configurable settings back
+to the factory default values.
+This function call will not only reset the top level thermostat settings such
+as hvacMode, lastServiceDate and vent, but also all of the user configurable
fields of the thermostat.settings and thermostat.program objects.
-Note that this does not reset all values.
+Note that this does not reset all values.
For example, the installer settings and wifi details remain untouched.
-##### resetPreferences - Sets all user configurable settings back to factory defaults
-
```java
boolean resetPreferences()
```
-```
+```text
Returns - true if the operation was successful, false otherwise
```
### Resume program
-The resume program function removes the currently running event providing the event
-is not a mandatory demand response event.
-If resumeAll parameter is not set, top active event is removed from the stack and
+The resume program function removes the currently running event providing the event
+is not a mandatory demand response event.
+If resumeAll parameter is not set, top active event is removed from the stack and
the thermostat resumes its program, or enters the next event in the stack if one exists.
If resumeAll parameter set to true, the function resumes all events and returns the thermostat to its program.
-##### resumeProgram - Remove the currently running event
+#### resumeProgram - Remove the currently running event
```java
boolean resumeProgram(Boolean resumeAll)
```
-```
+```text
Parameters:
resumeAll - Indicates if the thermostat should be resumed to next event (false) or to its program (true).
### Send Message
-The send message function allows an alert message to be sent to the thermostat.
+The send message function allows an alert message to be sent to the thermostat.
The message properties are same as those of the Alert Object.
-##### - sendMessage - Send a message to a thermostat
+#### - sendMessage - Send a message to a thermostat
```java
boolean sendMessage(String text)
```
-```
+```text
Parameters:
text - Text of message to be sent to the thermostat.
### Set Hold
-The set hold function sets the thermostat into a hold with the specified temperature.
-Creates a hold for the specified duration.
+The set hold function sets the thermostat into a hold with the specified temperature.
+Creates a hold for the specified duration.
Note that an event is created regardless of whether the program is in the same state as the requested state.
-There is also support for creating a hold by passing a holdClimateRef request parameter/value pair to this function.
-When an existing and valid Climate.climateRef value is passed to this function, the coolHoldTemp,
-heatHoldTemp and fan mode from that Climate are used in the creation of the hold event.
-The values from that Climate will take precedence over any coolHoldTemp, heatHoldTemp and fan mode
+There is also support for creating a hold by passing a holdClimateRef request parameter/value pair to this function.
+When an existing and valid Climate.climateRef value is passed to this function, the coolHoldTemp,
+heatHoldTemp and fan mode from that Climate are used in the creation of the hold event.
+The values from that Climate will take precedence over any coolHoldTemp, heatHoldTemp and fan mode
parameters passed into this function separately.
To resume from a hold and return to the program, use the `resumeProgram` function.
-##### setHold - Set an indefinite hold using the supplied coolHoldTemp and heatHoldTemp
+#### setHold - Set an indefinite hold using the supplied coolHoldTemp and heatHoldTemp
```java
boolean setHold(QuantityType<Temperature> coolHoldTemp, QuantityType<Temperature> heatHoldTemp)
```
-```
+```text
Parameters:
coolHoldTemp - The temperature to set the cool hold at.
heatHoldTemp - The temperature to set the heat hold at.
boolean setHold(QuantityType<Temperature> coolHoldTemp, QuantityType<Temperature> heatHoldTemp, Number holdHours)
```
-```
+```text
Parameters:
coolHoldTemp - The temperature to set the cool hold at.
heatHoldTemp - The temperature to set the heat hold at.
boolean setHold(String climateRef)
```
-```
+```text
Parameters:
climateRef - Climate to be applied to thermostat (e.g. home, away).
boolean setHold(String climateRef, Number holdHours)
```
-```
+```text
Parameters:
climateRef - Climate to be applied to thermostat (e.g. home, away).
holdHours - Duration of hold.
Returns - true if the operation was successful, false otherwise
```
-##### setHold
+##### setHold - Quantity Type
```java
boolean setHold(QuantityType<Temperature> coolHoldTemp, QuantityType<Temperature> heatHoldTemp, String holdClimateRef, Date startDateTime, Date endDateTime, String holdType, Number holdHours)
```
-```
+```text
Parameters:
coolHoldTemp - The temperature to set the cool hold at.
heatHoldTemp - The temperature to set the heat hold at.
Returns - true if the operation was successful, false otherwise
```
-##### setHold
+##### setHold - Map
```java
boolean setHold(Map<String,Object> params, String holdType, Number holdHours, Date startDateTime, Date endDateTime)
### Set Occupied
-The set occupied function may only be used by EMS thermostats.
-The function switches a thermostat from occupied mode to unoccupied, or vice versa.
-If used on a Smart thermostat, the function will throw an error.
-Switch occupancy events are treated as Holds.
+The set occupied function may only be used by EMS thermostats.
+The function switches a thermostat from occupied mode to unoccupied, or vice versa.
+If used on a Smart thermostat, the function will throw an error.
+Switch occupancy events are treated as Holds.
There may only be one Switch Occupancy at one time, and the new event will replace any previous event.
-Note that an occupancy event is created regardless what the program on the thermostat is set to.
-For example, if the program is currently unoccupied and you set occupied=false, an occupancy event
-will be created using the heat/cool settings of the unoccupied program climate.
+Note that an occupancy event is created regardless what the program on the thermostat is set to.
+For example, if the program is currently unoccupied and you set occupied=false, an occupancy event
+will be created using the heat/cool settings of the unoccupied program climate.
If your intent is to go back to the program and remove the occupancy event, use resumeProgram instead.
-##### setOccupied -
+#### setOccupied -
```java
boolean setOccupied(Boolean occupied, Date startDateTime, Date endDateTime, String holdType, Number holdHours)
```
-```
+```text
Parameters:
occupied - The climate to use for the temperature, occupied (true) or unoccupied (false).
holdType - The hold duration type. Valid values: dateTime, nextTransition, indefinite, holdHours.
The update sensor function allows the caller to update the name of an ecobee3 remote sensor.
-Each ecobee3 remote sensor "enclosure" contains two distinct sensors types temperature and occupancy.
-Only one of the sensors is required in the request.
-Both of the sensors' names will be updated to ensure consistency as they are part of the
-same remote sensor enclosure.
+Each ecobee3 remote sensor "enclosure" contains two distinct sensors types temperature and occupancy.
+Only one of the sensors is required in the request.
+Both of the sensors' names will be updated to ensure consistency as they are part of the
+same remote sensor enclosure.
This also reflects accurately what happens on the Thermostat itself.
-##### updateSensor - Update the name of a sensor
+#### updateSensor - Update the name of a sensor
```java
boolean updateSensor(String name, String deviceId, String sensorId)
```
-```
+```text
Parameters:
name - The updated name to give the sensor. Has a max length of 32, but shorter is recommended.
deviceId - The deviceId for the sensor, typically this indicates the enclosure and corresponds to the ThermostatRemoteSensor.id field. For example: rs:100
### Get Alerts
-##### getAlerts - Get the list of alerts
+#### getAlerts - Get the list of alerts
```java
String getAlerts()
```
-```
+```text
Returns - A JSON string representing the array of alerts for the thermostat, or null if there are no alerts.
```
### Get Events
-##### getEvents - Get the list of events
+#### getEvents - Get the list of events
```java
String getEvents()
```
-```
+```text
Returns - A JSON string representing the array of events for the thermostat, or null if there are no events.
```
### Get Climates
-##### getClimates - Get the list of climates configured on this thermostat
+#### getClimates - Get the list of climates configured on this thermostat
```java
String getClimates()
```
-```
+```text
Returns - A JSON string representing the array of climates for the thermostat.
```
### Things
-```
+```java
Bridge ecobee:account:account "Ecobee Account" [ apiKey="kjafhd4YTiucye48yn498n94c8ufn49", refreshIntervalNormal=30, refreshIntervalQuick=5, apiTimeout=20, discoveryEnabled=false ] {
Bridge thermostat 32122305166 "Ecobee First Floor Thermostat" [ thermostatId="32122305166" ] {
Thing sensor ei-0 "Ecobee Sensor Thermostat" [ sensorId="ei:0" ] {
### Items
-```
+```java
Group gInfo "Information"
Group gRuntime "Runtime"
Group gEquipmentStatus "Equipment Status"
### Sitemap
-```
+```perl
Frame label="Ecobee Thermostat" {
Group item=gInfo
Group item=gEquipmentStatus
### Rules
-Some of the example rules below depend on the following *proxy* items.
+Some of the example rules below depend on the following _proxy_ items.
-```
+```java
Switch SetTemperatureHold "Set Temperature Hold [%s]"
Number:Temperature UserCool "User Selected Heat [%.1f %unit%]"
Number:Temperature UserHeat "User Selected Cool [%.1f %unit%]"
Switch GetClimates "Get All Climates [%s]"
```
-```
+```java
rule "Set Temperature Hold"
when
Item SetTemperatureHold received command
### ecotouch.things
-```
+```java
Thing ecotouch:geo:heatpump "Waterkotte Heatpump" @ "basement" [ ip="192.168.1.100", username="admin", password="wtkadmin", refresh=120 ]
```
### ecotouch.items
-```
+```java
Number:Temperature HeatPump_Temp_Aussen { channel="ecotouch:geo:heatpump:temperature_outside" }
Number:Temperature HeatPump_Temp_Aussen_1d { channel="ecotouch:geo:heatpump:temperature_outside_24h" }
Number:Temperature HeatPump_Temp_Quelle_in { channel="ecotouch:geo:heatpump:temperature_source_in" }
### ecotouch.sitemap
-```
+```perl
sitemap ecotouch label="Waterkotte EcoTouch"
{
Text item=HeatPump_Temp_Aussen
A snippet to show the current state of the heatpump (you need to have the corresponding items in your .items-file):
-```
+```java
Text label="State" icon="settings" {
Text item=HeatPump_state_sourcepump label="State Source Pump [%s]" valuecolor=[==ON="green", ==OFF="red"]
Text item=HeatPump_state_heatingpump label="State Heating Pump [%s]" valuecolor=[==ON="green", ==OFF="red"]
You must create an account and an application on the RTE portal to obtain the OAuth2 credentials required to access the API.
1. Open this [page](https://data.rte-france.com/catalog/-/api/consumption/Ecowatt/v4.0), find the "Ecowatt" tile and click on the "Abonnez-vous à l'API" button.
-2. Create an account by following the instructions (you will receive an email to validate your new account).
-3. Once logged in, create an application by entering a name (for example "openHAB Integration"), choosing "Web Server" as type, entering any description of your choice and finally clicking on the "Valider" button.
-4. You will then see your application details, in particular the "ID client" and "ID Secret" information which you will need later to set up your binding thing.
+1. Create an account by following the instructions (you will receive an email to validate your new account).
+1. Once logged in, create an application by entering a name (for example "openHAB Integration"), choosing "Web Server" as type, entering any description of your choice and finally clicking on the "Valider" button.
+1. You will then see your application details, in particular the "ID client" and "ID Secret" information which you will need later to set up your binding thing.
## Binding Configuration
example.things:
-```
+```java
Thing ecowatt:signals:signals "Ecowatt Signals" [ idClient="xxxxx", idSecret="yyyyy"]
```
example.items:
-```
+```java
Number TodaySignal "Today [%s]" { channel="ecowatt:signals:signals:todaySignal" }
Number TomorrowSignal "Tomorrow [%s]" { channel="ecowatt:signals:signals:tomorrowSignal" }
Number CurrentHourSignal "Current hour [%s]" { channel="ecowatt:signals:signals:currentHourSignal" }
example.sitemap:
-```
+```perl
Frame label="Ecowatt" {
Default item=TodaySignal
Default item=TomorrowSignal
\r
example.things\r
\r
-```\r
+```java\r
Thing ekey:cvlan:de3b8db06e "Ekey Udp Converter" @ "Control Panel" [ ipAddress="xxx.xxx.xxx.xxx", port="56000", protocol="RARE", delimiter="_" ]\r
```\r
\r
rare.items\r
\r
-```\r
+```java\r
Number Action "Last action [MAP(ekey_action.map):%d]" { channel="ekey:cvlan:de3b8db06e:action" }\r
Number FingerID "User used finger [MAP(ekey_finger.map):%d]" { channel="ekey:cvlan:de3b8db06e:fingerId" }\r
Number RelayID "Last relay that has been swiched [%d]" { channel="ekey:cvlan:de3b8db06e:relayId" }\r
\r
multi.items\r
\r
-```\r
+```java\r
Number Action "Last action [MAP(ekey_action.map):%d]" { channel="ekey:cvlan:de3b8db06e:action" }\r
Number FingerID "User used finger [MAP(ekey_finger.map):%d]" { channel="ekey:cvlan:de3b8db06e:fingerId" }\r
String FsName "Name of Scanner [%s] { channel="ekey:cvlan:de3b8db06e:fsName" }\r
\r
home.items\r
\r
-```\r
+```java\r
Number Action "Last action [MAP(ekey_action.map):%d]" { channel="ekey:cvlan:de3b8db06e:action" }\r
Number FingerID "User used finger [MAP(ekey_finger.map):%d]" { channel="ekey:cvlan:de3b8db06e:fingerId" }\r
Number RelayID "Last relay that has been swiched [%d]" { channel="ekey:cvlan:de3b8db06e:relayId" }\r
\r
transform/ekey_finger.map [This is just an example, as there is no strict rule what finger belongs to what number]\r
\r
-```javascript\r
+```text\r
0=leftlittle\r
1=leftring\r
2=leftmiddle\r
\r
transform/ekey_names.map [NO spaces allowed]\r
\r
-```javascript\r
+```text\r
-1=Unspecified\r
1=JohnDoe\r
2=JaneDoe\r
\r
transform/ekey_terminal.map\r
\r
-```javascript\r
+```text\r
80156839130911=Front\r
80156839130914=Back\r
```\r
\r
transform/ekey_multi_action.map\r
\r
-```javascript\r
+```text\r
0=granted\r
-1=rejected\r
1=timeoutA\r
\r
transform/ekey_rare_action.map\r
\r
-```javascript\r
+```text\r
136=granted\r
137=rejected\r
```\r
-\r
-\r
-\r
- api: Bridge - Implements the API that is used to communicate with the Air Purifier
-
- electroluxpurea9: The Pure A9 Air Purifier
## Discovery
After the configuration of the Bridge, your Electrolux Pure A9 device will be automatically discovered and placed as a thing in the inbox.
-
### Configuration Options
Only the bridge require manual configuration. The Electrolux Pure A9 thing can be added by hand, or you can let the discovery mechanism automatically find it.
-
#### Bridge
-| Parameter | Description | Type | Default | Required |
+| Parameter | Description | Type | Default | Required |
|-----------|--------------------------------------------------------------|--------|----------|----------|
| username | The username used to connect to the Electrolux Wellbeing app | String | NA | yes |
| password | The password used to connect to the Electrolux Wellbeing app | String | NA | yes |
#### Electrolux Pure A9
-| Parameter | Description | Type | Default | Required |
+| Parameter | Description | Type | Default | Required |
|-----------|-------------------------------------------------------------------------|--------|----------|----------|
| deviceId | Product ID of your Electrolux Pure A9 found in Electrolux Wellbeing app | Number | NA | yes |
-
## Channels
### Electrolux Pure A9
The following channels are supported:
-| Channel Type ID | Item Type | Description |
+| Channel Type ID | Item Type | Description |
|-----------------------------|-----------------------|------------------------------------------------------------------------------|
| temperature | Number:Temperature | This channel reports the current temperature. |
| humidity | Number:Dimensionless | This channel reports the current humidity in percentage. |
| doorOpen | Contact | This channel reports the status of door (Opened/Closed). |
| workMode | String | This channel sets and reports the current work mode (Auto, Manual, PowerOff.)|
-
## Full Example
### Things-file
-````
+```java
// Bridge configuration
Bridge electroluxair:api:myAPI "Electrolux Delta API" [username="user@password.com", password="12345", refresh="300"] {
Thing electroluxpurea9 myElectroluxPureA9 "Electrolux Pure A9" [ deviceId="123456789" ]
}
-````
+```
## Items-file
-````
+```java
// CO2
Number ElectroluxAirCO2 "Electrolux Air CO2 [%d ppm]" {channel="electroluxair:electroluxpurea9:myAPI:MyElectroluxPureA9:co2"}
// Temperature
String ElectroluxAirWorkModeSetting "ElectroluxAir Work Mode Setting" {channel="electroluxair:electroluxpurea9:myAPI:myElectroluxPureA9:workMode"}
// Fan speed
Number ElectroluxAirFanSpeed "Electrolux Air Fan Speed Setting" {channel="electroluxair:electroluxpurea9:myAPI:myElectroluxPureA9:fanSpeed"}
-````
-
+```
# Elero Transmitter Stick Binding
-Allows to control Elero rollershutters through a connected Elero Transmitter Stick.
+Allows to control Elero rollershutters through a connected Elero Transmitter Stick.
## Supported Things
A typical thing configuration looks like this:
-```
+```java
Bridge elerotransmitterstick:elerostick:0a0a0a0a [ portName="/dev/ttyElero2", updateInterval=5000 ]
Thing elerotransmitterstick:elerochannel:0a0a0a0a:1 (elerotransmitterstick:elerostick:0a0a0a0a) [ channelId=1 ]
```
A typical item configuration for a rollershutter looks like this:
-```
+```java
Rollershutter Rollershutter1 {channel="elerotransmitterstick:elerochannel:0a0a0a0a:1:control",autoupdate="false" }
String Rollershutter1State {channel="elerotransmitterstick:elerochannel:0a0a0a0a:1:status" }
```
A sitemap entry looks like this:
-```
+```perl
Selection item=Rollershutter1 label="Kitchen" mappings=[0="open", 100="closed", 25="shading"]
```
The ELRO Connects supported device types are:
-* Elro Connects account: `account`
-* K1 connector hub: `connector`
-* Smoke detector: `smokealarm`
-* Carbon monoxide detector: `coalarm`
-* Heat detector: `heatalarm`
-* Water detector: `wateralarm`
-* Windows/door contact: `entrysensor`
-* Motion detector: `motionsensor`
-* Temperature and humidity monitor: `temperaturesensor`
-* Plug-in switch: `powersocket`
+- Elro Connects account: `account`
+- K1 connector hub: `connector`
+- Smoke detector: `smokealarm`
+- Carbon monoxide detector: `coalarm`
+- Heat detector: `heatalarm`
+- Water detector: `wateralarm`
+- Windows/door contact: `entrysensor`
+- Motion detector: `motionsensor`
+- Temperature and humidity monitor: `temperaturesensor`
+- Plug-in switch: `powersocket`
`account` is a bridge thing type that will allow automatic discovery and configuration of the available K1 connectors on the specified ELRO Connects account.
This bridge is optional.
Notice that K1 connectors in another network than the LAN will also get discovered, but will not go online when accepted from the inbox without adjusting the `connector` configuration (set the IP address).
The K1 connector `connector` will be auto-discovered when an ELRO Connects `account` bridge has been created and initialized.
-It can also be configured manually without first setting up an `account` bridge and linking it to that `account` bridge.
+It can also be configured manually without first setting up an `account` bridge and linking it to that `account` bridge.
Once the bridge thing representing the K1 connector is correctly set up and online, discovery will allow discovering all devices connected to the K1 connector (as set up in the Elro Connects app).
If devices are outside reliable RF range, devices known to the K1 hub will be discovered but may stay offline when added as a thing.
.things:
-```
+```java
Bridge elroconnects:connector:myhub [ connectorId="ST_aabbccddaabbccdd", refreshInterval=120 ] {
smokealarm 1 "LivingRoom" [ deviceId="1" ]
coalarm 2 "Garage" [ deviceId="2" ]
.items:
-```
+```java
String Scene {channel="elroconnects:connector:myhub:scene"}
Number BatteryLevel {channel="elroconnects:smokealarm:myhub:1:battery"}
Switch AlarmTest {channel="elroconnects:smokealarm:myhub:1:test"}
.sitemap:
-```
+```perl
Text item=Scene
Number item=BatteryLevel
Switch item=AlarmTest
Example trigger rule:
-```
+```java
rule "example trigger rule"
when
Channel 'elroconnects:smokealarm:myhub:1:smokeAlarm' triggered
# Gembird energenie Binding\r
\r
-This binding integrates the Gembird energenie range of power extenders by using the Energenie Data Exchange Protocol and power reading devices through HTTP interface. \r
-\r
+This binding integrates the Gembird energenie range of power extenders by using the Energenie Data Exchange Protocol and power reading devices through HTTP interface.\r
\r
## Supported Things\r
\r
\r
## Thing Configuration\r
\r
-The device requires the IP-address and a password as a configuration value in order for the binding to know where to access it and to login to the device. \r
+The device requires the IP-address and a password as a configuration value in order for the binding to know where to access it and to login to the device.\r
\r
| Parameter | Description |\r
|-----------|------------------------------------------------------|\r
\r
Things\r
\r
-```\r
+```java\r
Thing energenie:pm2lan:pm2lan [ host="xxx.xxx.xxx.xxx", password="your password" ]\r
Thing energenie:pmslan:pmslan [ host="xxx.xxx.xxx.xxx", password="your password" ]\r
Thing energenie:pms2lan:pms2lan [ host="xxx.xxx.xxx.xxx", password="your password" ]\r
\r
Items\r
\r
-```\r
+```java\r
//Power extenders\r
Switch Socket1 { channel="energenie:pm2lan:pm2lan:socket1" }\r
Switch Socket2 { channel="energenie:pm2lan:pm2lan:socket2" }\r
\r
Sitemap\r
\r
-```\r
+```perl\r
sitemap energenie label="Energenie Devices"\r
{\r
Frame {\r
| Name | Description | Mandatory |
|-----------------|----------------------------------------------------|-----------|
-| host | Hostname or IP address of the Enigma2 device | yes |
+| host | Hostname or IP address of the Enigma2 device | yes |
| refreshInterval | The refresh interval in seconds | yes |
| timeout | The timeout for reading from the device in seconds | yes |
| user | Optional: The Username of the Enigma2 Web API | no |
Set the parameters as in the following example:
-```
+```java
Thing enigma2:device:192_168_0_3 [host="192.168.1.3", refreshInterval="5", timeout="5", user="usename" , password="***"]
```
demo.things:
-```
+```java
Thing enigma2:device:192_168_0_3 [host="192.168.1.3", refreshInterval="5"]
```
demo.items:
-```
+```java
Switch Enigma2_Power "Power: [%s]" <switch> { channel="enigma2:device:192_168_0_3:power" }
Dimmer Enigma2_Volume "Volume: [%d %%]" <soundvolume> { channel="enigma2:device:192_168_0_3:volume" }
Switch Enigma2_Mute "Mute: [%s]" <soundvolume_mute> { channel="enigma2:device:192_168_0_3:mute" }
demo.sitemap:
-```
+```perl
sitemap demo label="Enigma2 Demo"
{
Frame label="Enigma2" {
}
```
-
demo.rules:
-```
+```java
rule "Enigma2_KeyS"
when Item Enigma2_RemoteKeys received command
then
Example
-```
+```java
val actions = getActions("enigma2","enigma2:device:192_168_0_3")
if(null === actions) {
logInfo("actions", "Actions not found, check thing ID")
Example:
-```
+```java
actions.sendInfo("Hello World")
```
Example:
-```
+```java
actions.sendInfo("Hello World", 10)
```
Example:
-```
+```java
actions.sendWarning("Hello World")
```
Example:
-```
+```java
actions.sendWarning("Hello World", 10)
```
Example:
-```
+```java
actions.sendError("Hello World")
```
Example:
-```
+```java
actions.sendError("Hello World", 10)
```
Example:
-```
+```java
actions.sendQuestion("Say hello?")
```
Example:
-```
+```java
actions.sendQuestion("Say hello?", 10)
```
|---------|------------------------------------------------------------------------|
| button | see the supported buttons in chapter 'Remote Control Buttons' |
-
The button parameter has only been tested on a Vu+Solo2 and this is a list of button codes that are known to work with this device.
| Code String |
Example:
-```
+```java
actions.sendRcCommand("KEY_1")
```
-
This binding is developed on and tested with the following devices
- * USB300 and EnOceanPi gateways
- * The following Eltako actuators:
- * FSR14 (light switch)
- * FSB14 (rollershutter)
- * FUD14 (dimmer)
- * FSSA-230V (smart plug)
- * FWZ12-65A (energy meter)
- * FTKE (window / door contact)
- * FPE-1 & FPE-2 (window / door contact)
- * TF-FGB (window handle)
- * TF-FKB (window contact)
- * TF-AHDSB (outdoor brightness sensor)
- * FAFT60 (outdoor temperature & humidity sensor)
- * The following Opus actuators:
- * GN-A-R12V-SR-4 (light)
- * GN-A-R12V-MF-2 (light)
- * GN-A-R12V-LZ/UD (dimmer)
- * GN-A-R12V-JRG-2 (rollershutter)
- * GN-A-U230V-JRG (rollershutter)
- * OPUS-FUNK PLUS Jalousieaktor 1fach UP (rollershutter)
- * OPUS-Funk PLUS Steckdosenleiste (smart multiple socket)
- * NodOn:
- * Smart Plug (ASP-2-1-10)
- * In Wall Switch (SIN-2-2-00, SIN-2-1-0x)
- * In Wall Rollershutter (SIN-2-RS-01)
- * Temperature & humidity sensor (STPH-2-1-05)
- * Permundo
- * PSC234 (smart plug with metering) = Afriso APR234
- * PSC132 (smart switch actor with metering)
- * PSC152 (smart blinds control)
- * Thermokon SR04 room control
- * Hoppe SecuSignal window handles
- * Rocker switches (NodOn, Eltako FT55 etc)
- * Siegenia Senso Secure window sensors
- * Soda window handles
+- USB300 and EnOceanPi gateways
+- The following Eltako actuators:
+ - FSR14 (light switch)
+ - FSB14 (rollershutter)
+ - FUD14 (dimmer)
+ - FSSA-230V (smart plug)
+ - FWZ12-65A (energy meter)
+ - FTKE (window / door contact)
+ - FPE-1 & FPE-2 (window / door contact)
+ - TF-FGB (window handle)
+ - TF-FKB (window contact)
+ - TF-AHDSB (outdoor brightness sensor)
+ - FAFT60 (outdoor temperature & humidity sensor)
+- The following Opus actuators:
+ - GN-A-R12V-SR-4 (light)
+ - GN-A-R12V-MF-2 (light)
+ - GN-A-R12V-LZ/UD (dimmer)
+ - GN-A-R12V-JRG-2 (rollershutter)
+ - GN-A-U230V-JRG (rollershutter)
+ - OPUS-FUNK PLUS Jalousieaktor 1fach UP (rollershutter)
+ - OPUS-Funk PLUS Steckdosenleiste (smart multiple socket)
+- NodOn:
+ - Smart Plug (ASP-2-1-10)
+ - In Wall Switch (SIN-2-2-00, SIN-2-1-0x)
+ - In Wall Rollershutter (SIN-2-RS-01)
+ - Temperature & humidity sensor (STPH-2-1-05)
+- Permundo
+ - PSC234 (smart plug with metering) = Afriso APR234
+ - PSC132 (smart switch actor with metering)
+ - PSC152 (smart blinds control)
+- Thermokon SR04 room control
+- Hoppe SecuSignal window handles
+- Rocker switches (NodOn, Eltako FT55 etc)
+- Siegenia Senso Secure window sensors
+- Soda window handles
However, because of the standardized EnOcean protocol it is more important which EEP this binding supports.
Hence if your device supports one of the following EEPs the chances are good that your device is also supported by this binding.
Then press the "teach-in" button of the sensor.
The sensor sends a teach-in message which contains the information about the EEP and the EnOceanId of the sensor.
If the EEP is known by this binding the thing representation of the device is created.
-The corresponding channels are created dynamically, too.
+The corresponding channels are created dynamically, too.
### Actuators
-
+
If the actuator supports UTE teach-in, the corresponding thing can be created and paired automatically.
First you have to **start the discovery scan for a gateway**.
Then press the teach-in button of the actuator.
## Channels
-The channels of a thing are determined automatically based on the chosen EEP.
+The channels of a thing are determined automatically based on the chosen EEP.
|Channel | Item | Description |
|---------------------|--------------------|---------------------------------|
| rssi | Number | Received Signal Strength Indication (dBm) of last received message |
| repeatCount | Number | Number of repeaters involved in the transmission of the telegram |
| lastReceived | DateTime | Date and time the last telegram was received |
-| statusRequestEvent | Trigger | Emits event 'requestAnswer' |
+| statusRequestEvent | Trigger | Emits event 'requestAnswer' |
| windowBreachEvent | Trigger | Emits event 'ALARM' |
| protectionPlusEvent | Trigger | Emits event 'ALARM' |
| vacationModeToggleEvent | Trigger | Emits events 'ACTIVATED', 'DEACTIVATED' |
-
Items linked to bi-directional actuators (actuator sends status messages back) should always disable the `autoupdate`.
This is especially true for Eltako rollershutter, as their position is calculated out of the current position and the moving time.
## Rules and Profiles
The rockerSwitch things use _system:rawrocker_ channel types.
-So they trigger _DIR1[/2]_\__PRESSED_ and DIR1[/2]_\__RELEASED_ events.
+So they trigger _DIR1[/2]\___PRESSED_ and _DIR1[/2]\___RELEASED_ events.
These channels can be directly linked to simple items like Switch, Dimmer or Player with the help of _profiles_.
If you want to do more advanced stuff, you have to implement rules which react to these events
| | suppressRepeating | | true, false |
Supported channels: genericSwitch, genericRollershutter, genericDimmer, genericNumber, genericString, genericColor, genericTeachInCMD.
-You have to define the transformationType (e.g. MAP) and transformationFunction (e.g. for MAP: file name of mapping file) for each of these channels.
+You have to define the transformationType (e.g. MAP) and transformationFunction (e.g. for MAP: file name of mapping file) for each of these channels.
For an inbound transformation (EnOcean message => openHAB state) you receive the channel id and the EnOcean data in hex separated by a pipe.
Your transformation function has to return the openHAB State type and value separated by a pipe.
If you want to use a mapping transformation, your mapping file has to look like this for a genericThing using EEP F6_FF_FF:
-```
+```text
ChannelId|EnoceanData(Hex)=openHABState|Value
genericSwitch|70=OnOffType|ON
genericSwitch|50=OnOffType|OFF
You do not have to worry about CRC and header data.
If you want to use a mapping transformation, your mapping file has to look like this for a genericThing using EEP A5_FF_FF:
-```
+```text
ChannelId|openHABCommand=EnoceanData(Hex)
genericSwitch|ON=01000009
genericSwitch|OFF=01000008
The follow things are supported:
-* `envoy` The Envoy gateway thing, which is a bridge thing.
-* `inverter` An Enphase micro inverter connected to a solar panel.
-* `relay` An Enphase relay.
+- `envoy` The Envoy gateway thing, which is a bridge thing.
+- `inverter` An Enphase micro inverter connected to a solar panel.
+- `relay` An Enphase relay.
Not all Envoy gateways support all channels and things.
Therefore some data on inverters and the relay may not be available.
Things example:
-```
+```java
Bridge enphase:envoy:789012 "Envoy" [ serialNumber="12345789012" ] {
Things:
inverter 123456 "Enphase Inverter 123456" [ serialNumber="789012123456" ]
Items example:
-```
+```java
Number:Power envoyWattsNow "Watts Now [%d %unit%]" { channel="enphase:envoy:789012:production#wattsNow" }
Number:Energy envoyWattHoursToday "Watt Hours Today [%d %unit%]" { channel="enphase:envoy:789012:production#wattHoursToday" }
Number:Energy envoyWattHours7Days "Watt Hours 7 Days [%.1f kWh]" { channel="enphase:envoy:789012:production#wattHoursSevenDays" }
Entur provides an [IDE for the API](https://api.entur.org/doc/shamash-journeyplanner/) (use query from GraphQL request example below as a start point) Ctrl+Space gives hints of valid values
-There are several possibilities to get and process data from endpoints that entur.no provides. One of possible examples is to get all departures for all lines from specified stop place (all directions) or even specified quay (specified direction). Those are not supported yet so feel free to extend functionality of this binding.
+There are several possibilities to get and process data from endpoints that entur.no provides. One of possible examples is to get all departures for all lines from specified stop place (all directions) or even specified quay (specified direction). Those are not supported yet so feel free to extend functionality of this binding.
## GraphQL request example
-```
+```json
{
stopPlace(id: "NSR:StopPlace:30848") {
id
# EnturNo Binding
This binding gets Norwegian public transport real-time (estimated) data from the [Entur.org API](https://developer.entur.org/pages-intro-overview).
-
+
## Supported Things
As for now, binding supports only one thing `linestop`.
### Entur Timetable
-Entur timetable provides information about departures for chosen line/service of public transport in Norway and chosen stop place.
-It contains informationabout stop place (id, name, transport mode) and real-time departures from that place.
-**It is worth noting that binding is thought to be primarily used for busdepartures (can work for other supported by [entur.org](https://developer.entur.org/pages-intro-overview) transport types).
-Two Direction channel groups are consequence of that assumption.
-That will say that usually for stop place of a given name there are two bus stops for same line going in opposite directions.**
-Each **Direction** channel group contains information about direction,line code, 5 coming departures, and whether given departure time is real-time (estimated) or not.
+Entur timetable provides information about departures for chosen line/service of public transport in Norway and chosen stop place.
+It contains informationabout stop place (id, name, transport mode) and real-time departures from that place.
+**It is worth noting that binding is thought to be primarily used for busdepartures (can work for other supported by [entur.org](https://developer.entur.org/pages-intro-overview) transport types).
+Two Direction channel groups are consequence of that assumption.
+That will say that usually for stop place of a given name there are two bus stops for same line going in opposite directions.**
+Each **Direction** channel group contains information about direction,line code, 5 coming departures, and whether given departure time is real-time (estimated) or not.
## Discovery
Some notes:
-* The binding should work on all Epson projectors that support the ESC/VP21 protocol, however not all binding channels will be useable on all projectors.
-* The _source_ channel includes a dropdown with the most common source inputs.
-* If your projector has a source input that is not in the dropdown, the two character hex code to access that input will be displayed by the _source_ channel when that input is selected by the remote control.
-* By using the sitemap mapping or a rule to send the input's code back to the _source_ channel, any source on the projector can be accessed by the binding.
-* The following channels _aspectratio_, _colormode_, _luminance_, _gamma_ and _background_ are pre-populated with a full set of options but not every option will be useable on all projectors.
-* If your projector has an option in one of the above mentioned channels that is not recognized by the binding, the channel will display 'UNKNOWN' if that un-recognized option is selected by the remote control.
-* The volume channel is a dimmer (0-100%) that is scaled to the range on the projector, either 0-20 or 0-40 per the maxVolume configuration setting. If your projector uses a different range, then the volume channel will not work.
-* If the projector power is switched to off in the middle of a polling operation, some of the channel values may become undefined until the projector is switched on again.
-* If the binding fails to connect to the projector using the direct IP connection, ensure that no password is configured on the projctor.
-
-* On Linux, you may get an error stating the serial port cannot be opened when the epsonprojector binding tries to load.
-* You can get around this by adding the `openhab` user to the `dialout` group like this: `usermod -a -G dialout openhab`.
-* Also on Linux you may have issues with the USB if using two serial USB devices e.g. epsonprojector and RFXcom. See the [general documentation about serial port configuration](/docs/administration/serial.html) for more on symlinking the USB ports.
-* Here is an example of ser2net.conf (for ser2net version < 4) you can use to share your serial port /dev/ttyUSB0 on IP port 4444 using [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) (take care, the baud rate is specific to the Epson projector):
-
-```
+- The binding should work on all Epson projectors that support the ESC/VP21 protocol, however not all binding channels will be useable on all projectors.
+- The _source_ channel includes a dropdown with the most common source inputs.
+- If your projector has a source input that is not in the dropdown, the two character hex code to access that input will be displayed by the _source_ channel when that input is selected by the remote control.
+- By using the sitemap mapping or a rule to send the input's code back to the _source_ channel, any source on the projector can be accessed by the binding.
+- The following channels _aspectratio_, _colormode_, _luminance_, _gamma_ and _background_ are pre-populated with a full set of options but not every option will be useable on all projectors.
+- If your projector has an option in one of the above mentioned channels that is not recognized by the binding, the channel will display 'UNKNOWN' if that un-recognized option is selected by the remote control.
+- The volume channel is a dimmer (0-100%) that is scaled to the range on the projector, either 0-20 or 0-40 per the maxVolume configuration setting. If your projector uses a different range, then the volume channel will not work.
+- If the projector power is switched to off in the middle of a polling operation, some of the channel values may become undefined until the projector is switched on again.
+- If the binding fails to connect to the projector using the direct IP connection, ensure that no password is configured on the projctor.
+
+- On Linux, you may get an error stating the serial port cannot be opened when the epsonprojector binding tries to load.
+- You can get around this by adding the `openhab` user to the `dialout` group like this: `usermod -a -G dialout openhab`.
+- Also on Linux you may have issues with the USB if using two serial USB devices e.g. epsonprojector and RFXcom. See the [general documentation about serial port configuration](/docs/administration/serial.html) for more on symlinking the USB ports.
+- Here is an example of ser2net.conf (for ser2net version < 4) you can use to share your serial port /dev/ttyUSB0 on IP port 4444 using [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) (take care, the baud rate is specific to the Epson projector):
+
+```text
4444:raw:0:/dev/ttyUSB0:9600 8DATABITS NONE 1STOPBIT LOCAL
```
-* Here is an example of ser2net.yaml (for ser2net version >= 4) you can use to share your serial port /dev/ttyUSB0 on IP port 4444 using [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) (take care, the baud rate is specific to the Epson projector):
+- Here is an example of ser2net.yaml (for ser2net version >= 4) you can use to share your serial port /dev/ttyUSB0 on IP port 4444 using [ser2net Linux tool](https://sourceforge.net/projects/ser2net/) (take care, the baud rate is specific to the Epson projector):
-```
+```yaml
connection: &conEpson
accepter: tcp,4444
enable: on
## Channels
-| Channel | Item Type | Purpose | Values |
-| ------------------ | --------- | ------------------------------------------------------------------------------------------ | --------- |
-| power | Switch | Powers the projector on or off. | |
-| powerstate | String | Retrieves the textual power state of the projector. | Read only |
-| source | String | Retrieve or set the input source. | See above |
-| aspectratio | String | Retrieve or set the aspect ratio. | See above |
-| colormode | String | Retrieve or set the color mode. | See above |
-| freeze | Switch | Turn the freeze screen mode on or off. | |
-| mute | Switch | Turn the AV mute on or off. | |
-| volume | Dimmer | Retrieve or set the volume. Scaled to 0-20 or 0-40 on the projector per maxVolume setting. | 0% - 100% |
-| luminance | String | Retrieve or set the lamp mode. | See above |
-| brightness | Number | Retrieve or set the brightness. | -24 - +24 |
-| contrast | Number | Retrieve or set the contrast. | -24 - +24 |
-| density | Number | Retrieve or set the density (color saturation). | -32 - +32 |
-| tint | Number | Retrieve or set the tint. | -32 - +32 |
-| colortemperature | Number | Retrieve or set the color temperature. | 0 - +9 |
-| fleshtemperature | Number | Retrieve or set the flesh temperature. | 0 - +6 |
-| gamma | String | Retrieve or set the gamma setting. | See above |
-| autokeystone | Switch | Turn the auto keystone mode on or off. | |
-| verticalkeystone | Number | Retrieve or set the vertical keystone. | -30 - +30 |
-| horizontalkeystone | Number | Retrieve or set the horizontal keystone. | -30 - +30 |
-| verticalposition | Number | Retrieve or set the vertical position. | -8 - +10 |
-| horizontalposition | Number | Retrieve or set the horizontal position. | -23 - +26 |
-| verticalreverse | Switch | Turn the vertical reverse mode on or off. | |
-| horizontalreverse | Switch | Turn the horizontal reverse mode on or off. | |
-| background | String | Retrieve or set the background color/logo. | See above |
-| keycode | String | Send a key operation command to the projector. (2 character code) | Send only |
-| lamptime | Number | Retrieves the lamp hours. | Read only |
-| errcode | Number | Retrieves the last error code. | Read only |
-| errmessage | String | Retrieves the description of the last error. | Read only |
+| Channel | Item Type | Purpose | Values |
+| ------------------ | --------- | ------------------------------------------------------------------------------------------ | --------- |
+| power | Switch | Powers the projector on or off. | |
+| powerstate | String | Retrieves the textual power state of the projector. | Read only |
+| source | String | Retrieve or set the input source. | See above |
+| aspectratio | String | Retrieve or set the aspect ratio. | See above |
+| colormode | String | Retrieve or set the color mode. | See above |
+| freeze | Switch | Turn the freeze screen mode on or off. | |
+| mute | Switch | Turn the AV mute on or off. | |
+| volume | Dimmer | Retrieve or set the volume. Scaled to 0-20 or 0-40 on the projector per maxVolume setting. | 0% - 100% |
+| luminance | String | Retrieve or set the lamp mode. | See above |
+| brightness | Number | Retrieve or set the brightness. | -24 - +24 |
+| contrast | Number | Retrieve or set the contrast. | -24 - +24 |
+| density | Number | Retrieve or set the density (color saturation). | -32 - +32 |
+| tint | Number | Retrieve or set the tint. | -32 - +32 |
+| colortemperature | Number | Retrieve or set the color temperature. | 0 - +9 |
+| fleshtemperature | Number | Retrieve or set the flesh temperature. | 0 - +6 |
+| gamma | String | Retrieve or set the gamma setting. | See above |
+| autokeystone | Switch | Turn the auto keystone mode on or off. | |
+| verticalkeystone | Number | Retrieve or set the vertical keystone. | -30 - +30 |
+| horizontalkeystone | Number | Retrieve or set the horizontal keystone. | -30 - +30 |
+| verticalposition | Number | Retrieve or set the vertical position. | -8 - +10 |
+| horizontalposition | Number | Retrieve or set the horizontal position. | -23 - +26 |
+| verticalreverse | Switch | Turn the vertical reverse mode on or off. | |
+| horizontalreverse | Switch | Turn the horizontal reverse mode on or off. | |
+| background | String | Retrieve or set the background color/logo. | See above |
+| keycode | String | Send a key operation command to the projector. (2 character code) | Send only |
+| lamptime | Number | Retrieves the lamp hours. | Read only |
+| errcode | Number | Retrieves the last error code. | Read only |
+| errmessage | String | Retrieves the description of the last error. | Read only |
## Full Example
things/epson.things:
-```
+```java
// serial port connection
epsonprojector:projector-serial:hometheater "Projector" [ serialPort="COM5", pollingInterval=10, maxVolume=20 ]
items/epson.items
-```
+```java
Switch epsonPower { channel="epsonprojector:projector-serial:hometheater:power" }
String epsonSource "Source [%s]" { channel="epsonprojector:projector-serial:hometheater:source" }
String epsonAspectRatio "Aspect Ratio [%s]" { channel="epsonprojector:projector-serial:hometheater:aspectratio" }
sitemaps/epson.sitemap
-```
+```perl
sitemap epson label="Epson Projector"
{
Frame label="Controls" {
The Etherrain binding is used to control a sprinkler controller from Quicksmart:
-http://www.quicksmart.com/qs_etherrain.html
+<http://www.quicksmart.com/qs_etherrain.html>
-The API exposed by the controller is fairly robust, but it is specific.
+The API exposed by the controller is fairly robust, but it is specific.
The binding attempts to map this API to an openHAB thing while perserving the functionality.
## Overview
An Etherrain controller can control 7-8 zones (depending on model) and can also report on the status of a rain sensor.
-The controller itself accepts a single command that contains an initial delay, and an on-time for each of the zone.
-Once this execute command is sent, the controller will, first, wait the initial delay time, then cycle through each zone and turn it on the amount of time specified.
-The binding exposes the rain sensor as a contact as well as the operating status of of the controller.
-
+The controller itself accepts a single command that contains an initial delay, and an on-time for each of the zone.
+Once this execute command is sent, the controller will, first, wait the initial delay time, then cycle through each zone and turn it on the amount of time specified.
+The binding exposes the rain sensor as a contact as well as the operating status of of the controller.
## Supported Things
-The etherrain thing represents a physical Etherrain controller and contains all channels need to control it.
+The etherrain thing represents a physical Etherrain controller and contains all channels need to control it.
## Discovery
## Binding Configuration
-There are two main categories of configuration.
+There are two main categories of configuration.
The first is the configuration of the communication settings (IP address, timeout, etc.).
-The second is the initial delay and on-time for each zone when an execute command is issued.
+The second is the initial delay and on-time for each zone when an execute command is issued.
## Thing Configuration
This is optional, it is recommended to let the binding discover and add Etherrain controllers.
-To manually configure an Etherrain controller you may specify its host name or ip ("host").
-You can also optionally specify the unit's password ("pw"), port it is communicating on ("port") or refresh rate ("refresh")
+To manually configure an Etherrain controller you may specify its host name or ip ("host").
+You can also optionally specify the unit's password ("pw"), port it is communicating on ("port") or refresh rate ("refresh")
-```
+```java
Bridge etherrain:etherrain:BackyardSprinkler [ host="192.168.1.100"]
```
## Channels
-The etherrain controller exposes the rain sensor as well as several status messages.
+The etherrain controller exposes the rain sensor as well as several status messages.
Finally, there are commands to execute and clear the commands:
items:
-```
+```java
String SprinklerCommandStatus "Command Status [%s]" (gMain) { channel="etherrain:etherrain:sprinkler0:commandstatus" }
String SprinklerOperatingStatus "Operating Status [%s]" (gMain) { channel="etherrain:etherrain:sprinkler0:operatingstatus" }
String SprinklerOperatingResult "Operating Result [%s]" (gMain) { channel="etherrain:etherrain:sprinkler0:operatingresult" }
Switch SprinklerExecute (gMain) { channel="etherrain:etherrain:sprinkler0:execute" }
Switch SprinklerClear (gMain) { channel="etherrain:etherrain:sprinkler0:clear" }
```
-
| Parameter | Type | Description | Advanced | Required |
|-----------------|--------|----------------------------------------------------------|----------|----------|
-| url | String | URL of evcc web UI, e.g. *https://demo.evcc.io* | No | Yes |
+| url | String | URL of evcc web UI, e.g. `https://demo.evcc.io` | No | Yes |
| refreshInterval | Number | Interval the status is polled in seconds (minimum is 15) | Yes | No |
-Default value for *refreshInterval* is 60 seconds.
+Default value for _refreshInterval_ is 60 seconds.
## Channels
| general#homePower | Number:Power | R | Current power taken by home. |
| general#pvPower | Number:Power | R | Current power from photovoltaik. |
-
### Loadpoint channels
Those channels exist per configured loadpoint.
-Please note that you have to replace *N* with your loadpoint number.
+Please note that you have to replace _N_ with your loadpoint number.
| Channel | Type | Read/Write | Description |
|-------------------------------------|------------------------|------------|-----------------------------------------------------------------------------------------------------|
### Thing(s)
-```
+```java
Thing evcc:device:demo "evcc Demo" [url="https://demo.evcc.io", refreshInterval=60]
```
### Items
-```
+```java
// General
Number:Power evcc_demo_batteryPower "Battery Power [%.1f kW]" <energy> {channel="evcc:device:demo:general#batteryPower"}
Number:Dimensionless evcc_demo_batterySoC "Battery SoC [%d %%]" <batterylevel> {channel="evcc:device:demo:general#batterySoC"}
### Sitemap
-```
+```perl
sitemap evcc label="evcc Demo" {
Frame label="General" {
Text item=evcc_demo_batteryPower
The binding supports the following things:
-* evohome Account
-* evotouch control display
-* Heating zones
+- evohome Account
+- evotouch control display
+- Heating zones
### evohome Account
This thing functions as the bridge between all the other things.
It contains your credentials and connects to the Honeywell web API.
-
### evotouch
This thing represents the central display controller.
The heating zone thing represents the evohome heating zone.
It displays the current temperature, the temperature set point and the status of the set point.
-It also allows you to permanently override the current temperature set point as well as canceling any active overrides.
+It also allows you to permanently override the current temperature set point as well as canceling any active overrides.
## Discovery
| Temperature | Number | Allows for viewing the current actual temperature of the zone. |
| SetPointStatus | String | Allows for viewing the current set point mode of the zone. |
| SetPoint | Number | Allows for viewing and permanently overriding the temperature set point of the zone. Sending 0 cancels any active set point overrides. |
+
## Full Example
### demo.things
-```
+```java
Bridge evohome:account:your_account_alias [ username="your_user_name", password="your_password" ]
{
display your_display_alias [ id="1234" ]
### demo.items
-```
+```java
// evohome Display
String DemoMode { channel="evohome:display:your_account_alias:your_display_alias:SystemMode" }
### demo.sitemap
-```
+```perl
sitemap evohome label="evohome Menu"
{
Frame label="evohome display" {
The `command` itself can be enhanced using the well known syntax of the [Java formatter class syntax](https://docs.oracle.com/javase/8/docs/api/java/util/Formatter.html#syntax).
The following parameters are automatically added:
-- the current date (as java.util.Date, example: `%1$tY-%1$tm-%1$td`)
-- the current (or last) command to the input channel (see below, example: `%2$s`)
+- the current date (as java.util.Date, example: `%1$tY-%1$tm-%1$td`)
+- the current (or last) command to the input channel (see below, example: `%2$s`)
note - if you trigger execution using interval or the run channel, the `%2` substitution will use the most recent command (if there has been one) sent to the input channel. The state of the Item linked to input channel is ignored.
## Minimal Example
-**demo.things**
+### demo.things
```java
Thing exec:command:apc [command="/usr/local/bin/apcaccess status", interval=15, timeout=5]
Thing exec:command:myscript [command="php ./configurations/scripts/script.php %2$s", transform="REGEX((.*?))"]
```
-**demo.items**
+### demo.items
```java
String APCRaw "[%s]" (All) {channel="exec:command:apc:output"}
Following is an example how to set up an exec command thing, pass it a parameter, debug it with a rule and set the returned string to a Number Item.
-**demo.things**
+### demo.things
```java
// "%2$s" will be replace by the input channel command, this makes it possible to use one command line with different arguments.
Thing exec:command:yourcommand [ command="<YOUR COMMAND> %2$s", interval=0, autorun=false ]
```
-**demo.items**
+### demo.items
```java
Switch YourTrigger "External trigger [%s]"
String yourcommand_Out {channel="exec:command:yourcommand:output"}
```
-**demo.sitemap**
+### demo.sitemap
```java
// Name of file and name of sitemap has to be the same
}
```
-**demo.rules**
+### demo.rules
```java
rule "Set up your parameters"
projects / openhab-addons.git / commitdiff