Skip to content

Commit

Permalink
[elroconnects] New binding for Elro Connects (#11189)
Browse files Browse the repository at this point in the history 
* Adjustments after review.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Fix pom.xml formatting.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Some fixes and removed redundant null checks.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Proper thread naming.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Adjust brand name capitalization. Some README adjustments.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Fix format issue.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Fix threadname.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Update development cycle

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Review fixes

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Avoid communication restart when disposing

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Update CODEOWNERS

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Code review.

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Background discovery

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Fix formatting

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Create i18n properties file

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Add IP Adress parameter

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>

* Moved hostname resolving out of initialize

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>
  • Loading branch information
@mherwege
mherwege authored Mar 20, 2022
1 parent 5f9096b commit 7c29e4d
Show file tree
Hide file tree
Showing 34 changed files with 3,545 additions and 0 deletions.
1 change: 1 addition & 0 deletions CODEOWNERS
View file
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,7 @@
/bundles/org.openhab.binding.ekey/ @hmerk
/bundles/org.openhab.binding.electroluxair/ @jannegpriv
/bundles/org.openhab.binding.elerotransmitterstick/ @vbier
/bundles/org.openhab.binding.elroconnects/ @mherwege
/bundles/org.openhab.binding.energenie/ @hmerk
/bundles/org.openhab.binding.enigma2/ @gdolfen
/bundles/org.openhab.binding.enocean/ @fruggy83
Expand Down
5 changes: 5 additions & 0 deletions bom/openhab-addons/pom.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -401,6 +401,11 @@
<artifactId>org.openhab.binding.elerotransmitterstick</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>org.openhab.addons.bundles</groupId>
<artifactId>org.openhab.binding.elroconnects</artifactId>
<version>${project.version}</version>
</dependency>
<dependency>
<groupId>org.openhab.addons.bundles</groupId>
<artifactId>org.openhab.binding.energenie</artifactId>
Expand Down
13 changes: 13 additions & 0 deletions bundles/org.openhab.binding.elroconnects/NOTICE
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
This content is produced and maintained by the openHAB project.

* Project home: https://www.openhab.org

== Declared Project Licenses

This program and the accompanying materials are made available under the terms
of the Eclipse Public License 2.0 which is available at
https://www.eclipse.org/legal/epl-2.0/.

== Source Code

/~https://github.com/openhab/openhab-addons
176 changes: 176 additions & 0 deletions bundles/org.openhab.binding.elroconnects/README.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,176 @@
# ELRO Connects Binding

The ELRO Connects binding provides integration with the [ELRO Connects](https://www.elro.eu/en/smart-home) smart home system.

The system uses a Wi-Fi Hub (K1 Connector) to enable communication with various smart home devices.
The devices communicate with the hub using 868MHz RF.
The binding only communicates with the ELRO Connects system and K1 Connector using UDP in the local network.

The binding exposes the devices' status and controls to openHAB.
The K1 connector itself allows setting up scenes through a mobile application.
The binding supports selecting a specific scene.

Many of the sensor devices are battery powered.

## Supported Things

The ELRO Connects supported device types are:

* 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`

The `connector` is the bridge thing.
All other things are connected to the bridge.

Testing was only done with smoke and water detectors connected to a K1 connector.
The firmware version of the K1 connector was 2.0.3.30 at the time of testing.
Older versions of the firmware are known to have differences in the communication protocol.

## Discovery

The K1 connector `connector` cannot be auto-discovered.
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.
Alarm devices can still trigger alarms and pass them between each other, even if the connection with the hub is lost.
It will not be possible to receive alarms and control them from openHAB in this case.

## Thing Configuration

### K1 connector hub

| Parameter | Advanced | Description |
|-------------------|:--------:|------------------------|
| `connectorId` | | Required parameter, should be set to ST_xxxxxxxxxxxx with xxxxxxxxxxxx the lowercase MAC address of the connector. This parameter can also be found in the ELRO Connects mobile application. |
| `ipAdress` | Y | IP address of the ELRO Connects K1 Connector, not required if connector and openHAB server in same subnet. |
| `refreshInterval` | Y | This parameter controls the connection refresh heartbeat interval. The default is 60s. |

### Devices connected to K1 connected hub

| Parameter | Description |
|--------------------|----------------------|
| `deviceId` | Required parameter, set by discovery and cannot easily be found manually. It should be a number. |

## Channels

### K1 connector hub

The `connector` bridge thing has only one channel:

| Channel ID | Item Type | Access Mode | Description |
|--------------------|----------------------|:-----------:|----------------------------------------------------|
| `scene` | String | RW | current scene |

The `scene` channel has a dynamic state options list with all possible scene choices available in the hub.

## Smoke, carbon monoxide, heat and water alarms

All these things have the same channels:

| Channel ID | Item Type | Access Mode | Description |
|--------------------|----------------------|:-----------:|----------------------------------------------------|
| `muteAlarm` | Switch | RW | mute alarm |
| `testAlarm` | Switch | RW | test alarm |
| `battery` | Number | R | battery level in % |
| `lowBattery` | Switch | R | on for low battery (below 15%) |

Each also has a trigger channel, resp. `smokeAlarm`, `coAlarm`, `heatAlarm` and `waterAlarm`.
The payload for these trigger channels is empty.

## Door/window contact

The `entrysensor` thing has the following channels:

| Channel ID | Item Type | Access Mode | Description |
|--------------------|----------------------|:-----------:|----------------------------------------------------|
| `entry` | Contact | R | open/closed door/window |
| `battery` | Number | R | battery level in % |
| `lowBattery` | Switch | R | on for low battery (below 15%) |

The `entrysensor` thing also has a trigger channel, `entryAlarm`.

## Motion sensor

The `motionsensor` thing has the following channels:

| Channel ID | Item Type | Access Mode | Description |
|--------------------|----------------------|:-----------:|----------------------------------------------------|
| `motion` | Switch | R | on when motion detected |
| `battery` | Number | R | battery level in % |
| `lowBattery` | Switch | R | on for low battery (below 15%) |

The `motionsensor` thing also has a trigger channel, `motionAlarm`.

## Temperature and humidity monitor

The `temperaturesensor` thing has the following channels:

| Channel ID | Item Type | Access Mode | Description |
|--------------------|----------------------|:-----------:|----------------------------------------------------|
| `temperature` | Number:Temperature | R | temperature |
| `humidity` | Number:Dimensionless | R | device status |
| `battery` | Number | R | battery level in % |
| `lowBattery` | Switch | R | on for low battery (below 15%) |

## Plug-in switch

The `powersocket` thing has only one channel:

| Channel ID | Item Type | Access Mode | Description |
|--------------------|----------------------|:-----------:|----------------------------------------------------|
| `powerState` | Switch | RW | power on/off |


## Full Example

.things:

```
Bridge elroconnects:connector:myhub [ connectorId="ST_aabbccddaabbccdd", refreshInterval=120 ] {
smokealarm 1 "LivingRoom" [ deviceId="1" ]
coalarm 2 "Garage" [ deviceId="2" ]
heatalarm 3 "Kitchen" [ deviceId="3" ]
wateralarm 4 "Basement" [ deviceId="4" ]
entrysensor 5 "Back Door" [ deviceId="5" ]
motionsensor 6 "Hallway" [ deviceId="6" ]
temperaturesensor 7 "Family Room" [ deviceId = "7" ]
powersocket 8 "Television" [ deviceId = "8" ]
}
```

.items:

```
String Scene {channel="elroconnects:connector:myhub:scene"}
Number BatteryLevel {channel="elroconnects:smokealarm:myhub:1:battery"}
Switch AlarmTest {channel="elroconnects:smokealarm:myhub:1:test"}
```

.sitemap:

```
Text item=Scene
Number item=BatteryLevel
Switch item=AlarmTest
```

Example trigger rule:

```
rule "example trigger rule"
when
Channel 'elroconnects:smokealarm:myhub:1:smokeAlarm' triggered
then
logInfo("Smoke alarm living room")
...
end
```


17 changes: 17 additions & 0 deletions bundles/org.openhab.binding.elroconnects/pom.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">

<modelVersion>4.0.0</modelVersion>

<parent>
<groupId>org.openhab.addons.bundles</groupId>
<artifactId>org.openhab.addons.reactor.bundles</artifactId>
<version>3.3.0-SNAPSHOT</version>
</parent>

<artifactId>org.openhab.binding.elroconnects</artifactId>

<name>openHAB Add-ons :: Bundles :: ElroConnects Binding</name>

</project>
9 changes: 9 additions & 0 deletions bundles/org.openhab.binding.elroconnects/src/main/feature/feature.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<?xml version="1.0" encoding="UTF-8"?>
<features name="org.openhab.binding.elroconnects-${project.version}" xmlns="http://karaf.apache.org/xmlns/features/v1.4.0">
<repository>mvn:org.openhab.core.features.karaf/org.openhab.core.features.karaf.openhab-core/${ohc.version}/xml/features</repository>

<feature name="openhab-binding-elroconnects" description="ELRO Connects Binding" version="${project.version}">
<feature>openhab-runtime-base</feature>
<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.elroconnects/${project.version}</bundle>
</feature>
</features>
Loading

0 comments on commit 7c29e4d

Please sign in to comment.