NeoPixelPusher (NPP)

Control software for Adafruit NeoPixels.

Simple command protocol
Supports control over serial or Bluetooth LE depending on configuration
Effect Mode:
- 58 built-in effects
- 42 built-in color patterns
- Custom effects possible, up to 96 frames on 4 channels
- Custom color patterns possible, up to 32 colors
- Variable speed control
- Can randomly change modes periodically
XLM (Explorateria Light Machine) Mode:
- Simulates an exhibit at a certain San Francisco science museum
- Perfect for NeoPixel Ring 60
Clock Mode:
- 3 display modes (point, line, binary)
- Customizable colors for hours, minutes, seconds
- Perfect for NeoPixel Ring 60
Colors and fades are gamma-corrected
Brightness adjustment
Settings saved to EEPROM

Default Configuration

60 NeoPixels on Pin 6
"Factory reset" on Pin 5 (connect to ground to erase EEPROM on startup)
Serial enabled at 9600 bitrate
Bluetooth LE disabled
Effect Mode, XLM Mode, and Clock Mode enabled
Configuration can be modified at top of .ino file

Command Protocol

E - Switch to Effect Mode
- ER - Report whether randomization is in effect and time between effects
  - ER0 - Do not randomly change effects
  - ER1 - Randomly change effects
  - ER ms - Set time between changing effects
- EM - Report current effect (0-57, or 254 if custom)
  - EM n - Set current effect
- ECP - Report current color pattern preset (0-41, or 254 if custom)
  - ECP n - Set current color pattern preset
- ECS rrggbb ... - Set custom color pattern (up to 4 colors initially)
- ECX rrggbb ... - Extend custom color pattern (up to 4 colors at a time, up to 32 at max)
- ECT - Report number of colors
  - ECT n - Report value of n-th color
- EBP - Report current blink pattern present (0-17, or 254 if custom)
  - EBP n - Set current blink pattern preset
- EBS ms n aabbccdd ... - Set custom effect / blink pattern
  - ms - Milliseconds per frame, 2 hex digits
  - n - Number of channels, 1 digit (1-4)
  - aabbccdd - Brightness levels per channel, (2 * number of channels) hex digits
  - Up to 3 - 12 frames initially, depending on number of channels
- EBX aabbccdd ... - Extend custom effect / blink pattern
  - aabbccdd - Brightness levels per channel, (2 * number of channels) hex digits
  - Up to 3 - 14 frames at a time, depending on number of channels
  - Up to 96 frames at max
- EBT - Report milliseconds per frame, number of channels, and number of frames
  - EBT n - Report brightness levels of n-th frame
- ES - Report speed adjustment (0.0 to ~255.996 in increments of ~0.004)
  - ES x - Set speed adjustment
X - Switch to XLM (Explorateria Light Machine) Mode
- XN0+ - increase number on for first channel
- XN0- - decrease number on for first channel
- XN1+ - increase number on for second channel
- XN1- - decrease number on for second channel
- XO0+ - increase number off for first channel
- XO0- - decrease number off for first channel
- XO1+ - increase number off for second channel
- XO1- - decrease number off for second channel
- XS0+ - increase speed of first channel
- XS0- - decrease speed of first channel
- XS1+ - increase speed of second channel
- XS1- - decrease speed of second channel
- XV0 - reverse first channel
- XV1 - reverse second channel
- XR0 - start / resume first channel
- XR1 - start / resume second channel
- XF0 - stop / freeze first channel
- XF1 - stop / freeze second channel
- XZ0 - reset first channel to default
- XZ1 - reset second channel to default
C - Switch to Clock Mode
- CCH rrggbb - Set hour color
- CCM rrggbb - Set minute color
- CCS rrggbb - Set second color
- CM n - Set clock mode
  - CM0 - Point mode
  - CM1 - Line mode
  - CM2 - Binary mode
- CS yyyymmdd hhmmss - Set clock time
- CT - Report clock time
PB n - Set brightness level (0-255)
PZ - Report free RAM