public/openhab-addons
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[mystrom] Add support for myStrom Bulb (#9910)

Browse Source 
* Add support to myStrom Bulb

Add properties to myStrom devices and an action to refresh the properties.

Signed-off-by: Frederic Chastagnol <fchastagnol@fredoware.ch>

* Fixes according to review comments

Signed-off-by: Frederic Chastagnol <fchastagnol@fredoware.ch>

* Update bundles/org.openhab.binding.mystrom/README.md

Co-authored-by: J-N-K <J-N-K@users.noreply.github.com>

* Fixes according to review comments

Signed-off-by: Frederic Chastagnol <fchastagnol@fredoware.ch>

* Use system color temperature channel type

channel type system.color-temperature is used and values mapped from 1-18 to 0-100%

Signed-off-by: Frederic Chastagnol <fchastagnol@fredoware.ch>

* Better tracking of colour and brightness values

Format power state
Signed-off-by: Frederic Chastagnol <fchastagnol@fredoware.ch>

Co-authored-by: J-N-K <J-N-K@users.noreply.github.com>
This commit is contained in:
Fredo70
2021-02-23 23:33:12 +01:00
committed by GitHub
parent fd1f7ebe75
commit 7050a1478e
8 changed files with 656 additions and 78 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
bundles/org.openhab.binding.mystrom/README.md
View File

@@ -9,6 +9,9 @@ This bundle adds the following thing types:
| Thing | ThingTypeID | Description |
| ------------------ | ----------- | -------------------------------------------------- |
| myStrom Smart Plug | mystromplug | A myStrom smart plug |
| myStrom Bulb | mystrombulb | A myStrom bulb |
According to the myStrom API documentation all request specific to the myStrom Bulb are also work on the LED strip.
## Discovery
@@ -24,13 +27,37 @@ The following parameters are valid for all thing types:
| hostname | string | yes | localhost | The IP address or hostname of the myStrom smart plug |
| refresh | integer | no | 10 | Poll interval in seconds. Increase this if you encounter connection errors |
## Properties
In addition to the configuration a myStrom thing has the following properties.
The properties are updated during initialize.
Disabling/enabling the thing can be used to update the properties.
| Property-Name | Description |
| ------------- | --------------------------------------------------------------------- |
| version | Current firmware version |
| type | The type of the device (i.e. bulb = 102) |
| ssid | SSID of the currently connected network |
| ip | Current ip address |
| mask | Mask of the current network |
| gateway | Gateway of the current network |
| dns | DNS of the current network |
| static | Whether or not the ip address is static |
| connected | Whether or not the device is connected to the internet |
| mac | The mac address of the bridge in upper case letters without delimiter |
## Channels
| Channel ID | Item Type | Read only | Description |
| ---------------- | -------------------- | --------- | ------------------------------------------------------------- |
| switch | Switch | false | Turn the smart plug on or off |
| power | Number:Power | true | The currently delivered power |
| temperature | Number:Temperature | true | The temperature at the plug |
| Channel ID | Item Type | Read only | Description | Thing types supporting this channel |
| ---------------- | -------------------- | --------- | --------------------------------------------------------------------- |-------------------------------------|
| switch | Switch | false | Turn the device on or off | mystromplug, mystrombulb |
| power | Number:Power | true | The currently delivered power | mystromplug, mystrombulb |
| temperature | Number:Temperature | true | The temperature at the plug | mystromplug |
| color | Color | false | The color we set the bulb to (mode 'hsv') | mystrombulb |
| colorTemperature | Dimmer | false | The color temperature of the bulb in mode 'mono' (percentage) | mystrombulb |
| brightness | Dimmer | false | The brightness of the bulb in mode 'mono' | mystrombulb |
| ramp | Number:Time | false | Transition time from the light’s current state to the new state. [ms] | mystrombulb |
| mode | String | false | The color mode we want the Bulb to set to (rgb, hsv or mono) | mystrombulb |
## Full Example