1
Power on the device
Connect the BrailleBridge device to any USB power source — a phone charger, a laptop port, or a USB power bank — using the device’s USB cable. The ESP32 draws its power and serial connection from this same cable.The device is now ready to pair and translate Braille chords. No button presses, no configuration menus, and no power switch to find — powering via USB is all it takes.
On devices assembled with status LEDs wired and enabled, the Red LED turns on and stays on at boot, confirming that the firmware is running and English mode is active. If your device does not show LED activity, the hardware is still fully functional — the LEDs are an optional visual indicator.
2
Pair via Bluetooth
On your phone, tablet, or PC, open the Bluetooth settings and scan for new devices. You will see a device named BrailleBridge appear in the list of available keyboards.Select BrailleBridge and confirm the pairing request. The device pairs as a standard Bluetooth HID keyboard — the same class as any wireless keyboard you have used before.Once paired, open any app with a text field — a notes app, a message compose window, or a document editor — and place the cursor inside it. BrailleBridge will type directly into that field.
BrailleBridge requires no drivers, no proprietary receiver dongle, and no manufacturer app. It works out of the box with any Bluetooth-capable device running Android, iOS, Windows, macOS, or ChromeOS. Your existing screen reader (TalkBack, VoiceOver, Narrator, or ChromeVox) will automatically read each translated character aloud as you type.
3
Connect Teacher Software
On the teacher’s computer, plug the same BrailleBridge USB cable into a USB port. The device is now connected over both Bluetooth (to the student’s device) and USB Serial (to the teacher’s computer) simultaneously.Open the Teacher Software in Google Chrome or Microsoft Edge:Once the Teacher Software is open:
- Click Add Student and enter the student’s name.
- Select the correct COM port from the dropdown (on Windows it appears as
COMx; on macOS/Linux as/dev/tty.usbserial-xxxxor/dev/ttyUSB0). - Leave the baud rate at the default 115200.
- Click Connect.
4
Type your first chord
With the cursor placed in a text field on the student’s Bluetooth-paired device, press dot 1 (top-left key) and dot 4 (top-right key) together, then release both.Here is what you will observe:From here, continue typing Braille chords to build words. Press the Space key (the wider key to the left) to insert a space. Hold the Shift key while pressing a chord to access uppercase letters, digits (Shift + A through J = 1 through 0), punctuation, and math symbols. To switch to Bangla, hold dots 4+5+6 together for 500 ms — the device will begin translating Bangla Bharati Braille chords, and the Green LED will illuminate (on devices with LEDs wired and enabled).
- The letter ‘c’ appears in the focused text field on the student’s device. Your screen reader announces “c”.
- The letter ‘c’ appears in the student’s live feed in the Teacher Software on the teacher’s screen.
- On devices with LEDs enabled, both LEDs flash briefly (approximately 100 ms) to confirm the chord was valid and the character was sent.
0b001001, dots 1 and 4) is the standard Grade 1 Braille cell for the letter C, and BrailleBridge translated it exactly as written.The firmware opens a 180 ms window from the first keypress to collect all the dots in your chord. You do not need to hit every dot at the exact same millisecond — fingers that land within that window are all merged into one chord automatically.
What’s next
Now that you have a working setup, explore the full capabilities of each component.Hardware overview
Dive into the GPIO mapping, bill of materials, 3D-printed enclosure, shift modifier layers, and the complete English and Bangla Braille dictionaries.
Teacher Software overview
Learn how to manage a multi-student roster, use Exam Mode to monitor a full class, export timestamped transcripts, and customise the interface.