Hardware Test Mode

Enabling Hardware Test Mode

This mode is enabled if your sketch includes the Hardware Test Mode plugin. You need to include the header file:

// Support for Keyboardio's internal keyboard testing mode
#include "Kaleidoscope-HardwareTestMode.h"

... and activate the plugin by including it in the KALEIDOSCOPE_INIT_PLUGINS section of your sketch:

// The hardware test mode, which can be invoked by tapping Prog, LED and the
// left Fn button at the same time.
HardwareTestMode,

Using Hardware Test Mode

This mode is mostly useful to detect hardware issues, but here’s how to use it: press PROG, LED and left Fn together at the same time to enter the test mode. Note that if you've remapped any of these, you need to press the original location, not your remapped location.

First, it will test the LEDs by going through a few colors (press left Fn to cycle): white, blue, green, and then red. It will follow that with 1000 cycles of rainbow (if the rainbow effect is included in your sketch).

Then it enters the matrix test mode. In this mode, when you press a key, it will aggressively check for chatter (by reducing debounce time significantly). By default, all keys start out orange. Held keys turn green. If chatter is detected, they turn red. If everything is ok, it turns blue.

Refer to Procedure to remedy key chatter for Model 01 MP1 & MP2 boards with keys that are detected as having chatter (red keys at the end of matrix test mode).

If a key stays orange despite being pressed, that indicates that the keypress is not being detected at all, and is a likely sign of a hardware problem.