1.0.2 • Published 4 years ago

homebridge-ledenet v1.0.2

Weekly downloads
8
License
MIT
Repository
github
Last release
4 years ago

homebridge-ledenet

Latest Version Total Downloads License

WIP homebride platform for LEDENET devices (MagcHome) with full support for RGB+CCT/WWCW.

Devices

The following devices have been tested and confirmed to work:

Installation

  1. Homebridge
  2. npm i -g homebridge-ledenet
  3. Add platform to your config file

Configuration

In order to use this plugin, you’ll need to add the following JSON object to your Homebridge config file:

{
  "platform": "ledenet",
  "name": "ledenet",
  "accessories": [
    {
      "name": "lightstrip",
      "ip": "10.0.1.100"
    }
  ]
}
Config KeyDescriptionRequired
platformHomebridge Platform name.This value should always be ledenet.Y
nameThe name of this platform within Homebridge.This is mainly used for logs and can be any value you want.N
accessoriesList of LEDENet devies this plugin should expose.See the Accessories section for more information.Y

Accessories

The accessories config object allows you to customize how your devices appear and behave within HomeKit.

{
  "platform": "ledenet",
  "name": "ledenet",
  "accessories": [
    {
      "name": "lightstrip",
      "ip": "10.0.1.100",
      "cct": {
        "warmTemp": 3000,
        "coolTemp": 6000
      }
    }
  ]
}
Config KeyDescription
nameThe default name this accessory should have in HomeKit.
ipThe IP address of the controller.
cct
cct.warmTempThe color temperature of your warm white LED. Defaults to 3000.
cct.coolTempThe color temperature of your cool white LED. Defaults to 6000.

Status

Seems to work fully for RGB and CCT using both WW/CW LEDs.

TODO:

  • Need to support auto-switching to CCT when RGB values get into white ranges
  • Support other devices:
    • RGB
    • RGBW
    • WWCW

Development

Running Homebridge with this plugin:

yarn testharness

Inspecting packets between the MagicHome app and the device to reverse engineer the LEDENET protocol:

yarn util proxy-discovery # This allows the MagicHome app to detect your computer as a device
yarn util proxy-cmds # This proxies commands between your compiter and your LEDENET device