> ## Documentation Index
> Fetch the complete documentation index at: https://braille.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BrailleBridge Quickstart: From Unboxing to First Character

> Set up BrailleBridge from unboxing to first typed character in four steps: power on, pair via Bluetooth, connect Teacher Software, and start typing.

This guide gets you from an unboxed BrailleBridge device to your first typed character in four steps. You need the hardware device, a USB cable (Micro-USB to USB-A or USB-C depending on your ESP32 module), a phone, tablet, or PC for Bluetooth pairing, and a second computer running Chrome or Edge for the Teacher Software. The entire setup takes less than five minutes.

**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.

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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.

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.

**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**:

> [!WARNING]
>
> The Teacher Software uses the **Web Serial API**, which is only available in Chromium-based browsers. Firefox and Safari do not support Web Serial and will not be able to connect. Always use Chrome or Edge.

Once the Teacher Software is open:

1. Click **Add Student** and enter the student's name.
2. Select the correct **COM port** from the dropdown (on Windows it appears as `COMx`; on macOS/Linux as `/dev/tty.usbserial-xxxx` or `/dev/ttyUSB0`).
3. Leave the baud rate at the default **115200**.
4. Click **Connect**.

A green connected indicator appears next to the student's name. The live text feed for that student is now active — every character they type will appear here in real time.

**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:

* 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.

Congratulations — you have typed your first BrailleBridge character. The chord you pressed (`0b001001`, dots 1 and 4) is the standard Grade 1 Braille cell for the letter C, and BrailleBridge translated it exactly as written.

> [!NOTE]
>
> 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.

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).

## What's next

Now that you have a working setup, explore the full capabilities of each component.

> [card] [Hardware overview](https://braille.mintlify.site/hardware/overview.md)
>
> Dive into the GPIO mapping, bill of materials, 3D-printed enclosure, shift modifier layers, and the complete English and Bangla Braille dictionaries.

> [card] [Teacher Software overview](https://braille.mintlify.site/teacher-software/overview.md)
>
> Learn how to manage a multi-student roster, use Exam Mode to monitor a full class, export timestamped transcripts, and customise the interface.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.