Skip to content

Latest commit

 

History

History
41 lines (32 loc) · 3.04 KB

README.md

File metadata and controls

41 lines (32 loc) · 3.04 KB

MHI-AC-Ctrl

Reads and writes data (e.g. power, mode, fan status etc.) from/to a Mitsubishi Heavy Industries (MHI) air conditioner (AC) via SPI controlled by MQTT. The AC is the SPI master and the ESP8266 is the SPI slave. The program has a draft status and your input is welcome.

Attention:

⚠️ You have to open the indoor unit to have access to the SPI. Opening of the indoor unit should be done by a qualified professional because faulty handling may cause leakage of water, electric shock or fire! ⚠️

Prerequisites:

For use of the program you have to connect your ESP8266 (I use a LOLIN(WEMOS) D1 R2 & mini with 80 MHz) via a cable connector to your air conditioner. This has to be a split device (separated indoor and outdoor unit). I assume that all AC units of the type "SRK xx ZS-S" / "SRC xx ZS-S" are supported. I use the indoor unit SRK 35 ZS-S and the outdoor unit SRC 35 ZS-S. User reported that also SRK20ZSA-W and SRK xx ZSX-S are supported.

Installing:

Hardware:

The ESP8266 is powered from the AC via DC-DC (12V -> 5V) converter. The ESP8266 SPI signals SCL (SPI clock), MOSI (Master Out Slave In) and MISO (Master In Slave Out) are connected via a voltage level shifter 5V <-> 3.3V with the AC. Direct connection of the signals without a level shifter could damage your ESP8266! More details are described here.

Software:

The program uses the MQTT client library from Nick O'Leary (knolleary). Thank you Nick - great job! Please check his GitHub page to see how to install it. Create a sub-directory "MHI-AC-Ctrl" and copy the files from the src directory in your MHI-AC-Ctrl sub-directory. Adapt ssid, password in MHI-AC-Ctrl.h. Further configuration options are described in MQTT.md. Currently ArduinoOTA is used for remote upload.

In a previous version (see here) I used the Hardware-SPI of the ESP8266. But since the SPI documentation of ESP8266 is poor, I decided to switch to a Software based SPI. This Software based SPI is reliable and the performance of the ESP8266 is sufficient for this use case. If you have problems with the SW please check the serial debug output.

MQTT

The control via MQTT is described here

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

The coding of the SPI protocol of the AC is a nightmare. Without rjdekker's MHI2MQTT I had no chance to understand the protocol! Unfortunately rjdekker is no longer active on GitHub. He used an Arduino plus an ESP8266 for his project.