How to add Philips Hue

How to add Philips Hue

This guide is for system administrators who need to configure Philips Hue in their TEOS Manage environment. Before using this guide you need to setup TEOS Manage.

 

To be able to add a Philips Hue to your TEOS Installation you need to connect the Hue bridge to your network. After connecting the bridge you need to find the IP address for the Hue bridge.

There is an easy way to find the IP address for your bridge. Make sure you are connected to the same network and open the URL: https://www.meethue.com/api/nupnp

The webpage displayed should look similar to above screenshot. The IP address displayed after “internalipaddress” is the IP we’re looking for. If the network is not connected to the internet or you don’t have the possibility to connected to the same network then you’ll need to ask your Network Administrator for the IP address.


Once you know the IP address of your bridge you need to open the URL: http://<bridge-ip-address>/debug/clip.html

In here configure the following settings:
Change URL to /api instead of the default /api/1234/
Enter in the Message Body:

{"devicetype":"teosremote#teosremoteapp"}

This should now look like this:

 

Once these settings are correct, press the “POST” button.
After you’ve clicked the “POST” button you should receive a Command response which reads: “link button not pressed”.

As described by the result, you should now press the button on your Hue bridge.

After you’ve pressed the button on the Hue bridge you need to press the “POST” button again on the webform. This time you should get a different response. This response should contain a username and should look something like this:

Copy the full code between the quotes after username (so in our example this would be u3xeptuuHrtwoz1fNISIRzc8sHca5gacq2Z6N9zg).

Now that you know the IP address and username for your Philips Hue you can connect the system to TEOS Manage.

The first item is to configure the username in TEOS. To do this you need to open the configuration file for TEOS. This file is located in the installation directory for TEOS. By default this would be: “C:\Program Files\TEOS Manage\www\backbone” and the file we need is “web.config”. Open the web.config with a text editor.

After opening the file look for the key: “hueUsername”. Fill in the username you found in the previous step in the value field behind this key.

The next step is to add the system to TEOS. To do this log in to TEOS Manage and go to your Device overview. In here click the “Add device” button.

Make sure to fill in the following information:

- Name (your own identifier for your device)

- IP Address (the IP address you found in the previous step)

- Device type (set this one to Philips Hue)

- Device Group (the group you want to add this system to)


This should look something like this:

 

After adding the device you can now control the Philips Hue through the control app.