Quick Start Guide
Get your NeoRing running with a rainbow effect in under 5 minutes.
Prerequisites
- Arduino IDE (1.8+) or Arduino IDE 2.x
- An Arduino-compatible board (Uno, Nano, ESP32, RP2040, etc.)
- A USB cable
- 3 jumper wires
Step 1: Install the Library
- Open Arduino IDE
- Go to Sketch → Include Library → Manage Libraries
- Search for "RobotechPixel"
- Click Install (this also installs the Adafruit NeoPixel dependency)
Step 2: Wire the NeoRing
Connect 3 wires from your board to the NeoRing:
| NeoRing Pin | Arduino Pin | Description |
|---|---|---|
| 5V | 5V | Power supply |
| GND | GND | Ground |
| DIN | Pin 7 | Data input (default) |
Note: At full brightness with all LEDs white, the NeoRing draws up to 0.68A (measured). A single board is USB-safe even at full brightness on USB-C (1.5A) or USB 3.x (900mA) ports. USB 2.0 (500mA) is marginal at full brightness — reduce brightness or use an external supply. The default firmware limits brightness to 150/255 as a conservative default for multi-board setups.
Step 3: Upload Your First Sketch
#include <RobotechPixel.h>
RobotechPixel px(BOARD_NEORING, 1, 7);
void setup() { px.begin(); }
void loop() {
fxRainbowWheel(px, millis());
px.show();
}
Upload this sketch to your board. You should see a rainbow spinning around both rings!
Step 4: Try More Effects
Replace fxRainbowWheel with any of the 26 built-in effects:
// Fire simulation
fxFireRing(px, millis());
// Comet trails
fxComets(px, millis());
// Dual spinning rings
fxDualSpin(px, millis());
// Breathing pulse
fxBreathing(px, millis());
See the full Effects Reference for all available effects and their parameters.
Next Steps
- Wiring Guide — Power considerations and multi-board wiring
- Electrical Specs — Detailed electrical characteristics
- Firmware Guide — Configuration and customization
