homebridge-neopixel v3.3.2
homebridge-neopixel
Supports NeoPixel http(s) devices on the HomeBridge Platform and provides a readable callback for getting and setting the following characteristics to Homekit:
- Characteristic.On
- Characteristic.Brightness
- Characteristic.Hue
- Characteristic.Saturation
For more information visit: http://www.studiopieters.nl/apple-homebridge-neopixel-light/
Installation
- Install homebridge using:
npm install -g homebridge - Install homebridge-http using:
npm install -g homebridge-neopixel - Update your configuration file.
Configuration file
Structure
The following is an overview of the structure of your HTTP-NEO accessory.
Both powerOn and powerOff can either be a string or an object. If a
string is provided it is filled in as the url and the body will be blank.
Most devices will be ok with the string option.
The purpose of powerOff/powerOn for an NeoPixel light is not to physically power
or de-power the device (as then how would it respond to further commands?), but
to set the LED color to black (for powerOff), and restore the color (for
powerOn). Your backend device should already be doing this. This is just
a convenience function so that your HomeBridge knows this device can turn off
or on.
Additionally, both brightness and color share the same structure (with the
exception that the color structure allows for a .brightness variable), they
can either be a string or an object. If it is a string, it is filled in
as the status and the other fields are left blank. When this is the case, you
can only read the settings, you may not change them.
{
"accessory": "HTTP-NEO",
"name": string,
"http_method": string-optional,
"username": string-optional,
"password": string-optional,
"sendImmediately": string-optional,
"switch": {
"status": url-optional,
"powerOn": string-or-object,
"powerOff": {
url: string,
body: string
}
},
"lock": {
"status": url-optional,
"secure": string-or-object,
"unsecure": {
url: string,
body: string
}
},
"brightness": string-or-object,
"color": {
"status": url-status,
"url": url-optional,
"brightness": boolean,
"http_method": string-optional
}
}Interfacing
All the .status urls expect a 200 HTTP status code and a body of a single
string with no HTML markup.
switch.statusexpects0for Off, and1for On.brightness.statusexpects a number from 0 to 100.color.statusexpects a 6-digit hexidemial number.
Homebridge-NeoPixel is based on homebridge-better-http-rgb.