/HeatPump

Arduino library to control Mitsubishi Heat Pumps via connector cn105

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Join the chat at https://gitter.im/Mitsubishi-Heat-Pump

HeatPump

Arduino library to control Mitsubishi Heat Pumps via connector CN105.

Quick start

Controlling the heat pump

HeatPump hp;
hp.connect(&Serial);

heatpumpSettings settings = {
    "ON",  /* ON/OFF */
    "FAN", /* HEAT/COOL/FAN/DRY/AUTO */
    26,    /* Between 16 and 31 */
    "4",   /* Fan speed: 1-4, AUTO, or QUIET */
    "3",   /* Air direction (vertical): 1-5, SWING, or AUTO */
    "|"    /* Air direction (horizontal): <<, <, |, >, >>, <>, or SWING */
}; 

hp.setSettings(settings);
// OR individual settings
// hp.setModeSetting("COOL");

hp.update();

See heatPump_test.ino

Getting updates from the heat pump

void setup() {
  HeatPump hp;
  hp.connect(&Serial);
}

void loop() {
  hp.sync();

  /* get settings from heatpump, including room temperature in settings.roomTemperature */
  heatpumpSettings settings = hp.getSettings();
}

Contents

  • sources
  • sample usage code
  • Demo circuit using ESP-01

Installation

  • PULL or download zip.
  • Move contents into Arduino library directory
  • Restart IDE, samples should be avaliable
  • NOTE: Requires arduino json 6, older commits before 20190505 support json 5.

Notes

  • Tested with ESP8266
  • Tested with Arduino Micro Pro / Arduino Nano
  • Tested with Mitsubishi HeatPump MSZ-FH/GE(wall units) and SEZ-KD (ducted units) complete list

Demo Circuit

Parts

Parts required to make a CN105 female connector

Other part suggestions

Special thanks

... to Hadley in New Zealand. His blog post, describing baud rate and details of cn105, Raspberry Pi Python code:

https://nicegear.co.nz/blog/hacking-a-mitsubishi-heat-pump-air-conditioner/

License

Licensed under the GNU Lesser General Public License. https://www.gnu.org/licenses/lgpl.html