What is chording?
In standard Braille, one character is formed by pressing multiple dots at the same time. BrailleBridge mirrors this: you press whichever dots make up a letter, release them, and the firmware translates the combined pattern into a character. This technique is called chording. The challenge with physical keys is that your fingers never land in perfect unison — even a fast typist will touch dot 1 a few milliseconds before dot 4. If the firmware processed each key press the instant it detected aLOW signal, a single intended character would be split across multiple readings. The 180 ms collection window solves this by giving all your fingers time to land before the firmware commits to a translation.
The 6-bit bitmask
BrailleBridge maps each of the six Braille dots to one bit in an unsigned 8-bit integer:
All six pins are configured as
INPUT_PULLUP, meaning they read HIGH at rest and go LOW when you press the key. Inside the main loop, the firmware polls all six pins and OR-assigns the corresponding bit for every pin that reads LOW:
0 and 63 (0b000000–0b111111). Each possible 6-bit pattern corresponds to at most one character per language, so dictionary lookup is a simple linear scan — no parsing, no state machine.
The 180 ms collection window
The main loop accumulates pressed dots intocurrentChord on every iteration. Once the first dot goes LOW, the firmware starts a timer using millis(). After 180 ms, or as soon as all keys are released, the firmware commits the accumulated chord and calls processChord():
Worked example — typing ‘C’
1
Press dots 1 and 4
You press down dot 1 (GPIO 14) and dot 4 (GPIO 27) simultaneously. Both pins go
LOW.2
Firmware sets bits 0 and 3
The loop reads GPIO 14 as
LOW → sets bit 0. Reads GPIO 27 as LOW → sets bit 3. The running currentChord accumulates to 0b001001.3
Chord value = 9
0b001001 in decimal is 9. The firmware holds this value as the window continues to accumulate (in case more dots land).4
180 ms window closes
No other dots were pressed. The firmware calls
processChord(9).5
Shift is not held
The firmware reads GPIO 32 (
SHIFT) as HIGH — not pressed. shiftActive is false.6
English mode — lookupChord(9, false) returns "c"
isBangla is false, so the dictionary is searched for a chord value of 9 with a non-null english field. The entry { 0b001001, "c", "চ" } matches and returns "c".7
sendChar("c") transmits the character
sendChar() calls bleKeyboard.print("c") over Bluetooth HID and Serial.print("c") over USB at 115200 baud — both simultaneously.Valid vs. invalid chords
Every chord the firmware processes falls into one of two outcomes: Valid chord — the chord value exists in the active language’s dictionary:- The translated character is sent over Bluetooth HID and USB Serial.
- No character is sent over Bluetooth HID or USB Serial.
On a 240 MHz ESP32, the entire dictionary lookup — a linear scan of under 60 entries — completes in a few microseconds. The 180 ms window is there for your fingers, not the processor. From a typist’s perspective, the response feels instantaneous.