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 204d450239
The Big Rename
8 years ago
examples/TopsyTurvy The Big Rename 8 years ago
src The Big Rename 8 years ago
.gitignore Initial import 8 years ago
COPYING Initial import 8 years ago
README.md The Big Rename 8 years ago
library.properties The Big Rename 8 years ago

README.md

Kaleidoscope-TopsyTurvy

status

TopsyTurvy is a plugin that inverts the behaviour of the Shift key for some selected keys. That is, if configured so, it will input ! when pressing the 1 key without Shift, but with the modifier pressed, it will input the original 1 symbol.

Using the plugin

To use the plugin, one needs to include the header, create a list, and configure the provided TopsyTurvy object to use the dictionary:

#include <Kaleidoscope.h>
#include <Kaleidoscope-TopsyTurvy.h>

static const Key topsyTurvyList[] PROGMEM = {
  Key_1, Key_2, Key_3, Key_4, Key_5,
  Key_6, Key_7, Key_8, Key_9, Key_0,
  Key_NoKey
};

void setup () {
  TopsyTurvy.configure (topsyTurvyList);
  
  Kaleidoscope.setup (KEYMAP_SIZE);
  Kaleidoscope.use (&TopsyTurvy, NULL);
}

The list of keys must be terminated with a Key_NoKey, and must reside in PROGMEM.

Plugin methods

The plugin provides the TopsyTurvy object, with the following methods:

.configure(list)

Tells TopsyTurvy to use the specified list of keys.

.on()

Turns the shift-inversion functionality on.

.off()

Turns the shift-inversion functionality off. In this case, no transformations will be applied, and even if keys pressed appear in the list, they will be ignored until the plugin is turned back on.

Further reading

Starting from the example is the recommended way of getting started with the plugin.