The openpixelcontrol backend¶
This backend provides read-write access to the TCP-based OpenPixelControl protocol, used for controlling intelligent RGB led strips.
This backend can both control a remote OpenPixelControl server as well as receive data from OpenPixelControl clients.
Global configuration¶
This backend does not take any global configuration.
Instance configuration¶
| Option | Example value | Default value | Description |
|---|---|---|---|
destination |
10.11.12.1 9001 |
none | Destination for output data. Setting this option enables the instance for output |
listen |
10.11.12.2 9002 |
none | Local address to wait for client connections on. Setting this enables the instance for input |
mode |
16bit |
8bit |
RGB channel resolution |
Channel specification¶
Each instance can control up to 255 strips of RGB LED lights. The OpenPixelControl specification confusingly calls these strips “channels”.
Strip 0 acts as a “broadcast” strip, setting values on all other strips at once.
Consequently, components on strip 0 can only be mapped as output channels to a destination
(setting components on all strips there), not as input channels. When such messages are received from
a client, the corresponding mapped component channels on all strips will receive events.
Every single component of any LED on any string can be mapped as an individual MIDIMonster channel. The components are laid out as sequences of Red - Green - Blue value triplets.
Channels can be specified by their sequential index (one-based).
Example mapping (data from Strip 2 LED 66’s green component is mapped to the blue component of LED 2 on strip 1):
op1.strip1.channel6 < op1.strip2.channel200
Additionally, channels may be referred to by their color component and LED index:
op1.strip1.blue2 < op2.strip2.green66
Known bugs / problems¶
If the connection is lost, it is currently not reestablished and may cause the MIDIMonster to exit entirely. This behaviour may be changed in future releases.
While acting as an OpenPixelControl server, the backend allows multiple clients to connect. This may lead to confusing data output when multiple clients are trying to control the same strip.
When acting as a 16bit OpenPixelControl server, input on the broadcast strip (strip 0) may cause erratic value events on a few channels, especially with longer strips and inputs.