Homebridge Broadlink RM Community

About this fork

I am working on upgrades to the accessory specifications in this repository. For starters I am focused on the the fan, air-conditioners and heater accessories to help improve the user experience of the devices like portable ACs, Lasko tower fans and tower heaters, etc.

I eventually would like to add multiple contibuters who can review and integrate PRs hence the "community" tag here so more people can collectively extend the accessories.

If you want to use this fork, use this command:

npm i -g homebridge-broadlink-rm-community

Introduction (Original)

Welcome to the Broadlink RM Mini and Broadlink RM Pro plugin for Homebridge.

This is a fork of the [original plugin by Luke Rhodes] (https://github.com/lprhodes/homebridge-broadlink-rm) This plugin allows you to control your RM Mini and RM Pro with HomeKit using the Home app and Siri.

Like this plugin?

Please consider testing it and if possible contributing to the code base. This project is built on top of the labor of many folks so please feel free to show your support to them as well.

Thank you!

Documentation

Full documentation is extended from the original that can be found here.

Updates to accessories

Fan Accessory

Supports step size property that creates graceful increments for fan speed changes

Add under the data section of the fan accessory in config.json as shown in the config-sample.json | key | description | example | default | |--|--|--|--| | stepSize | Increments of fan speed. This will update Home app UI so that fan speed increases in steps. If your fan support 4 speeds and the step size should be 100/4 = 25. | 25 | 1 |

Support for combined fan speed and swing modes - Some fans like Lasko tower fans with remotes that have display have unique hex codes for combination of each speed and swing mode

config.json { "name": "fan", "type": "fan", "swingOn": "on", "swingOff": "off", "data": { "fanSpeed50": { "swingOn": "26008a002828123f282a...", "swingOff": "26008a002828123f282a..." }, } }

Thanks

Thanks to @lprhodes (https://github.com/lprhodes/homebridge-broadlink-rm), @kiwi-cam (https://github.com/kiwi-cam/homebridge-broadlink-rm), @tattn (https://github.com/tattn/homebridge-rm-mini3), @PJCzx (https://github.com/PJCzx/homebridge-thermostat) @momodalo (https://github.com/momodalo/broadlinkjs) whose time and effort got me started.