mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 23:22:02 +01:00
7050a1478e
* 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>
88 lines
4.9 KiB
Markdown
88 lines
4.9 KiB
Markdown
# myStrom Binding
|
||
|
||
This extension adds support for the myStrom devices. Currently only the smart plug is implemented.
|
||
|
||
## Supported Things
|
||
|
||
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
|
||
|
||
This extension does not support autodiscovery. The things need to be added manually.
|
||
|
||
|
||
## Thing Configuration
|
||
|
||
The following parameters are valid for all thing types:
|
||
|
||
| Parameter | Type | Required | Default if omitted | Description |
|
||
| --------- | ------- | -------- | ------------------ | -------------------------------------------------------------------------- |
|
||
| 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 | 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
|
||
|
||
### Thing Configuration
|
||
|
||
```
|
||
Thing mystrom:mystromplug:d6217a31 "Plug" [hostname="hostname|ip"]
|
||
```
|
||
|
||
### Item Configuration
|
||
|
||
```
|
||
Switch PlugSwitch "Plug" {channel="mystrom:mystromplug:d6217a31:switch"}
|
||
Number:Temperature PlugTemperature "Temperature: [%.1f °C]" {channel="mystrom:mystromplug:d6217a31:temperature"}
|
||
Number:Power PlugPower "Power: [%.1f W]" {channel="mystrom:mystromplug:d6217a31:power"}
|
||
|
||
```
|
||
|
||
### Sitemap Configuration
|
||
|
||
```
|
||
Frame label="myStrom Plug" {
|
||
Switch item=PlugSwitch
|
||
Text item=PlugTemperature
|
||
Text item=PlugPower
|
||
}
|
||
```
|