openhab-addons/bundles/org.openhab.binding.ojelectronics

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 successfully 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.
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 Example

Bridge 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:myCloud:myThermostat:floorTemperature"}
String Bath_Mode "Bathroom: Mode" {channel="ojelectronics:owd5:myCloud:myThermostat:regulationMode"}

demo.sitemap

sitemap myHome label="my Home"{
  Text item=Bath_Floor_Temperature
  Text item=Bath_Mode
}