Kaleidoscope-Model01-TestMode documentation?


(Michael Richters) #1

I hear that Kaleidoscope-Model01-TestMode is a very useful debugging tool, but I have no idea how to use it. Before I go searching through the code to try to figure it out, is there any written documentation for it? Or is someone familiar with it willing to write up a brief summary?

What to do if you experience key chatter
(Gergely Nagy) #2

It’s 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.

First, it will test the LEDs by going through a few colors (waiting for any keypress in between): red, green, blue, then white. It will follow that with 1000 cycles of rainbow.

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 red. Held keys turn green. If chatter is detected, they turn red. If everything is ok, it turns blue.

To leave test mode, you will have to reach the matrix test phase, and the same combo you used to enter it, can be used to exit.

This is what it does at the moment.

Duplicated key-presses, especially on the thumb keys (chatter)
I have a single dead-ish key
What to do if your keyboard seems to duplicate keystrokes or a key stops working
Keys stuck for no apparent reason
Spacebar not working: USB Overdrive on macOS messes with the Model 01
9 key does not work

The key sequence to exit test mode seems to not be working at the moment. I followed the instructions to test key chatter (it successfully found it after a couple of tries), but after testing all the keys, I tried pressing PROG, LED, and left Fn together, and instead of exiting test mode, it just restarted test mode. The only way to get back out of test mode was to unplug the keyboard altogether.

(Jesse) #4

Really, you need to unplug and replug the keyboard. It was designed for the factory and turning off test mode is almost impossible.

(Liza) #5

A note of clarification for anyone else (like me) who has changed the location of their LED key: the key to press for this is the original LED key, not wherever you moved it to. (Presumably that applies for the PROG and left Fn keys as well.)

(James Cash) #6

Yes, it specifies the keys by physical positions, not key codes (see here and here, plus this image).

(Daniel Shields) #7

Trying to run test mode to see if I’ve fixed my key chatter issue. It lights the keyboard up red but get’s no further. I’m not using the stock layout but still have the TestMode plugin. Any suggestions?

(Gergely Nagy) #8

Try pressing a key. The test mode first starts with cycling through some colors, then rainbow, and only then does it enter the matrix test part.

(Jesse) #9

You need to tap the left fn key again a few times. (There’s a brief timeout before you can cycle away from red)