Category: Miscellaneous

Philips Hue V2 API

• infoBefore You Begin
• descriptionStep 1 – Getting Data
• constructionStep 2 – Build Function
• terminalCommand Generator/Example Commands

Before you begin, you will need:

• A HTTPS test program such as Postman, available here
• The Philips Hue Bridge address
• A configured Hue lighting system on the same network as the HDA system
• A fully-commissioned HDA or uControl system with the latest version of uOS (MHUB-OS does not support IP integrations) on the same network as the Philips Hue.
• A tablet or laptop using any of the most popular browsers (or an iPhone with the uControl app, at the very least) on the same network as the HDA system.

Please Note – Before you can access the full Philips Hue API you must have made a Philips Hue Developer account.

Step 1:Get data about the Philips Hue system

You need to know:

• Light ID’s
• Group ID’s
• Scene ID’s

There are a few ways you can get the IP address of your Philips Hue device:

1. Use a network scanner app like Fing to find Philips Hue on your network.
2. Use Philips Hue broker server discovery process.
3. Log into your wireless router and look for Philips Hue in the DHCP table.
4. The Philips Hue app – Start the Hue app and push link to connect to the bridge. Use the app to find the bridge and try controlling lights to ensure that everything is working. Then, go to the settings menu in the app, go to Hue Bridges, select your bridge and then the IP address of the bridge will be revealed.

Step 2: Build Function

Example Commands

Hue Command Examples

If you want to manually install the Android version of uControl you will need to enable Developer Mode on you phone, and allow app installation from unknown sources.

Once set click the link below.

uControl2016 for Android

Important– Development for this version of uControl has stopped, no update will be made, and you install this apk at your own risk.

With the release of the MHUB PRO 2.0 systems, you can now control your HDA system and attached devices with our widest range of control methods. See below for more details.

IR Passthrough

Using the included IR cabling included with every MHUB system you can control your source devices using their original IR remote.

IR Engine

Included in every MHUB system is HDANYWHERE’s patented IP to IR-engine. Our technology allows you to send IR commands using uControls built-in control packs or by passing Pronto hex into MHUB via our API V2.1

CEC(MHUB 2.0 Systems Only)

CEC (Consumer Electronics Control) is a feature of HDMI and allows controls of devices via the HDMI cable linking them. MHUB PRO 2.0 systems support CEC control of displays connected to the HDBaseT or HDMI Mirror outputs.

API 2.1

Our most powerful and versatile API has recently be released allowing 3rd party devices and developers to use HDA’s embedded technology such as our IR-engine by sending a single command. Our API uses RESTful

Voice

All MHUB systems support voice control as standard via an Amazon Echo (Alexa) device. Voice control is not designed to act as a primary control method but to assist
the other methods listed on this page. Using voice it is possible to change channels, execute sequences, turn MHUB on/off, increase or decrease display volume and basic
transport commands such as play/pause/forwards/backwards from any zone.

uControl Remote will work with any HDA system marked “uControl inside”. These are typically MHUB’s, MZMA or uControl Zone Processors which shipped with uControl OS (uOS) version 10 or above. MHUB’s which were installed with MHUB-OS (MOS) will not support the uControl Remote, but some can be upgraded (see below).