HS4 MiLight Plugin for HomeSeer Installation Guide

HS4 MiLight Plugin for HomeSeer

Introduction

Thank you for using the MiLight Plugin for HS4! This plugin can be used to locally control MiLight LED lights via one or more MiLight W-Fi controllers. Please see Requirements for more info.
This is my second plugin for HS4. My other plugin is the Horizon Remote Plugin.
I have tested this plugin thoroughly, but if you find bugs anyway, please let me know.

Requirements

To use this plugin, you will need the following:

• HomeSeer HS4. The plugin has only been tested on Windows, but there is no reason why it should not work on Linux.
• A MiLight Wi-Fi controller and at least 1 light (a bulb, downlight, LED strip controller & strip, etc.). Other compatible systems should be LimitlessLED, AppLamp, EasyBulb, FutLight, AppLight, LEDme, Dekolight Rocket LED, s.LUCE, iLight, iBulb, Kreuzer, Home-Wize, ThorFire, SureCart. This list was composed with information collected from various internet sites. Please let me know if you think any brand does not work, so I can remove it from the list. Also, for this reason I strongly recommend to make use of the trial period before you buy the plugin.
• The controller has to be connected to the same Local Area Network (LAN) as your HomeSeer system. Follow the manual of the Wi-Fi controller to connect it to your Wireless LAN, if you haven’t done that already.
• You will need to know its local IP (IPv4) address. It’s useful if you can make sure the IP will not change in future, for instance by fixing it. See you router manual on how to do this.

Installation

1. Install and activate the plugin like any other plugin. If you’re new to HS4, here is how:
   • Go to your HomeSeer Web Control page.
   • Use the Plugin dropdown and choose Add.
   • Use the (2nd) Search bar, or scroll to MiLight Plugin.
   • Choose Install.
   • In Plugins > Installed use the toggle to turn on the plugin.
2. Configure:
   • Go to Plugins > MiLight Plugin > Add Wi-Fi controller.
   • Follow the steps:
   • Enter the IPv4 IP address of your MiLight Wi-Fi controller and choose Continue.
   • Select the combination of version, number of zones and command set that matches your setup.
   • Please check the settings you entered, as the next step can create up to 10 devices and 94 features(!). Then to confirm chose Create Devices.
   • In the background the IP address you entered will be checked to make sure it is a valid IPv4 address (no typos, etc.). If it’s not valid, the devices/features will not be created. This process will NOT check if there is an actual MiLight Wi-Fi controller behind the IP address. Also, this process checks to make sure that devices or features with the same version/IP combination do not already exist.
   • In the next step you can either go back ‘home’ (Devices page) or to the Log, in case you want to check if everything went well.

Noteworthy

• The IP address can not (yet) be modified. If you changed the IP, please make a new configuration. There is no config (.ini) file.
• You can add as many Wi-Fi controllers as you want.
• You can add a Wi-Fi controller more than once, if the command set is different. This is also how you add controls for the bridge light.
• You can modify the names and locations of the devices and features as much as you want. They will keep working. For instance, instead of Zone 1, 2, 3, etc. you could consider naming them Living Room, Bed Room, etc.
• In case you created to many zones (8 instead of 4, or a bridge light) you can delete the devices/features you don’t need. If you’re not sure, consider hiding them instead. Renaming is safe, too.
• In case you can’t figure out how the colors work, consider a (HSV) color wheel. The colors correspond to the (H)UE component. But instead of 0-359°, the scale goes from 0-255. I choose to not convert this scale, so the result will be exact. If you find this confusing, you could consider adding the other scale under Status/Graphics and enter a scaled value as status text for 0-255. The Legacy MiLight color wheel seems to be rotated -120° (or 240°), while the V5/V6 color wheel seems to be mirrored horizontally and then rotated 30° (or mirrored vertically and rotated -150°).
• You may want to consider limiting access to the (Un)Link feature(s) by clicking on each feature and under User Access remove the Any checkmark, chose your admin account(s) instead and then Save.
• Note that all traffic is one way. In other words, you can only send commands and features will not be updated if you change lights outside the plugin (for example with a MiLight remote, or cut power).
• Looking for link/unlink commands for V3/V4? Try the ON command after power on.

Presets & Macros

The plugin does not support macros by default, but there are a few things you can do to make life easier:

Presets
If you’ve figured out which setting works for you for any of the slider features, you can add extra buttons so that you don’t have to remember the value and you can easily set the value in one go.

Preset example
Say you figured out that 4600K is the perfect setting for Zone 2 for dinner. Click the feature name (in this case Zone 2 White Temperature) and go to the Status/Graphics tab. Lookup the Value on the bottom of the page. In this case it turns out to be 50. Now chose New Single Value and Edit it to give this preset your value of 50 and a god name, in this case Dinner. Consider editin the Rows of both the slider and the button, so they don’t end up on the same line (which would make the slider smaller and harder to manipulate). Don’t forget to save.

Macros

If you want to be able to set several features at “the same time” you can use a virtual device and an event to do so.

Macro example

Say while watching movies you want to dim Zone 1 lights to 10% brightness and switch Zone 2 and Zone 3 lights off.
Create a virtual device (from the Devices page + in the right top corner). Then create one or more features with unique macro names and values. Now go to Events, add a new event (+). Name the event group, for example MiLight Macros. Then add a New Event (+), name it (in this case Movie Time. Set the trigger to your Virtual button (Movie Time). Then set all the features to the values you wanted:

Artificial extra zones

The Wi-Fi controllers are not actually quite limited to 4 (or 8) zones.
For example, the V5/V6 Wi-Fi controllers (iBox1 and iBox2) seem to be able to each control:

• Up to 4 RGBWW zones
• Up to 4 WW/CW zones
• Up to 4 RGBWW/CW full color zones
• Up to 8 RGB+CCT zones
• (1 RGB zone)

This is possible because if you link a light within a certain command set, it will only listen to commands from that set, not from another set. In other words, these controllers can* virtually be 21 zones(!). This, of course, can only be achieved if you have these type of lights, or don’t care about some functionality (For example you can link a RGB+CCT light as RGBWW light). You can add a controller more than once and set command modes differently for each occurrence.
Controllers with older versions have less command sets and can therefore handle less total zones.
Tested with available iBox2 hardware. Different versions may give different results.

Support

If you have a question or want to report a bug, please use the dedicated sub- forum on https://forums.homeseer.com/

Changelog

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>