GithubHelp home page GithubHelp logo

jfmennedy / heatpump Goto Github PK

View Code? Open in Web Editor NEW

This project forked from swicago/heatpump

0.0 0.0 0.0 464 KB

Arduino library to control Mitsubishi Heat Pumps via connector cn105

License: GNU General Public License v3.0

C++ 97.26% C 2.74%

heatpump's Introduction

Support Chat here -> Join the chat at https://gitter.im/Mitsubishi-Heat-Pump <-Support Chat here

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

You can make the library automatically send new settings to the heat pump by calling enableAutoUpdate(). When auto update is enabled the call to update() in the above example is not necessary, the new settings will be sent to the heat pump on the next call to sync() in loop().

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();
}

By default the library ignores changes made from other sources (usually, the IR remote) and reverts them the next time sync() is called. This is the intendend behavior when the heat pump is fully controlled by automation.

If you want to also allow manual control and allow the library to update its settings from the current state of the heat pump you need to call enableExternalUpdate(). This will also enable automatic updates.

Support for installer settings/functions

Important: This is only tested on PVA (P-Series air handler) units and is not known to work on any other models.

You can refer to page 6 of this document to see the generic list of functions: https://www.mitsubishitechinfo.ca/sites/default/files/Installation_Manual_69-2426-01_0.pdf. Note that what each setting does is model specific. For example, this document lists the available codes and values for PVAs: https://www.mitsubishitechinfo.ca/sites/default/files/IM_PVA_A12_42AA7_PA79D213H09.pdf, page 22.

heatpumpFunctions functions = hp.getFunctions();

heatpumpFunctionCodes codes = functions.getAllCodes();
for (int i = 0; i < MAX_FUNCTION_CODE_COUNT; ++i) {
  if (codes.valid[i]) {
    int code = codes.code[i];
    int value = functions.getValue(code);
    // handle value
  }
}


if (!functions.setValue(code, value)) {
  // handle error
}

if (!hp.setFunctions(functions)) {
  // handle error
}

It is recommended to call getFunctions() every time when you need to make a change to the values in order to get a fresh heatpumpFunctions. Otherwise you might accidentally write out stale values and overwrite changes that might have happened through other sources.

Callbacks

Instead of manually checking settings changes on each loop, you can set callback functions to be called when the current heat pump status or settings change:

void hpSettingsChanged() {
  // ...
}

void hpStatusChanged(heatpumpStatus currentStatus) {
  // ...
}

void setup() {
  hp.setSettingsChangedCallback(hpSettingsChanged);
  hp.setStatusChangedCallback(hpStatusChanged);

  hp.connect(&Serial);
}

The callbacks will be called as necessary by the sync() method.

You can see this in use in the MQTT example.

Contents

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

Installation

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/

Wayback machine link as the site no longer exists: https://web.archive.org/web/20171007190023/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-3.0.txt

heatpump's People

Contributors

akamali avatar claybar avatar david-yam avatar dgoodlad avatar dmcc avatar dzungpv avatar emaijala avatar f43ry avatar geoffdavis avatar hawkefly avatar janjoh avatar jlynx avatar kayno avatar lekobob avatar micampe avatar miguelangel-nubla avatar moxified avatar noblekangaroo avatar notlaforge avatar prashker avatar relevante avatar schotime avatar sethkinast avatar shampeon avatar smichtch avatar swicago avatar unixko avatar unreality avatar uronito avatar yellowsub avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.