Firmware for the Keyboardio Model 01 and other keyboards with AVR or ARM MCUs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Gergely Nagy dd9c3fa770
Merge pull request #6 from advisoray/master
7 years ago
src Updates to BootGreeting to allow better user customization 7 years ago
COPYING Initial import 7 years ago
Makefile Update Makefile with OSX fixes and new paths 7 years ago
README.md Updates to BootGreeting to allow better user customization 7 years ago
library.properties Initial import 7 years ago

README.md

Kaleidoscope-LEDEffect-BootGreeting

status

If you want to have your keyboard signal when it turns on, but you don't want to use any more complicated LED modes, this plugin is for you. It will make the LEDEffectNext key on your keymap slowly breathe for about ten seconds after plugging the keyboard in (without blocking the normal functionality of the keyboard, of course).

Using the plugin

To use the plugin, include the header, and tell Kaleidoscope to use the plugin:

#include <Kaleidoscope.h>
#include <Kaleidoscope-LEDEffect-BootGreeting.h>

void setup() {
  Kaleidoscope.use(&BootGreetingEffect, &LEDOff);

  Kaleidoscope.setup();
}

You may also set optional parameters.

Specify by search key

#include <Kaleidoscope.h>
#include <Kaleidoscope-LEDEffect-BootGreeting.h>

void setup() {
  Kaleidoscope.use(&BootGreetingEffect, &LEDOff);

  BootGreetingEffect.search_key = Key_M;

  Kaleidoscope.setup();
}

Specify by position

#include <Kaleidoscope.h>
#include <Kaleidoscope-LEDEffect-BootGreeting.h>

void setup() {
  Kaleidoscope.use(&BootGreetingEffect, &LEDOff);

  //Butterfly key
  BootGreetingEffect.key_col = 7;
  BootGreetingEffect.key_row = 3;

  Kaleidoscope.setup();
}

Specify longer timeout

#include <Kaleidoscope.h>
#include <Kaleidoscope-LEDEffect-BootGreeting.h>

void setup() {
  Kaleidoscope.use(&BootGreetingEffect, &LEDOff);

  //Butterfly key
  BootGreetingEffect.timeout = 15000;

  Kaleidoscope.setup();
}

Specify different color

#include <Kaleidoscope.h>
#include <Kaleidoscope-LEDEffect-BootGreeting.h>

void setup() {
  Kaleidoscope.use(&BootGreetingEffect, &LEDOff);

  //Butterfly key
  BootGreetingEffect.hue = 90;

  Kaleidoscope.setup();
}

Plugin methods

The plugin provides the BootGreetingEffect object, with the following methods and properties:

.search_key

Set the key in the current keymap that should be activated with the pulsing LED on startup. The plugin will search from the top left to the bottom right of the keyboard, row by row, to find this key. The first matching key will be selected.

Defaults to Key_LEDEffectNext

.key_row

This is an optional override to explicitly set the selected key by exact row and column. This number is 0-indexed, so the top row is 0, the second row is 1, etc. Must set .key_col property for this feature to be enabled.

.key_col

This is an optional override to explicitly set the selected key by exact row and column. This number is 0-indexed, so the left-most column is 0, the second column is 1, etc. Must set .key_row property for this feature to be enabled.

.timeout

This property specifies the timeout (in milliseconds) for the effect to last. When the keyboard is first connected, the pulsing LED effect will last for this duration before turning off.

Defaults to 9200 ms.

.hue

This property sets the color hue that the LED pulsing effect.

The default is 170, which is a blue color.

Dependencies