Installing the Philips Hue Driver for Control4

You need Composer Pro, a Control4 controller on OS 3.3.0 or later, and a Hue Bridge or Hue Bridge Pro on the same network. Give the bridge a reserved address on your router so it does not change.

Add the bridge and pair it

  1. Unzip the download and copy the four .c4z files into your Composer driver folder, Documents\Control4\Drivers.
  2. In Composer Pro, search the local database for "Hue" and add Hue Bridge (Local) to the project.
  3. On its Properties tab, type the bridge's address into Bridge IP, or run the Discover Bridge action.
  4. Run the Pair With Bridge action, then press the round button on the Hue bridge within 30 seconds.
  5. Status changes to Connected and Lights Found fills in. The trial starts here; Licence shows the days left.

Bring in lights and rooms

  1. On the bridge driver, run Import Lights and Rooms. It adds a light for every Hue bulb and every Hue room that is not already in the project.
  2. Each one is named after its Hue name and placed in the Control4 room with the same name. Anything without a matching room lands beside the bridge driver.
  3. Watch Import Status for progress. Running the import again only adds what is new.

To add one by hand, add a Hue Light (Local) and choose the bulb, room or zone in its Hue Light list.

Scenes

A light that controls a Hue room or zone lists that room's Hue scenes on its own screen, among its colour presets. Nothing needs importing. Scenes added, renamed or deleted in the Hue app follow along. The room needs at least one colour or white-temperature bulb for the list to appear.

For keypads and schedules, the bridge driver has an Activate Hue Scene command under Programming.

Motion sensors

  1. On the bridge driver, run Import Motion Sensors.
  2. Each Hue sensor is added as a Hue Motion (Local) driver with a Control4 Motion Sensor bound to it.
  3. Set Hold Time (seconds) if you want motion to stay active longer than the sensor's own few seconds.

Licensing

  1. Buy a licence. The key is shown as soon as the payment goes through.
  2. In Composer Pro, open the bridge driver and type the key into Licence Key.
  3. Licence changes to Licensed within a few seconds. Run Check Licence if it does not.

One licence covers the whole project. The key becomes tied to the controller running Director; other controllers in the project need nothing. It is checked over the internet once, and the driver then keeps working with no connection.

If something is not right

Status says the bridge is unreachable
Check Bridge IP, and that the controller and bridge are on the same network. Setting Live Updates to Off makes the driver poll the bridge instead of holding a connection open.
Lights show offline and will not respond
Look at Licence on the bridge driver. If the trial has ended, enter a key. If it says it is waiting for the licence server, the controller needs internet access once.
"This licence key is in use on another project"
A key works in one project. If the controller running Director was replaced, contact us and we will release the key.
A light is switched off at the wall
It shows as offline in Control4 until it has power again.
Asking us for help
Set Debug Mode to On, run Print Lights on the bridge driver, and send us what appears on the Lua tab along with the Driver Version and Controller ID.