hueplusplus

A simple and easy to use library for Philips Hue Lights

Features

• finds bridges with SSDP or set ip manually
• function to assign username or set manually
• all common light functions
• extended alert() function, which alerts in a specific color
• documented with doxygen

How to use

Finding Bridges

If you want to find a Hue Bridge make a HueFinder object and call FindBridges() it will return a vector containing the ip and mac address of all found Bridges. If no Bridges were found the vector is empty, so make sure that in that case you provide an ip and mac address.

HueFinder finder;
std::vector<HueFinder::HueIdentification> bridges = finder.FindBridges();
if (bridges.empty())
{
    bridges.push_back({ "<ip address>", "<mac address>" });
}

Using Bridges

If you have found the Bridge you were looking for, you can then move on with the authentication process. To get a new username from the Bridge (for now) you simply call GetBridge(bridges[]), where index is your preferred Bridge from the part Finding Bridges.

Hue bridge = finder.GetBridge(bridges[0]);

If you on the other hand already have a username you can add your bridge like so

finder.AddUsername(bridges[0].mac, "<username>");
Hue bridge = finder.GetBridge(bridges[0]);

Controlling lights

If you have your Bridge all set up, you can now control its lights. For that create a new HueLight object and call getLight() on your bridge object to get a reference to a specific light, where id is the id of the light set internally by the Hue Bridge.

HueLight light1 = bridge.getLight(1);

If you don't know the id of a specific light or want to get an overview over all lights that are controlled by your bridge you can do that by calling getAllLights() on your bridge object. If no lights are founb the vector will be empty.

std::vector<std::reference_wrapper<HueLight>> lights = bridge.getAllLights();

If you now want to control a light, call a specific function of the it.

light1.On();
light1.setBrightness(120);
light1.alertHueSaturation(25500, 255);
light1.setColorLoop(true);
light1.setColorRGB(255, 128, 0);
lights[1].Off();
lights.at(1).setColorHue(4562);

But keep in mind that some light types do not have all functions available. So you might call a specific function, but nothing will happen. For that you might want to check beforehand what type of a lamp you are controlling. For that you can call the function getColorType(), which will return a ColorType.

ColorType type1 = light1.getColorType();

Further reading

If you want to know more about all functions just look inside the doxygen description, which for now can be found in the regarding sourcecode file or create the documentation with the provided Doxyfile yourself.

Copyright

Copyright (c) 2017 Jan Rogall & Moritz Wirger. See LICENSE for further details.