{"_id":"586add112637b90f00dc286a","category":{"_id":"5859e859e3306d1900126725","project":"568bdc1483d2061900d86cdc","__v":0,"version":"582789aabe5c080f00a5a7fe","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-12-21T02:26:33.525Z","from_sync":false,"order":5,"slug":"edge-server","title":"Edge Server"},"project":"568bdc1483d2061900d86cdc","parentDoc":null,"__v":0,"user":"573b7f42fdc9d320001b777d","version":{"_id":"582789aabe5c080f00a5a7fe","__v":10,"project":"568bdc1483d2061900d86cdc","createdAt":"2016-11-12T21:29:14.915Z","releaseDate":"2016-11-12T21:29:14.915Z","categories":["582789abbe5c080f00a5a7ff","582789abbe5c080f00a5a800","582789abbe5c080f00a5a801","582789abbe5c080f00a5a802","582789abbe5c080f00a5a803","582789abbe5c080f00a5a804","582789abbe5c080f00a5a805","582789abbe5c080f00a5a806","582789abbe5c080f00a5a807","582789abbe5c080f00a5a808","5827ea984ca29e0f00137a9e","583df597887db62f00644283","583df5d9c622791900e78da5","5845cd8763c11b250037967d","5845d13063c11b2500379681","5859e859e3306d1900126725","587aeb9a01cf3a0f008359eb","587c422af45e2d0f005e200d","587d84dc82f6f30f004ceee5"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"beta2","version_clean":"0.0.0","version":"0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-01-02T23:06:57.179Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"The `droplit-plugin-philips-hue` plugin allows the Edge to communicate with Philips Hue lightbulbs.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Not just Philips\",\n  \"body\": \"The Philips Hue bridge works with any light that uses ZigBee Light Link, such as the CREE LED bulb.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Edge Registration\"\n}\n[/block]\nAs a security measure, the Hue bridge will only work with devices that have registered with it. In order for this plugin to work, it must therefore register the Edge with the Hue bridge.\n\nThis is the process to register the bridge:\n1. When the Edge starts running, it will first discover the Hue bridge.\n2. Note that the bridge’s `BasicAuthBridge.authenticated` property is `false`.\n3. Press the Link button on the physical Hue bridge.\n4. Call the `BasicAuthBridge.register` method. You must call this method within 30 seconds of pressing the link button.\n5. This should register the bridge. If successful, you will see a property changed notification for `BasicAuthBridge.authenticated` indicating that it is `true` and Edge will start discovering Hue bulbs.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Services\"\n}\n[/block]\n## BinarySwitch\nThe `BinarySwitch` service is used to switch a device `on` or `off`.\n\n### properties\n`switch` — The on/off state of the switch. Valid values are `on` and `off`.\n\n### methods\n`switchOn` — Sets switch to `on`.\n`switchOff` — Sets switch to `off`.\n\n## DimmableSwitch\nThe `DimmableSwitch` service is used to set the brightness of a switch.\n\n### properties\n`brightness` — Brightness level of the switch. The value is an integer from `0`–`100` representing a percentage.\n\n### methods\n`stepUp` — Increments the brightness by 10 absolute percentage points.\n`stepDown` — Decrements the brightness by 10 absolute percentage points.\n\n## ColorTemperature\nThe `ColorTemperature` service is used to set the color temperature (the light’s “warmness”/“coolness”).\n\n### properties\n`temperature` — The color temperature. The value is an number represented in Kelvin.\n`temperatureMin` — The minimum temperature value supported by the bulb. Is ReadOnly.\n`temperatureMax` — The maximum temperature value supported by the bulb. Is ReadOnly.\n\n## LightColor\nThe `LightColor` service is used to set the color of a light through HSL values.\n\n### properties\n`hue` — The light’s HSV hue value. The value is an integer from `0`–`65535`.\n`saturation` — The light’s HSV saturation value. The value is an integer from `0`–`65535`.\n`brightness` — The light’s HSV brightness value. The value is an integer from `0`–`65535`.\n\n## BasicAuthBridge\nThe `BasicAuthBridge` service is used to register Edge to the Hue bridge.\n\n### properties\n`authenticated` — Whether the Edge is authenticated to the Hue bridge. The value is a boolean.\n\n### methods\n`register` — Initiate authentication.","excerpt":"A Plugin for talking with devices supported by the Philips Hue Bridge","slug":"plugin-philips-hue","type":"basic","title":"Philips Hue Plugin"}

Philips Hue Plugin

A Plugin for talking with devices supported by the Philips Hue Bridge

The `droplit-plugin-philips-hue` plugin allows the Edge to communicate with Philips Hue lightbulbs. [block:callout] { "type": "info", "title": "Not just Philips", "body": "The Philips Hue bridge works with any light that uses ZigBee Light Link, such as the CREE LED bulb." } [/block] [block:api-header] { "type": "basic", "title": "Edge Registration" } [/block] As a security measure, the Hue bridge will only work with devices that have registered with it. In order for this plugin to work, it must therefore register the Edge with the Hue bridge. This is the process to register the bridge: 1. When the Edge starts running, it will first discover the Hue bridge. 2. Note that the bridge’s `BasicAuthBridge.authenticated` property is `false`. 3. Press the Link button on the physical Hue bridge. 4. Call the `BasicAuthBridge.register` method. You must call this method within 30 seconds of pressing the link button. 5. This should register the bridge. If successful, you will see a property changed notification for `BasicAuthBridge.authenticated` indicating that it is `true` and Edge will start discovering Hue bulbs. [block:api-header] { "type": "basic", "title": "Services" } [/block] ## BinarySwitch The `BinarySwitch` service is used to switch a device `on` or `off`. ### properties `switch` — The on/off state of the switch. Valid values are `on` and `off`. ### methods `switchOn` — Sets switch to `on`. `switchOff` — Sets switch to `off`. ## DimmableSwitch The `DimmableSwitch` service is used to set the brightness of a switch. ### properties `brightness` — Brightness level of the switch. The value is an integer from `0`–`100` representing a percentage. ### methods `stepUp` — Increments the brightness by 10 absolute percentage points. `stepDown` — Decrements the brightness by 10 absolute percentage points. ## ColorTemperature The `ColorTemperature` service is used to set the color temperature (the light’s “warmness”/“coolness”). ### properties `temperature` — The color temperature. The value is an number represented in Kelvin. `temperatureMin` — The minimum temperature value supported by the bulb. Is ReadOnly. `temperatureMax` — The maximum temperature value supported by the bulb. Is ReadOnly. ## LightColor The `LightColor` service is used to set the color of a light through HSL values. ### properties `hue` — The light’s HSV hue value. The value is an integer from `0`–`65535`. `saturation` — The light’s HSV saturation value. The value is an integer from `0`–`65535`. `brightness` — The light’s HSV brightness value. The value is an integer from `0`–`65535`. ## BasicAuthBridge The `BasicAuthBridge` service is used to register Edge to the Hue bridge. ### properties `authenticated` — Whether the Edge is authenticated to the Hue bridge. The value is a boolean. ### methods `register` — Initiate authentication.