Connection parameters
Open the serial port with exactly these settings — any mismatch will produce garbled or missing output:
The BLE device name (
"BrailleBridge") is set in the firmware via BleKeyboard("BrailleBridge", "StudentProject", 100) and is what you will see in your Bluetooth device list when pairing the student’s device. USB Serial and Bluetooth HID operate completely independently — you can use one, both, or neither at any given moment.
Message types
Every message from BrailleBridge is a single newline-terminated UTF-8 string. The device sends messages only from device to host — there is no command channel from host to device.
The Teacher Software uses
LANG:en and LANG:bn to update the language badge shown beside each student’s name in real time. Translated characters arrive as plain UTF-8 and are appended directly to the student’s live answer buffer.
Reading the serial stream
The Teacher Software connects to each student’s device using the Web Serial API and reads the stream inside a dedicatedreadLoop() per student. Each character or status message arrives as a plain string and is passed immediately to handleStudentChar() for processing:
TextDecoderStream handles multi-byte UTF-8 sequences automatically, so Bangla Unicode characters (which are 3 bytes each) arrive as complete strings without any manual byte reassembly. Set student.readLoopActive = false and call reader.cancel() to cleanly disconnect a student mid-session.
Browser requirements
The Web Serial API is required to connect BrailleBridge to the Teacher Software from a browser. Only Chrome 89+ and Edge 89+ support this API.Custom integrations
If you want to build your own application on top of BrailleBridge output, you can read the USB Serial stream from any language or tool that supports serial communication. Every message is plain UTF-8 and newline-terminated (\n), so a simple line-by-line read loop is all you need.
Common options:
- Python — use the
pyseriallibrary. Open the port at 115200 baud and callreadline()in a loop. - Node.js — use the
serialportpackage. TheReadlineParsersplits on\nautomatically. - Serial terminal — tools like PuTTY, minicom, or the Arduino IDE Serial Monitor at 115200 baud will display the raw stream directly, which is useful for debugging chord mappings.