https://github.com/lucacalcaterra/org.openhab.binding.melcloud
MelCloud binding for Openhab.
https://github.com/lucacalcaterra/org.openhab.binding.melcloud
air-conditioner domotic melcloud mitsubishi openhab
Last synced: 12 days ago
JSON representation
MelCloud binding for Openhab.
- Host: GitHub
- URL: https://github.com/lucacalcaterra/org.openhab.binding.melcloud
- Owner: lucacalcaterra
- Created: 2019-01-31T18:23:05.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-06-11T22:16:02.000Z (11 months ago)
- Last Synced: 2025-03-14T14:05:12.054Z (2 months ago)
- Topics: air-conditioner, domotic, melcloud, mitsubishi, openhab
- Language: Java
- Homepage:
- Size: 2.12 MB
- Stars: 10
- Watchers: 7
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### N.B.: For developers who wants contribute not use this repo. Use Instead the openhab2-fork at https://github.com/lucacalcaterra/openhab2-addons
# MELCloud Binding
This is an openHAB binding for Mitsubishi MELCloud (https://www.melcloud.com/).
Installing this binding you can control your Mitsubishi devices from openHAB without accessing the MELCloud App and benefiting from all openHAB automations.
## Supported Things
Supported thing types
* melcloudaccount (bridge)
* acdevice
A bridge is required to connect to your MELCloud account.
## Discovery
Discovery is used _after_ a bridge has been created and configured with your login information.
1. Add the binding
2. Add a new thing of type melcloudaccount and configure with username and password
3. Go to Inbox and start discovery of A.C. devices using MELCloud Binding
4. A.C. devices should appear in your inbox
Binding support also manual thing configuration by thing files.
## Thing Configuration
In order to manually create a thing file and not use the discovery routine you will need to know device MELCloud device ID.
This is a bit difficult to get. The easiest way of getting this is enable debug level logging of the binding or discovery devices by the binding (discovered device can be removed afterwards).
MELCloud account configuration:
| Config | Mandatory | Description |
|----------|-----------|-----------------------------------------|
| username | x | Email address tied to MELCloud account. |
| password | x | Password to MELCloud account. |
| language | | Language ID, see table below. |
| LanguageId | Language |
|-------------|-------------------|
| 0 | English (default) |
| 1 | Bulgarian |
| 2 | Czech |
| 3 | Danish |
| 4 | German |
| 5 | Estonian |
| 6 | Spanish |
| 7 | French |
| 8 | Armenian |
| 9 | Latvian |
| 10 | Lithuanian |
| 11 | Hungarian |
| 12 | Dutch |
| 13 | Norwegian |
| 14 | Polish |
| 15 | Portuguese |
| 16 | Russian |
| 17 | Finnish |
| 18 | Swedish |
| 19 | Italian |
| 20 | Ukrainian |
| 21 | Turkish |
| 22 | Greek |
| 23 | Croatian |
| 24 | Romanian |
| 25 | Slovenian |
A.C. device configuration:
| Config | Mandatory | Description |
|-----------------|-----------|---------------------------------------------------------------------------------------|
| deviceID | x | MELCloud device ID. |
| buildingID | | MELCloud building ID. If not defined, binding tries to find matching id by device ID. |
| pollingInterval | | Refresh time interval in seconds for updates from MELCloud. Defaults to 60 seconds. |
## Channels
A.C. device channels
| Channel | Type | Description | Read Only |
|---------------------|----------|----------------------------------------------------------------------------|-----------|
| power | Switch | Power Status of Device. | False |
| operationMode | Number | Operation mode: 1 = Heat, 2 = Dry, 3 = Cool, 7 = Fan, 8 = Auto. | False |
| setTemperature | Number | Set Temperature: Min = 10, Max = 40. | False |
| fanSpeed | Number | Fan speed: 0 = Auto, 1 = 1, 2 = 2, 3 = 3, 4 = 4, 5 = 5. | False |
| vaneHorizontal | Number | Vane Horizontal: 0 = Auto, 1 = 1, 2 = 2, 3 = 3, 4 = 4, 5 = 5, 12 = Swing. | False |
| vaneVertical | Number | Vane Vertical: 0 = Auto, 1 = 1, 2 = 2, 3 = 3, 4 = 4, 5 = 5, 7 = Swing. | False |
| roomTemperature | Number | Room temperature. | True |
| lastCommunication | DateTime | Last Communication time when MELCloud communicated to the device. | True |
| nextCommunication | DateTime | Next communication time when MELCloud will communicate to the device. | True |
| offline | Switch | Is device in offline state. | True |
| hasPendingCommand | Switch | Device has a pending command(s). | True |
## Full Example for items configuration
**melcloud.things**
```
Bridge melcloud:melcloudaccount:myaccount "My MELCloud account" [ username="[email protected]", password="xxxxxx", language="0" ] {
Thing acdevice livingroom "Livingroom A.C. device" [ deviceID=123456, pollingInterval=60 ]
}
```
**melcloud.items**
```
Switch power { channel="melcloud:acdevice:myaccount:livingroom:power" }
Number operationMode { channel="melcloud:acdevice:myaccount:livingroom:operationMode" }
Number setTemperature { channel="melcloud:acdevice:myaccount:livingroom:setTemperature" }
Number fanSpeed { channel="melcloud:acdevice:myaccount:livingroom:fanSpeed" }
Number vaneHorizontal { channel="melcloud:acdevice:myaccount:livingroom:vaneHorizontal" }
Number vaneVertical { channel="melcloud:acdevice:myaccount:livingroom:vaneVertical" }
Number roomTemperature { channel="melcloud:acdevice:myaccount:livingroom:roomTemperature" }
DateTime lastCommunication { channel="melcloud:acdevice:myaccount:livingroom:lastCommunication" }
DateTime nextCommunication { channel="melcloud:acdevice:myaccount:livingroom:nextCommunication" }
Switch offline { channel="melcloud:acdevice:myaccount:livingroom:offline" }
Switch hasPendingCommand { channel="melcloud:acdevice:myaccount:livingroom:hasPendingCommand" }
```