Documentation Index
Fetch the complete documentation index at: https://docs.elata.bio/llms.txt
Use this file to discover all available pages before exploring further.
MuseBleDevice
MuseBleDevice is the low-level Web Bluetooth class that handles device pairing, GATT characteristic subscriptions, and packet decoding. BleTransport wraps it to provide the normalized HeadbandTransport interface.
You typically do not use MuseBleDevice directly. Use BleTransport instead.
Supported Protocols
| Protocol | Headbands | EEG Channels | Extra Data |
|---|---|---|---|
| Classic | Muse 2, Muse S (classic) | 4 (TP9, AF7, AF8, TP10) | PPG (3 channels) |
| Athena | Muse S (Athena firmware) | 8 (TP9, AF7, AF8, TP10, AUX1-4) | Optics, accgyro, battery |
Classic Protocol
Classic Muse headbands expose 4 EEG channels at 256 Hz. Each channel has its own GATT characteristic:| Characteristic | Channel |
|---|---|
273e0003-... | TP9 |
273e0004-... | AF7 |
273e0005-... | AF8 |
273e0006-... | TP10 |
PPG1, PPG2, PPG3).
Athena Protocol
Athena headbands use a different packet format with two main characteristics:| Characteristic | Data |
|---|---|
273e0013-... | EEG (8 channels, multiplexed) |
273e0014-... | Auxiliary (optics, accgyro, battery) |
MuseDeviceOptions
MuseBoardInfo
Returned bygetBoardInfo() after connection:
Browser Compatibility
| Browser | Platform | Status |
|---|---|---|
| Chrome 56+ | Windows, macOS, Linux, Android | Supported |
| Edge 79+ | Windows, macOS | Supported |
| Opera 43+ | Desktop | Supported |
| Safari | macOS, iOS | Not supported |
| Firefox | All | Not supported |
Safari/iOS Workarounds
Three strategies for iOS support:- Native app shell (recommended): implement BLE in Swift with CoreBluetooth, bridge frames to web UI
- Companion bridge: native app streams frames over WebSocket/WebRTC to the web app
- Hybrid WebView:
WKWebViewwith native message handlers for BLE
HeadbandFrameV1 schema as the interface boundary so browser and native transports emit the same frame shape.
Next
EEG BLE Getting Started
Transport API and connection guide
Headband Transport
Frame schema and transport interface