# Millheat Binding
-This binding integrates the Mill Wi-Fi enabled panel heaters.
-See https://www.millheat.com/mill-wifi/
+This binding integrates the Mill Wi-Fi enabled panel heaters. See https://www.millheat.com/mill-wifi/
## Supported Things
## Discovery
-The binding will discover homes with rooms and heaters.
+The binding will discover homes with rooms and heaters.
In order to do discovery, add a thing of type Mill Heating API and add username and password.
* `username` = email address used in app
* `password` = password used in app
-* `refreshInterval` = number of seconds between refresh calls to the server
+* `refreshInterval` = number of seconds between refresh calls to the server
### Home
### Heater
-* `macAddress` = network mac address of device.
-Can be found in the app by viewing devices.
-Or you can find it during discovery.
-Used for heaters connected to a room.
+* `macAddress` = network mac address of device in UPPERCASE.
+ Can be found in the app by viewing devices. Or you can find it during discovery. Used for heaters connected to a room.
* `heaterId` = id of device/heater, type number (not string)
-Use auto discovery to find this value.
-Used to identify independent heaters or heaters connected to a room.
+ Use auto discovery to find this value. Used to identify independent heaters or heaters connected to a room.
* `power` = number of watts this heater is consuming when active.
-Used to provide data for the currentPower channel.
+ Used to provide data for the currentPower channel.
Either `macAddres` or `heaterId` must be specified.
| heatingActive | R | Switch | Whether the heaters in this room are active |
| program | R | String | Name of program used in this room |
-
### Heater channels
| Channel | Read/write | Item type | Description |
| window | R | Contact | Whether this heater has detected that a window nearby is open/detection of cold air (UNTESTED) |
| masterSwitch | R/W | Switch | Turn heater ON/OFF. Channel available only if heater is not connected to a room |
-
## Full Example
millheat.things:
Bridge millheat:account:home "Millheat account" [username="email@address.com",password="topsecret"] {
Thing home monaco "Penthouse Monaco" [ homeId=100000000000000 ] // Note: numeric value
Thing room office "Office room" [ roomId=200000000000000 ] Note: numeric value
- Thing heater office "Office panel heater" [ macAddress="F0XXXXXXXXX", power=900, heaterId=12345 ] Note: heaterId is a numeric value
+ Thing heater office "Office panel heater" [ macAddress="F0XXXXXXXXX", power=900, heaterId=12345 ] Note: heaterId is a numeric value, macAddress in UPPERCASE
}
```