mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 15:11:59 +01:00
8d389b7e2e
* Add methods to update via Command; Add discovery * add vacation channels; rework README * Fixed code review issues: Corrected TimeZone-Handling Signed-off-by: Christian Kittel <ckittel@gmx.de>
4.8 KiB
4.8 KiB
OJElectronics Binding
With this binding it is possible to connect OWD5/MWD5 Thermostat of OJ Electronics.
Supported Things
There are two things:
| Thing | Type | Description |
|---|---|---|
| ojcloud | Bridge | OJ Electronics Cloud Connector |
| owd5 | Thing | OJ Electronics OWD5/MWD5 Thermostat |
Discovery
After the ojcloud bridge is succesfully initialized all thermostats will be discovered.
OJ Electronics Bridge configuration (ojcloud)
| Parameter | Description |
|---|---|
| userName | user name from the OJElectronics App (required) |
| password | password from the OJElectronics App (required) |
| apiKey | API key. You get the key from your local distributor. |
| apiUrl | URL of the API endpoint. Optional, the default value should always work. |
| refreshDelayInSeconds | Refresh interval in seconds. Optional, the default value is 30 seconds. |
| customerId | Customer ID. Optional, the default value should always work. |
| softwareVersion | Software version. Optional, the default value should always work. |
OJ Electronics OWD5/MWD5 Thermostat configuration (owd5)
| Parameter | Description |
|---|---|
| serialNumber | serial number from the OJElectronics App or the thermostat (required) |
Channels
| Channel | Type | Description |
|---|---|---|
| floorTemperature | Number:Temperature | Floor temperature |
| groupName | Text | Group name |
| groupId | Number | Group Id |
| online | Contact | Online |
| heating | Contact | Heating |
| roomTemperature | Number:Temperature | Room temperature |
| thermostatName | Text | Thermostat name |
| regulationMode | Text | Regulation mode |
| serialNumber | Text | Serial number |
| comfortSetpoint | Number:Temperature | Target comfort temperature |
| comfortEndTime | Date time | Date and time when the thermostat switchs back from comfort mode to automatic mode |
| boostEndTime | Date time | Date and time when the thermostat switchs back from boost mode to automatic mode |
| manualModeSetpoint | Number:Temperature | Target temperature of the manual mode |
| vacationEnabled | Contact | Vacation is enabled |
| vacationBeginDay | Date time | Vacation start date |
| vacationEndDay | Date time | Vacation end date |
Example
This example shows how to configure the OJElecttronics binding.
demo.things
Binding ojelectronics:ojcloud:myCloud "My Cloud" @ "My Home" [ userName="MyUserName" password="MyPassword" apiKey="The Key" ] {
Thing owd5 myThermostat [ serialNumber="123" ]
}
demo.items
Number Bath_Floor_Temperature "Bathroom: Floor Temperature" {channel="ojelectronics:owd5:myThermostat:floorTemperature"}
String Bath_Mode "Bathroom: Mode" {channel="ojelectronics:owd5:myThermostat:regulationMode"}
demo.sitemap
sitemap myHome label="my Home"{
Text item=Bath_Floor_Temperature
Text item=Bath_Mode
}