Skip to content

Latest commit

 

History

History
109 lines (68 loc) · 3.52 KB

rgb-underglow.md

File metadata and controls

109 lines (68 loc) · 3.52 KB

RGB Underglow

Parts

  • WS2812 LED strip
  • 24 AWG (or smaller) stranded wire (white, red, black are good choices)

The WS2812B strip is also fine, but avoid the sealed waterproof one for keyboards.

Look for a strip with spaced, 3-pad connectors. When you cut between them the pads are bigger and it's easier to solder to. Example:

Prep the strips

  1. Cut 2 5-LED segments from the WS2812 strip (cut between the pads, or in the middle of the pads if you don't have a space between)
  2. Fill the pads on both ends with solder like the picture below

Avoid buying LED strips like this one where you cut the pad in half. There's just not much left to solder to, but it can be done.

Prep the wire

  1. Cut 2 white, 2 black, and 3 red wires, about 5cm (2in) in length (or just 7 pieces if you're using all the same color)
  2. Strip the ends about 2-3mm
  3. Solder the wires on output end of one strip and in input end of the other strip
  • White: VCC
  • Red: DIN/DO
  • Black: GND

Connect to the Pro Micro

Remember, current only flows one way through diodes so be sure you've got your LED strip in the correct orientation.

Data goes like this: --> Data In (DIN) --> Data Out (DO)

  1. Select the LED strip you connected wires to the output side.
  2. On the Pro Micro you connect the USB cable to, connect LED DIN to TX0 pin.

Tip: You may need to adjust the length of some of your wiring so it routes snugly to the board.

Sync across sides

Remember those jumpers we did before below the TRRS jack? We're going to use the 3rd pad here.

On the DO side of the controlled strip:

  1. Connect LED GND to GND pad
  2. Connect LED VCC to VCC pad
  3. Connect DO to Extra Data. It's a through hole right between the VCC/GND pads.

Tip: These pads are pretty small so be careful not to mess up your jumpers.

On the other side:

  1. Connect to VCC, GND, and Extra Data to DIN pad on the strip.
  2. Don't connect the DO side

Your wiring should look like this:

TX0 -> DIN -> DO -> extra data -> (TRRS to other side) -> extra data -> DIN

Since ground and VCC are already routed to the TRRS jumper pads, the wires attached on the data out side will carry the power through the rails along to all the LEDs. Only the data in pad must be connected on the Pro Micro side.

QMK


  1. Add a Makefile and config.h to your keymap if you don't already have one.
  2. In the Makefile add RGBLIGHT_ENABLE = yes
  3. Add a layer to control the RGB lights
  4. In config.h:
#undef RGBLED_NUM
#define RGBLIGHT_ANIMATIONS
#define RGBLED_NUM 10

Now flash that sucker and turn your lights on.