jamesrodda/homebridge-mihomegateway

A homebridge plugin for connecting the MiHome gateway to HomeKit

MiHome Gateway Platform Plugin

Energenie MiHome gateway plugin for Homebridge.

Installation

1. Install Homebridge using: npm install -g homebridge
2. Install this plugin using: npm install -g homebridge-mihomegateway
3. Update your configuration file. See the sample below.

Updating

• npm update -g homebridge-mihomegateway

Configuration

Currently, the setup is a bit convoluted - sorry about that!

This will all be automated in upcoming releases but for now a bit of manual work is required.

Sample Configuration

"platforms": [{
    "name": "MiHome Gateway",
    "platform": "MiHomeGateway",
    "username": "",
    "password": ""
}]

• name - a friendly label for the MiHome gateway
• platform - must be set to MiHomeGateway
• username - call the register user service to create a new api user
• password - the password you used to register with (your password is only used for one initial authentication call - subsequent calls will use the api key obtained during authentication)
• token - [optional] the api key token obtained during authentication
• baseUrl - [optional] an override for the MiHome API URL

TODO

• Add additional device types (currently only supports light switches)
• Automate registration

Credits

• Adrian Rudman for homebridge-platform-wemo which I based this plugin on

homebridge-mihomegateway's Issues

Error 503 in event log for all Mihome devices

[05/08/2021, 20:48:27] [MiHomeGateway] Error getting subdevice information: Living Room Lamp Unexpected statusCode from getSubDeviceInfo: 503

Support for sockets

Is it possible for this to support plug sockets, or any way to build this in?

Adding a collabrator

Hi James,
I am a big fan of this project, however I would like to make some changes, including a potential rewrite over the summer. I personally use this on my own homebridge setup but everytime I undergo a reinstallation I have to make some changes including some more recent commits.

My proposition is to make me a write collabrator on the GitHub and NPM so that I can independently push some new changes.

Best Wishes,
Christopher Nethercott

Receive Accessory State From API

The accessories' state can be controlled via non HomeKit apps, Alexa, etc. So it would be useful to get the accessory state periodically to reflect its true status. I can't see any web hooks available, but push notifications could potentially be utilised.

MiHome relays

MiHome relays are the same as MiHome switches, so adding:

  switch (device.device_type) {
    case "light":
      serviceType = Service.Switch;
      break;
    case "relay":
      serviceType = Service.Switch;
      break;
default:

works great :)

Cannot update reachability on non-bridged accessory! with latest version of Homebridge v1.0.2 (2020-04-28)

I have just updated my Homebridge server and now the system errors whenever I boot with the homebridge-mihomegateway config included

[4/28/2020, 16:22:28] Error: Cannot update reachability on non-bridged accessory!
at Accessory._this.updateReachability (/usr/lib/node_modules/homebridge/node_modules/hap-nodejs/src/lib/Accessory.ts:399:13)
at PlatformAccessory.updateReachability (/usr/lib/node_modules/homebridge/src/platformAccessory.ts:124:34)
at MiHomeAccessory.updateReachability (/usr/lib/node_modules/homebridge-mihomegateway/index.js:261:18)
at new MiHomeAccessory (/usr/lib/node_modules/homebridge-mihomegateway/index.js:238:8)
at MiHomeGateway.addAccessory (/usr/lib/node_modules/homebridge-mihomegateway/index.js:107:38)
at MiHomeGateway.addDevice (/usr/lib/node_modules/homebridge-mihomegateway/index.js:74:10)
at MiHomeGateway. (/usr/lib/node_modules/homebridge-mihomegateway/index.js:57:16)
at Request.self.callback (/usr/lib/node_modules/homebridge-mihomegateway/node_modules/request/request.js:185:22)
at Request.emit (events.js:310:20)
at Request. (/usr/lib/node_modules/homebridge-mihomegateway/node_modules/request/request.js:1154:10)

Automate registration

@jamesrodda How would you like this to be implemented?