# SwiCago/HeatPump

Arduino library to control Mitsubishi Heat Pumps via connector cn105

Repository: https://github.com/SwiCago/HeatPump
Canonical: https://ross.abutalabs.com/products/heatpump
Language: C++
License: GPL-3.0
License Family: copyleft
Topics: heatpump, arduino-library, arduino, esp8266, mitsubishi, airconditioning, mqtt, home-assistant, wifi, serial, kumocloud, melcloud, c-library, hvac, openhab
Last push: 2024-09-25T21:24:28+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3524, "days_push": 707, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1017, forks 242 (observed 2026-08-28T04:03:14.752498+00:00)

## What it is
An Arduino library for controlling Mitsubishi heat pumps over the CN105 connector using serial communication. It lets microcontrollers like ESP8266/ESP32 read and set heat pump settings, room temperature, and installer functions, commonly bridged to MQTT and home automation platforms.

## Use cases
- control a Mitsubishi heat pump from Home Assistant
- read room temperature from a mini-split via CN105
- integrate a heat pump with MQTT and OpenHAB
- replace the KumoCloud remote control with local WiFi control
- automate HVAC settings with an ESP8266 or ESP32
- send and read installer function codes on P-series air handlers

## When to choose
- you have a Mitsubishi mini-split or heat pump with a CN105 connector and want local, cloud-free control
- you are building a DIY ESP-based thermostat or automation bridge
- you want to integrate the unit with Home Assistant, OpenHAB, or MQTT

## When to avoid
- your heat pump is not a Mitsubishi model or lacks a CN105 connector
- you want a ready-made consumer app rather than writing Arduino firmware
- you need installer function support on units other than PVA/P-series, which is untested

## Facets
- artifact type: library
- maturity: active
- function: iot, sdk, workflow-automation
- domain: iot
- platform: iot, embedded, cpp
- tags: mitsubishi, heat-pump, cn105, hvac-control, mqtt, home-assistant, serial-protocol, esp32, hvac, home-automation, esp8266

## Member repositories
- SwiCago/HeatPump (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:14.752498+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:11:09.825573+00:00, confidence not recorded.
  - readme: https://github.com/SwiCago/HeatPump (fetched 2026-08-28T04:03:14.752498+00:00, sha ba1114542e3d)
- Data as of 2026-08-30T08:39:29.467469+00:00.