mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 23:22:02 +01:00
84 lines
3.5 KiB
Markdown
84 lines
3.5 KiB
Markdown
|
# Sensibo Binding
|
||
|
|
|
||
|
|
This binding integrates the Sensibo Sky aircondition remote control
|
||
|
|
See https://www.sensibo.com/
|
||
|
|
|
||
|
|
## Supported Things
|
||
|
|
|
||
|
|
This binding supports Sensibo Sky only.
|
||
|
|
|
||
|
|
* `account` = Sensibo API - the account bridge
|
||
|
|
* `sensibosky` = Sensibo Sky remote control
|
||
|
|
|
||
|
|
## Discovery
|
||
|
|
|
||
|
|
In order to do discovery, add a thing of type Sensibo API and add the API key.
|
||
|
|
API key can be obtained here: https://home.sensibo.com/me/api
|
||
|
|
|
||
|
|
## Thing Configuration
|
||
|
|
|
||
|
|
See full example below for how to configure using thing files.
|
||
|
|
|
||
|
|
### Account
|
||
|
|
|
||
|
|
* `apiKey` = API key obtained here: https://home.sensibo.com/me/api
|
||
|
|
* `refreshInterval` = number of seconds between refresh calls to the server
|
||
|
|
|
||
|
|
### Sensibo Sky
|
||
|
|
|
||
|
|
* `macAddress` = network mac address of device.
|
||
|
|
|
||
|
|
Can be found printed on the back of the device
|
||
|
|
Or you can find it during discovery.
|
||
|
|
|
||
|
|
## Channels
|
||
|
|
|
||
|
|
### Sensibo Sky
|
||
|
|
|
||
|
|
| Channel | Read/write | Item type | Description |
|
||
|
|
| ------------------- | ------------- | --------------------- | ----------- |
|
||
|
|
| currentTemperature | R | Number:Temperature | Measured temperature |
|
||
|
|
| currentHumidity | R | Number:Dimensionless | Measured relative humidity, reported in percent |
|
||
|
|
| targetTemperature | R/W | Number:Temperature | Current target temperature for this room |
|
||
|
|
| masterSwitch | R/W | Switch | Switch AC ON or OFF |
|
||
|
|
| mode | R/W | String | Current mode (cool, heat, etc, actual modes provided provided by the API) being active |
|
||
|
|
| fanLevel | R/W | String | Current fan level (low, auto etc, actual levels provided provided by the API |
|
||
|
|
| swingMode | R/W | String | Current swing mode (actual modes provided provided by the API |
|
||
|
|
| timer | R/W | Number | Number of seconds until AC is switched off automatically. Setting to a value less than 60 seconds will cancel timer |
|
||
|
|
|
||
|
|
## Full Example
|
||
|
|
|
||
|
|
sensibo.things:
|
||
|
|
|
||
|
|
```
|
||
|
|
Bridge sensibo:account:home "Sensibo account" [apiKey="XYZASDASDAD", refreshInterval=120] {
|
||
|
|
Thing sensibosky office "Sensibo Sky Office" [ macAddress="001122334455" ]
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
sensibo.items:
|
||
|
|
|
||
|
|
```
|
||
|
|
Number:Temperature AC_Office_Room_Current_Temperature "Temperature [%.1f %unit%]" <temperature> {channel="sensibo:sensibosky:home:office:currentTemperature"}
|
||
|
|
Number:Dimensionless AC_Office_Room_Current_Humidity "Relative humidity [%.1f %%]" <humidity > {channel="sensibo:sensibosky:home:office:currentHumidity"}
|
||
|
|
Number:Temperature AC_Office_Room_Target_Temperature "Target temperature [%d %unit%]" <temperature> {channel="sensibo:sensibosky:home:office:targetTemperature"}
|
||
|
|
String AC_Office_Room_Mode "AC mode [%s]" {channel="sensibo:sensibosky:home:office:mode"}
|
||
|
|
String AC_Office_Room_Swing_Mode "AC swing mode [%s]" {channel="sensibo:sensibosky:home:office:swingMode"}
|
||
|
|
Switch AC_Office_Heater_MasterSwitch "AC power [%s]" <switch> {channel="sensibo:sensibosky:home:office:masterSwitch"}
|
||
|
|
String AC_Office_Heater_Fan_Level "Fan level [%s]" <fan> {channel="sensibo:sensibosky:home:office:fanLevel"}
|
||
|
|
Number AC_Office_Heater_Timer "Timer seconds [%d]" <timer> {channel="sensibo:sensibosky:home:office:timer"}
|
||
|
|
```
|
||
|
|
|
||
|
|
sitemap:
|
||
|
|
|
||
|
|
```
|
||
|
|
Switch item=AC_Office_Heater_MasterSwitch
|
||
|
|
Selection item=AC_Office_Room_Mode
|
||
|
|
Setpoint item=AC_Office_Room_Target_Temperature
|
||
|
|
Selection item=AC_Office_Heater_Fan_Level
|
||
|
|
Selection item=AC_Office_Room_Swing_Mode
|
||
|
|
Text item=AC_Office_Room_Current_Temperature
|
||
|
|
Text item=AC_Office_Room_Current_Humidity
|
||
|
|
```
|
||
|
|
|