MiLight/LimitlessLED/Easybulb Plugin for Homebridge: https://github.com/nfarina/homebridge
npm install homebridge-milightUses the node-milight-promise library which features some code from
applamp.nl and uses other details from http://www.limitlessled.com/dev/
npm install -g homebridgenpm install -g homebridge-milightSee the Homebridge installation section for more details.
Example config:
``
"platforms": [
{
"platform":"MiLight",
"name":"MiLight",
"bridges": [
{
"ip_address": "10.0.1.25",
"version": "v6",
"lights": {"fullColor": ["Kitchen",null,"Bedroom","Hallway"],
"rgbw": ["Living Room", "Downstairs Bedroom"]},
"repeat": 1,
"delay": 100
},
{
"ip_address": "10.0.1.26",
"lights": {"white": ["Dining Room", "Den"],
"rgbw": ["Master Bedroom"]}
}
]
}
]
Where the parameters are:
* platform: This must be "MiLight", and refers to the name of the platform as defined in the module (required)
* name: The display name used for logging output by Homebridge. Could be "MiLight" or "LimitlessLED" or whatever you'd like to see in logs and as the Manufacturer
* bridges: An array of the bridges that will be configured by the platform, containing the following keys
* ip_address: The IP address of the WiFi Bridge (optional - default: 255.255.255.255 aka broadcast to all bridges, but a specific IP address is recommended)
* port: Port of the WiFi bridge (optional - default 8899)
* version: What version of the bridge this is. Set "v6" for latest bridge, "v3" for 2-byte UDP messages, or "v2" for 3-byte UDP messages (optional - default "v2")
* delay: Delay in ms between commands sent over UDP. May cause heavy command queuing when set too high. Try decreasing to improve performance (optional - default 100)
* repeat: Number of times to repeat the UDP command for better reliability. For rgb or white bulbs, this should be set to 1 so as not to change brightness/temperature more than desired (optional - default 3)
* use8Zone: Boolean value, only used when there are more than 4 fullColor bulbs added to a v6 bridge. This should function without this property being set, but an info message is printed out as not all bridge/bulb firmwares support this.
* lights: An object whose properties are one of "fullColor", "rgbw", "rgb", "bridge" (the built-in light in the iBox 1), or "white", depending on the type of bulb, and whose value is an array of the names of the zones, in order, 1-4. Use null if a zone is skipped. RGB lamps and the bridge light can only have a single zone. (required)
#Bridge Versions
The version referred to in the config above matches the versioning used by limitlessled.com. They refer to the "v6" bridge as the bridge released in late 2016. The original manufacturer, Futlight, refers to the new version of the bridge as the "iBox". The iBox1 is the version with a built-in light (configured as "bridge" bulb type), while the iBox2 is a similar design to the previous bridges. The newer bridge is also, confusingly, referred to as bridge "3.0" by some sellers. Regardless, all of the iBox/3.0 variants should be configured as version "v6".
This plugin previously used 3-byte UDP commands as the default, which the "v1" and "v2" bridges required, but "versions" 3-5 all supported a shorter 2-byte sequence which some users may see better results with. This command set also uses an expanded brightness range for RGBW bulbs, which hasn't been confirmed to actually make any difference.
Some of the iBox bridges have also been shipping set to only listen for TCP commands. This plugin uses only UDP commands. To make it work, you will need to log in to the web admin interface of the bridge (Username: admin, Password: admin), go to the "Other Setting" section, and change the "Network Parameter" to UDP.
, fullColor, bridge, or white bulb to between 1% and 5% will set it to "night mode", which is dimmer than the normal lowest brightness setting
* A brightness setting of 0% is equivalent to sending an Off command
* white and rgb bulbs don't support absolute brightness setting, so we keep track of the last brightness value set and send the appropriate number of up/down commands to get to the new value
* Implemented warmer/cooler for white lamps in the same way as brightness
* There is only one-way communication with the bulbs, so when restarting Homebridge, it's a good idea to send a brightness and colour command to all bulbs to get them in sync, and then refrain from using any external (to Homebridge) apps to control the bulbs.Troubleshooting
The node-milight-promise library provides additional debugging output when the MILIGHT_DEBUG environmental variable is set. To get maximum debugging output from this plugin, start Homebridge like so:
MILIGHT_DEBUG=true homebridge -DChangelog
$3
* Set initial color temperature value within the defined range to squelch errors$3
* Hotfix for Homebridge plugin registration (Thanks @fkistner!)$3
* Fix issues with 8 zone fullColor bulbs not being sent the correct commands
* Bump minimum Homebridge version to 0.4.27 so we can be sure that the color temperature characteristic will be there, and we can simply modify min/max values
* Basic error handling of connection promise from node-milight-promise
* Ability to pass through all node-milight-promise options (, sendKeepAlives, sessionTimeout)$3
* Switched to node-milight-promise ^0.3.0$3
* Make sure we're enforcing the new maximum of 8 zones for v6/fullColor$3
* Add support for 8-zone control of fullColor bulbs on v6 bridges (#39)
* Support multiple bridges on the same IP with different ports (#34) (thanks @lundberg)
* Update node-milight-promise to use master branch$3
* Implemented colour temperature control with new official HomeKit characteristic. Not supported by all HomeKit apps
* RGBWW/fullColor bulbs should be set to their last colour temperature value when going in to white mode
* Fixed bug where bulb set in night mode might not be addressed again correctly for subsequent commands
* Possible fix for RGBWW/fullColor bulbs not getting correct colours set depending on command order
* Update node-milight-promise dependancy to ^0.2.2$3
* Upgrade node-milight-promise dependancy to ^0.1.1 and use its new saturation inversion option$3
* Removed support for legacy config formats, and cleaned up code
* Track the last bulb addressed by a bridge so we can skip sending the "on" command to it. Should speed things up a bit
* Invert the saturation value sent to fullColor bulbs so things work as expected$3
* Fix command sending to the bridge light
* Further tweaks to the logic of setting/resetting hue/saturation/white mode
* This is likely the last release before an upcoming 1.0 release that will remove support for old config formats. Please check the Homebridge log to see if your configuration generates any warnings, and update your configuration as required.$3
* Finally fix the bug where colour/white mode was not set correctly when changing hue/saturation
* Added support for "bridge" bulb type to control the internal bulb on v6 bridges$3
* Fixes destined for 0.1.7 were never actually pushed.$3
* Fix bug setting hue correctly on v6 bridges$3
* New config format where the bridges key actually defines one bridge now, with a lights` key that defines a type of light and then name of the bulbs. Still backwards compatible with the old format, and actually still backwards compatible with an even older config version that only supported one bridge per platform definition. Both of these older configuration formats will be removed in 1.0.0.