Firmware Kit · TurkeyBoards Tools

TurkeyBoards Tools

/Firmware Kit/ Keyboard name

All tools Layout Editor Ergogen Builder Firmware Kit Shop

Click the keys in the order the LEDs are chainedTap the keys in chain order

Preview

Keymap image preview

Click a key, then pick a keycode · Tab moves to the next key

Board

Diodes Halves

Split cable pin

Flash chip Flash size

32.768 kHz crystal on P0.00 / P0.01

DC/DC converter Battery reading

Battery divider pin

More about a chip on the PCB

The right half uses the same pins

OLED display (SSD1306)

SDA SCL

LED data pin LEDs per half Extra underglow per half

Chain order

The right half mirrors the left

Vendor ID Product ID

Maker

VIA needs IDs of its own; Vial ignores them.

Key switches

Debounce (ms) How

USB

Report every (ms)

Slower saves a little power; 1 is QMK's and ZMK's.

N-key rollover from the start: every key at once

Knobs

Steps per click: 4 for most EC11 knobs. If one click moves two steps, pick 2 (or 1 if it moves four).

The split's link

Restart the other half if it loses the USB half (its watchdog)

Time to find USB (ms)

Longer if a half starts up as the other half on a slow computer or hub.

Power and idle

Idle after (s)

The screen goes off then.

Lighting off after (s)

Without a key press; the next one lights it again.

Underglow off while the computer sleeps Lighting off while the keyboard is idle

Deep sleep after (min)

Saves the battery; a key press wakes it. ZMK suggests 15.

Stronger Bluetooth signal (+8 dBm), for a weak link

Layer Lock lets go after (s)

Without a key press.

No key chosen

Click a key on the board to change it.

When tapped When held

With

Keycodes

Type to assign

Search keycodes

One key: different on tap, hold, double tap, or tap then hold.

Two to four keys pressed together for another key.

Press withinms

Types text, taps keys and waits, from one key.

{KC_ENT} taps a key · {KC_LCTL,KC_C} a chord · {+KC_LSFT}/{-KC_LSFT} press, let go · {500} waits 500 ms · \{ a brace

A modifier and a key send something else: Shift + Backspace for Delete.

Tap the Leader key, then a few keys in a row (up to five) to type text or a shortcut.

Finish within (ms)

The time starts again with each key

QMK settings · as in Vial's QMK Settings

What the keyboard starts with. The Swaps & NKRO keys (Device) change them later.

Swap Caps Lock and left Ctrl Caps Lock is a Ctrl Swap left Alt and GUI Swap right Alt and GUI Swap left Ctrl and GUI Swap right Ctrl and GUI The GUI keys do nothing Swap ` and Escape Swap \ and Backspace N-key rollover: every key at once (also in Wiring → Board settings)

The Grave Escape key (Esc/`) types ` with Shift or GUI held. Escape anyway when this is held:

AltCtrlGUIShift

Tapping term (ms) Quick tap term (ms)

A hold is decided

Flow tap (ms)

A tap-hold key pressed this soon after another key just taps.

Chordal hold: a mod-tap holds only with the other hand's keys Thumb keys go with either hand Retro tapping: a held key let go on its own still taps

Alt, GUI mod-taps: + ms

Extra time for the ring and pinky fingers' mod-taps.

Taps the firmware makes

Tap code delay (ms) Caps Lock tap (ms) TT() taps to lock

Hold a key a little longer for its shifted character

Hold for (ms)

ShiftsLettersNumbersSymbols and Tab

Also while a modifier is held A key held on repeats No repeat once a key is held past the time

Let go after (ms) Taps to lock it

How the cursor moves

Speed

Fine-tuning (as Vial's Mouse keys tab)

A step every 16 ms: smoother (and a little faster) The speed keys (MS_ACL0–2) work while held, not until the next one

Both Shift keys together turn it on A double tap on left Shift turns it on Shift types a lowercase letter while it's on (Vial: always)

Off after a pause (ms)

0: it stays on until the word ends.

A colour for each layer, and lights for Caps Lock and Caps Word.

Light only the keys that do something on the layer (the rest go dark) Show the colours with the underglow switched off too

Screen off after (s)

0: never off (an OLED burns in).

Build and flash

Also in BUILD.md

To add to a setup you already have.

File contents

Layers

Look

Transparent keys Layer names

Checks