2022-10-16 23:13:12 +02:00
# Broadlink Binding
2021-02-08 23:08:09 +01:00
2022-10-16 23:13:12 +02:00
The binding integrates devices based on broadlink controllers.
2021-02-08 23:08:09 +01:00
As the binding uses the [broadlink-java-api ](https://github.com/mob41/broadlink-java-api ), theoretically all devices supported by the api can be integrated with this binding.
## Supported Things
2022-12-07 21:09:32 +01:00
_Note:_ So far only the Floureon Thermostat and Rm Mini 3 devices has been tested! The other things are "best guess" implementations.
2021-02-08 23:08:09 +01:00
2022-10-16 23:13:12 +02:00
| Things | Description | Thing Type |
|-------------------------|---------------------------------------------------------------------|----------------------|
| Floureon Thermostat | broadlink based Thermostat sold with the branding Floureon | floureonthermostat |
| Hysen Thermostat | broadlink based Thermostat sold with the branding Hysen | hysenthermostat |
| Rm Mini | broadlink based Universal Controller sold with the branding Rm Mini | rmuniversalremote |
2021-02-08 23:08:09 +01:00
## Discovery
2022-10-16 23:13:12 +02:00
Broadlink devices are discovered on the network by sending a specific broadcast message.
2021-02-08 23:08:09 +01:00
Authentication is automatically sent after creating the thing.
## Thing Configuration
Two parameter are required for creating things:
- `host` : The hostname or IP address of the device.
2022-08-11 21:30:33 +02:00
- `macAddress` : The network MAC of the device.
2021-02-08 23:08:09 +01:00
The autodiscovery process finds both parts automatically.
## Channels
### Floureon-/Hysenthermostat
2022-10-16 23:13:12 +02:00
| Channel Type ID | Item Type | Description |
2021-02-08 23:08:09 +01:00
|-------------------------------|--------------------|----------------------------------------------------------------------|
| power | Switch | Switch display on/off and enable/disables heating |
| mode | String | Current mode of the thermostat (`auto` or `manual` ) |
| sensor | String | The sensor (`internal`/`external`) used for triggering the thermostat|
| roomtemperature | Number:Temperature | Room temperature, measured directly at the device |
| roomtemperatureexternalsensor | Number:Temperature | Room temperature, measured by an external sensor |
| active | Switch | Show if thermostat is currently actively heating |
| setpoint | Number:Temperature | Temperature setpoint that open/close valve |
| temperatureoffset | Number:Temperature | Manual temperature adjustment |
| remotelock | Switch | Locks the device to only allow remote actions |
| time | DateTime | The time and day of week of the device |
2022-10-16 23:13:12 +02:00
### RM Mini Universal Controller
| Channel Type ID | Item Type | Description |
|-------------------------------|--------------------|----------------------------------------------------------------------|
| learningmode | Switch | Put device in infrared learning mode when turned on |
| savelearned | String | Saves the learned keys using the provided name |
| sendlearned | String | Send previously learned keys by name |
2021-02-08 23:08:09 +01:00
## Full Example
demo.things:
2022-12-07 21:09:32 +01:00
```java
2022-08-11 21:30:33 +02:00
Thing broadlinkthermostat:floureonthermostat:bathroomthermostat "Bathroom Thermostat" [ host="192.168.0.23", macAddress="00:10:FA:6E:38:4A"]
2021-02-08 23:08:09 +01:00
```
demo.items:
2022-12-07 21:09:32 +01:00
```java
2021-02-08 23:08:09 +01:00
Number:Temperature Bathroom_Thermostat_Temperature "Room temperature [%.1f %unit%]" < temperature > { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:roomtemperature"}
Number:Temperature Bathroom_Thermostat_Temperature_Ext "Room temperature (ext) [%.1f %unit%]" < temperature > { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:roomtemperature"}
Number:Temperature Bathroom_Thermostat_Setpoint "Setpoint [%.1f %unit%]" < temperature > { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:setpoint"}
Switch Bathroom_Thermostat_Power "Power" { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:power"}
Switch Bathroom_Thermostat_Active "Active" { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:active"}
String Bathroom_Thermostat_Mode "Mode" { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:mode"}
String Bathroom_Thermostat_Sensor "Sensor" { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:sensor"}
Switch Bathroom_Thermostat_Lock "Lock" < lock > { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:remotelock"}
DateTime Bathroom_Thermostat_Time "Time [%1$tm/%1$td %1$tH:%1$tM]" < time > { channel="broadlinkthermostat:floureonthermostat:bathroomthermostat:time"}
```
