homebridge-opc
Open Pixel Control (OPC) plugin for Homebridge.
Installation
- Install homebridge using: npm install -g homebridge
- Install this plugin using: npm install -g homebridge-opc
- Update your configuration file. See the sample below.
Updating
- npm update -g homebridge-opc
Configuration
Lightbulbs
Pixel segments are exposed as a lightbulb in HomeKit with the lightbulbs configuration.
"lightbulbs":
The map property is similar to the FadeCandy server map configuration:
- [ OPC Channel, First OPC Pixel, Pixel count ]
- Pixel count is optional and will default to 1.
Map Examples
Channel 0, pixels 0 through 3:
"map": 0 0 4 // As a Range"map": 00 01 02 03 // Individual
Channel 1, pixels 3 through 8:
"map": 1 6 3 // As a Range"map": 16 17 18 // Individual
Channel 1, pixels 6 through 9:
"map": 1 6 3 19 // Range plus Individual"map": 16 17 18 19 // Individual
Gradients
Pixel segments can also be set to a gradient between two lightbulb colors.
"lightbulbs": , "gradients":
The map property for gradients has an additional option Step Length. If omitted it defaults to 0.
- [ OPC Channel, First OPC Pixel, Pixel count, Step length ]
For a gradient 10 pixels long:
- Step Length of 0 will have 1 color:
1,2,3,4,5,6,7,8,9,10
- Step Length of 1 will have 10 colors:
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
- Step Length of 2 will have 5 colors:
1,2 | 3,4 | 5,6 | 7,8 | 9,10
- Step Length of 3 will have 4 colors:
1,2,3 | 4,5,6 | 7,8,9 | 10
Fade Duration
Name | Default | Description |
---|---|---|
fadeDuration | 0 | Fade between color changes in ms (0 is instantaneous) |
fadeOnDuration | fadeDuration | Fade when turning a lightbulb on in ms (0 is instantaneous) |
fadeOffDuration | fadeDuration | Fade when turning a lightbulb off in ms (0 is instantaneous) |
Sample Configurations
- Minimal configuration, one 10 pixel long strand all one color:
"accessories":
- Strip 40 Pixel long strip with one pixel on each end as a lightbulb and the 38 pixels in between a gradient. Includes optional fade durations:
"accessories":