Homebridge Kumo

Kumo device support for Homebridge.

homebridge-kumo is a Homebridge plugin that makes Kumo-enabled devices available to Apple's HomeKit smart home platform. This plugin enables control of Mitsubishi's kumo cloud and currently supports Minisplit units via the offical WiFi accesory.

Why use this plugin for Kumo cloud support in HomeKit?

In a similar vein to homebridge-myq2, this plugin aims to keep user configuration to a minimum. This plugin will dynamically add (but not yet remove) devices found in your Kumo account. This way the only configuration needed is your username and password for the Kumo cloud.

Features

• Easy configuration - all you need is your username and password to get started. The defaults work for the vast majority of users.

• Automatic detection and configuration of multiple Kumo devices. By default - all of your supported Kumo devices are made available in HomeKit.

How you can contribute and make this plugin even better

As far as I can tell the Kumo API is undocumented and implementing this plugin took many hours of tweaking, reverse engineering, and a lot of trial and error. This work stands on the shoulders of other Kumo (especially pykumo) and other similar API projects out there.

I would love to support more types of Kumo devices. I have only tested this plugin with my own Mitsubishi split-system heat pump (minisplit) Model MSZ-FH12NA coupled with a PAC-USWHS002-WF-2 WiFi module.

If you have these devices and would like to contribute, please open an issue, label it as a enhancement, and let's figure out how to make this plugin even better! Bonus points if you like puzzles and lots of debugging output. 😄

Installation

If you are new to Homebridge, please first read the Homebridge documentation and installation instructions before proceeding.

If you have installed the Homebridge Config UI, you can intall this plugin by going to the Plugins tab and searching for homebridge-kumo and installing it.

If you prefer to install homebridge-kumo from the command line, you can do so by executing:

sudo npm install -g homebridge-kumo

Changelog

v.1.1.1 included support for multiple "sites" on kumo cloud. All devices are currently incorporated into Homebridge. This could be easily customized in the future if multiple homes were controlled by a single kumo account. v.1.1.x includes control via direct IP connection from Homebridge to device. This is much faster than via the kumo cloud API. The kumo cloud is still queried on start up for list of devices and information needed to configure them.

Plugin Configuration

If you choose to configure this plugin directly instead of using the Homebridge Configuration web UI, you'll need to add the platform to your config.json in your home directory inside .homebridge.

"platforms": [{
    "platform": "Kumo",
    "username": "email@email.com",
    "password": "password",
    "directAccess": true
}]

For most people, I recommend using Homebridge Configuration web UI to configure this plugin rather than doing so directly. It's easier to use for most users, especially newer users, and less prone to typos, leading to other problems.

Credits

This plugin used many cues from homebridge-myq2 for plugin structure and homebridge-kumo for getting started with the Kumo API. In v.1.1, I have incorporated information from pykumo and homebridge-kumo-local to allow direct IP and rapid control of devices on the network.