https://github.com/mongoose-os-apps/mel-ac-homekit
Mitsubishi Electric AirCo (conditioner) and ATW (heat pump) control for HomeKit
https://github.com/mongoose-os-apps/mel-ac-homekit
airco cn105 conditioner homekit hvac mitsubishi
Last synced: 3 days ago
JSON representation
Mitsubishi Electric AirCo (conditioner) and ATW (heat pump) control for HomeKit
- Host: GitHub
- URL: https://github.com/mongoose-os-apps/mel-ac-homekit
- Owner: mongoose-os-apps
- License: apache-2.0
- Created: 2020-11-05T21:09:17.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-10T18:27:46.000Z (over 1 year ago)
- Last Synced: 2025-04-23T21:44:24.382Z (3 days ago)
- Topics: airco, cn105, conditioner, homekit, hvac, mitsubishi
- Language: C
- Homepage:
- Size: 6.78 MB
- Stars: 57
- Watchers: 10
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Mitsubishi Electric Air-Co control for HomeKit
Add your Air Conditioner or the ATW unit to HomeKit smarthome infrastructure. Use `Siri` voice control and all the scripting potential from `Apple`
## Supported platforms
* `ESP8266`
* `ESP32`
## Dependencies
* [MEL-AC library](https://github.com/mongoose-os-libs/mel-ac) - the `Mitsubishi Electric` protocol implementation
* [HomeKit ADK library](https://github.com/mongoose-os-libs/homekit-adk) which is port of the official [Apple HomeKit ADK](https://github.com/Apple/HomeKitADK/)
* [WiFi Setup library](https://github.com/d4rkmen/wifi-setup) - Web-based WiFi setup captive portal
## Accessory design
### Identification
Build in LED blinks during the identification
### HomeKit services
* `Thermostat` - used to control `Heat`, `Cool`, `Auto` mode and Power ON / OFF
* `Fan` - control the fan speed
* `Vane horizontal` - (not visible in Home App yet, use Eve) control up-down vane
* `Vane vertical` - (not visible in Home App yet, use Eve) control left-right vane
* `Fan mode` - turns `Fan only` mode, `Thermosat` is disabled for this
* `Dry mode` - turns `Dry` mode, `Thermosat` is disabled for this
HomeKit `Status Active` reporting the HVAC interface connected / disconnected
`Mitsubishi Electric` protocol limitations:
* HomeKit widget changes apply time up to 2 seconds
* HVAC parameter or room temperature changes sync time up to 8 seconds.
### LED indication
* LED blink on remote params change `app.blink_ms_sync`
* LED blink on new params apply `app.blink_ms_update`
* LED blink on room temp change `app.blink_ms_room`
## Setup
Using the [Mongoose OS](http://mongoose-os.com) framework:
```
$ mos build
$ mos flash
```
## WiFI settings
Connect WiFi access point name `MEL-XXXX` password `macdrive`, select home network and save credentials
## Factory reset
Hold a button for factory reset. This will remove WiFi settings, HAP server status.
Configuration:
```yml
- ["pins.button", "i", -1, {title: "Button GPIO pin"}]
- ["pins.button_hold_ms", "i", 5000, {title: "Button hold time for reset"}]
- ["pins.button_pull_up", "b", true, {title: "Button pull up or down"}]
```
## ToDo
Index page for Web GUI holding the device information and factory reset feature
## Known issues
`ESP32` platform works well with `mos` tool `2.19.1`, but not with newer. The issue is related to UART driver and still under investigation
## Copyrights
* [d4rkmen](https://github.com/d4rkmen)
* [Deomid "rojer" Ryabkov](https://github.com/rojer)
* The HomeKit ADK Contributors