mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 15:11:59 +01:00
44 lines
3.0 KiB
Markdown
44 lines
3.0 KiB
Markdown
# CoolMasterNet Binding
|
|
|
|
The CoolMasterNet binding is used to control [CoolMasterNet HVAC bridge devices](https://coolautomation.com/products/coolmasternet/), using the "ASCII I/F" plaintext TCP control protocol.
|
|
|
|
## Discovery
|
|
|
|
The CoolMasterNet protocol does not support automatic discovery.
|
|
|
|
## Thing Configuration
|
|
|
|
- `controller` is an openHAB "bridge", and represents a single CoolMasterNet device. A single controller supports one or more HVAC units.
|
|
- `hvac` is an HVAC device connected to a controller. Each `hvac` thing is identified by a CoolMasterNet UID (refer to CoolMasterNet controller documentation).
|
|
|
|
Example demo.things configuration for two HVAC devices connected to a CoolMasterNet device found at IP 192.168.0.100:
|
|
|
|
```perl
|
|
Bridge coolmasternet:controller:main [ host="192.168.0.100" ] {
|
|
Thing hvac a [ uid="L1.100" ]
|
|
Thing hvac b [ uid="L1.101" ]
|
|
}
|
|
```
|
|
|
|
## Channels
|
|
|
|
| Channel | Item Type | Description |
|
|
|--------------|-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| on | Switch | Turn HVAC unit on and off. |
|
|
| mode | String | HVAC mode (cool, heat, auto, dry, fan). Unit may not support all modes. |
|
|
| fan_speed | String | Fan speed (l, m, h, t, a ) for respectively "Low", "Medium", "High", "Top" or "Auto". Unit may not support all speeds. |
|
|
| set_temp | Number | Temperature target setpoint in Celsius. |
|
|
| current_temp | Number | Current temperature in Celsius at HVAC unit. |
|
|
| louvre | String | Louvre angle (0, a, h, 3, 4, 6, v) for respectively "No Control", "Auto Swing", "Horizontal", "30 degrees", "45 degrees", "60 degrees" or "Vertical". Unit may not support all angles. |
|
|
|
|
## Item Configuration
|
|
|
|
```java
|
|
Switch ACOn "Lounge AC ON/OFF" { channel="coolmasternet:hvac:main:a:on"}
|
|
String ACMode "Lounge AC Mode" { channel="coolmasternet:hvac:main:a:mode" }
|
|
Number ACTemp "Lounge Temp" { channel="coolmasternet:hvac:main:a:current_temp" }
|
|
Number ACSet "Lounge AC Set" { channel="coolmasternet:hvac:main:a:set_temp" }
|
|
String ACFan "Lounge AC Fan" { channel="coolmasternet:hvac:main:a:fan_speed" }
|
|
String ACLouvre "Lounge AC Louvre" { channel="coolmasternet:hvac:main:a:louvre_angle" }
|
|
```
|