From 3cc68543ca8c69048ffc0655d92be238afcee376 Mon Sep 17 00:00:00 2001 From: James Young <18669334+noroadsleft@users.noreply.github.com> Date: Wed, 15 Apr 2020 13:31:09 -0700 Subject: KC60 Refactor (#8782) --- keyboards/kc60/mod_rgb_underglow.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 keyboards/kc60/mod_rgb_underglow.md (limited to 'keyboards/kc60/mod_rgb_underglow.md') diff --git a/keyboards/kc60/mod_rgb_underglow.md b/keyboards/kc60/mod_rgb_underglow.md new file mode 100644 index 000000000..6aab1e1d2 --- /dev/null +++ b/keyboards/kc60/mod_rgb_underglow.md @@ -0,0 +1,31 @@ +# Adding RGB Underglow to the KC60 + +![Image of KC60 with RGB Underglow](https://i.imgur.com/LpUkVqGl.jpg) + +The KC60 has breakout pins to which one may wire a strip of WS2812-compatible LEDs. + +By default, the source is set up for 16 LEDs on the F5 breakout pin. See [included image](https://i.imgur.com/TcKL2Sn.jpg) for wiring reference. If you attach a different number of LEDs, configure your source for the correct number of LEDs by adding a `config.h` file alongside your `keymap.c` file, with the following contents: + +```c +#pragma once + +#undef RGBLED_NUM +#define RGBLED_NUM +``` + +To enable RGB Underglow, simply add a `rules.mk` file containing `RGBLIGHT_ENABLE = yes` alongside your `keymap.c` file, and compile as normal: + +```shell +make kc60: +``` + +The [ws2812 keymap](keymaps/ws2812/) may be copied and used as a starting point. + +RGB Underglow is a fairly large feature, and your firmware may be too large to be flashed with it enabled. Adding `CONSOLE_ENABLE = no` or `COMMAND_ENABLE = no` to your `rules.mk` file will reduce the size of the firmware greatly, and if you don't use either feature, is a very low impact change. + + +## Reference Images + +![Wiring Reference](https://i.imgur.com/TcKL2Sn.jpg) +![RGB Strip turned on](https://i.imgur.com/21POu4l.jpg) +![RGB Strip turned off](https://i.imgur.com/vAOLYNV.jpg) -- cgit v1.2.3