Updated external content (Jenkins build 106)
openHAB Build Server
parent
08cb68a6f2
commit
647c19ceaf
File diff suppressed because one or more lines are too long
|
|
@ -0,0 +1,74 @@
|
|||
---
|
||||
id: bluetooth.enoceanble
|
||||
label: EnOcean BLE
|
||||
title: EnOcean BLE - Bindings
|
||||
type: binding
|
||||
description: "This binding adds support for the"
|
||||
since: 3x
|
||||
install: manual
|
||||
---
|
||||
|
||||
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# EnOcean BLE Binding
|
||||
|
||||
This binding adds support for the
|
||||
[EnOcean BLE PTM215B](https://www.enocean.com/de/produkte/enocean_module_24ghz_ble/ptm-215b/) rocker.
|
||||
|
||||
**Currently, it does not work with the
|
||||
[BlueZ Binding](https://www.openhab.org/addons/bindings/bluetooth.bluez)**.
|
||||
The recommended / tested Bluetooth bridge binding is the
|
||||
[BlueGiga Binding](https://www.openhab.org/addons/bindings/bluetooth.bluegiga).
|
||||
|
||||
## Supported Things
|
||||
|
||||
Only a single thing type is added by this extension:
|
||||
|
||||
| Thing Type ID | Description |
|
||||
| --------------- | ------------------------- |
|
||||
| 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
|
||||
retrieve the online status. Therefore, initial online status will always be "UNKNOWN" until the rocker is used.
|
||||
|
||||
## Discovery
|
||||
|
||||
As any other Bluetooth device, EnOcean BLE rockers are discovered automatically by the corresponding bridge. It's
|
||||
necessary to click any button of the rocker up to 15 times in quick succession to get it discovered.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
There is only a single configuration parameter `address`, which corresponds to the Bluetooth address of the device
|
||||
(in format "XX:XX:XX:XX:XX:XX"). Normally, the address is printed on the back of the rocker.
|
||||
|
||||
## Channels
|
||||
|
||||
An EnOcean PTM 215B Rocker has the following channels:
|
||||
|
||||
| Channel ID | Item Type | Description |
|
||||
| ------------------------- | ------------------------ | ------------------------------ |
|
||||
| rocker1 | system.rawrocker | In case of a dual rocker, the first rocker. In case of a single rocker, usually this channel has to be used. Anyhow, it depends from the implementation of the manufacturer of the rocker, so it could be that events are coming in on the second rocker channel. |
|
||||
| rocker2 | system.rawrocker | In case of a dual rocker, the second rocker. |
|
||||
|
||||
## Example
|
||||
|
||||
demo.things:
|
||||
|
||||
```
|
||||
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:
|
||||
|
||||
```
|
||||
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"] }
|
||||
```
|
||||
|
|
@ -1400,8 +1400,8 @@ e.g. `smarthome:send actionCommand 'upd_timer["1498595904821", "on"]'` would ena
|
|||
| brush-left-time | Number | Brush Cleaner - Brush Left Time | |
|
||||
| brush-life-level1 | Number | Brush Cleaner - Brush Life Level | |
|
||||
| brush-left-time1 | Number | Brush Cleaner - Brush Left Time | |
|
||||
| clean-area | Number | Clean Record - Clean Area | |
|
||||
| clean-time | Number | Clean Record - Clean Time | |
|
||||
| clean-area | Number:Area | Clean Record - Clean Area | |
|
||||
| clean-time | Number:Time | Clean Record - Clean Time | |
|
||||
| total-clean-area | Number | Clean Record - Total Clean Area | |
|
||||
| total-clean-time | Number | Clean Record - Total Clean Time | |
|
||||
| total-clean-count | Number | Clean Record - Total Clean Count | |
|
||||
|
|
@ -4460,8 +4460,8 @@ Number brush-life-level "Brush Cleaner - Brush Life Level" (G_vacuum) {channel="
|
|||
Number brush-left-time "Brush Cleaner - Brush Left Time" (G_vacuum) {channel="miio:basic:vacuum:brush-left-time"}
|
||||
Number brush-life-level1 "Brush Cleaner - Brush Life Level" (G_vacuum) {channel="miio:basic:vacuum:brush-life-level1"}
|
||||
Number brush-left-time1 "Brush Cleaner - Brush Left Time" (G_vacuum) {channel="miio:basic:vacuum:brush-left-time1"}
|
||||
Number clean-area "Clean Record - Clean Area" (G_vacuum) {channel="miio:basic:vacuum:clean-area"}
|
||||
Number clean-time "Clean Record - Clean Time" (G_vacuum) {channel="miio:basic:vacuum:clean-time"}
|
||||
Number:Area clean-area "Clean Record - Clean Area" (G_vacuum) {channel="miio:basic:vacuum:clean-area"}
|
||||
Number:Time clean-time "Clean Record - Clean Time" (G_vacuum) {channel="miio:basic:vacuum:clean-time"}
|
||||
Number total-clean-area "Clean Record - Total Clean Area" (G_vacuum) {channel="miio:basic:vacuum:total-clean-area"}
|
||||
Number total-clean-time "Clean Record - Total Clean Time" (G_vacuum) {channel="miio:basic:vacuum:total-clean-time"}
|
||||
Number total-clean-count "Clean Record - Total Clean Count" (G_vacuum) {channel="miio:basic:vacuum:total-clean-count"}
|
||||
|
|
|
|||
|
|
@ -0,0 +1,30 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<thing:thing-descriptions bindingId="bluetooth"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xmlns:thing="https://openhab.org/schemas/thing-description/v1.0.0"
|
||||
xsi:schemaLocation="https://openhab.org/schemas/thing-description/v1.0.0 https://openhab.org/schemas/thing-description-1.0.0.xsd">
|
||||
|
||||
<thing-type id="ptm215b">
|
||||
<supported-bridge-type-refs>
|
||||
<bridge-type-ref id="roaming"/>
|
||||
<bridge-type-ref id="bluegiga"/>
|
||||
<bridge-type-ref id="bluez"/>
|
||||
</supported-bridge-type-refs>
|
||||
|
||||
<label>Enocean PTM 215B Rocker</label>
|
||||
<description>An Enocean BLE Rocker (PTM 215B)</description>
|
||||
|
||||
<channels>
|
||||
<channel id="rocker1" typeId="system.rawrocker"/>
|
||||
<channel id="rocker2" typeId="system.rawrocker"/>
|
||||
</channels>
|
||||
|
||||
<config-description>
|
||||
<parameter name="address" type="text">
|
||||
<label>Address</label>
|
||||
<description>Bluetooth address in XX:XX:XX:XX:XX:XX format</description>
|
||||
</parameter>
|
||||
</config-description>
|
||||
|
||||
</thing-type>
|
||||
</thing:thing-descriptions>
|
||||
Loading…
Reference in New Issue