/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

Primary LanguageC++MIT LicenseMIT

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. Users reported that additionally the following models are supported:

  • SRF xx ZJX-S1
  • SRK xx ZJ-S
  • SRK xx ZM-S
  • SRK xx ZS-S
  • SRK xx ZJX-S
  • SRK xx ZJX-S1
  • SRK xx ZSA-W
  • SRK xx ZSX-S
  • SRK xx ZSX-W

If you find out that also other models are supported that are not listed here, please give feedback so that I can expand the list.

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 in Hardware.md.

Software:

The program uses the following libraries

and optionally you need for the use of an external temperature sensor DS18x20 the libraries

Please check the GitHub pages to see how to install them (usually via tools -> libraries).

Create a sub-directory "MHI-AC-Ctrl" and copy the files from the latest release src directory in your MHI-AC-Ctrl sub-directory. You could also use the recently updated version in the src folder but with the risk that it is more unstable. The configuration options are described in SW-Configuration.md.

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. In case of problems please check the serial debug output first.

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. Also thank you very much on the authors and contributors of MQTT client, ArduinoOTA, OneWire and DallasTemperature libraries.