Connect a headset#

The device list is the app’s home screen — its title bar reads BrainAccess. It is where you find headsets over Bluetooth, connect to them, reconnect to ones you have used before, and open a connected headset’s Config to set sample rate, gain, channels and electrode labels. You land here when the app opens, and every other screen returns you here.

Top bar#

Control

What it does

Theme icon

Cycles the app theme: System → Light → Dark → System. Remembered.

⋯ / More → About

App name, version, supported families, EULA, Privacy Policy, open-source licences and hidden diagnostic controls

Bottom bar#

Control

What it does

Scan / Stop scan

Starts or stops a Bluetooth scan. A spinner runs while scanning. Disabled while Bluetooth is off.

Recordings

Opens the recordings and snapshots browser (see Recordings and review)

You can also pull down the list to start a scan.

Scanning#

  • The app scans once automatically when you first reach the device list (Bluetooth on, permission granted, nothing connected or already found).

  • Every scan stops on its own after 30 seconds. Scanning takes airtime away from headsets that are already streaming, so it is deliberately not left running.

  • While scanning and nothing is found yet: Looking for devices… with guidance to turn the headset on.

  • After the scan ends with nothing found: No devices found with a Scan again action.

Discovered devices#

One card per headset in range, closest first:

  • headset name (or (unnamed)),

  • signal-strength bars plus MODEL · -NN dBm,

  • a Connect button, replaced by a spinner while connecting.

Remembered headsets#

The app remembers your last four headsets using iOS’s opaque CoreBluetooth peripheral UUID and the display name seen on this phone. When a remembered headset is not connected and not currently visible in the scan, you get a card to reconnect it; with more than one, an extra Reconnect all card appears. Each card can also be forgotten.

Tapping a reconnect card connects immediately if the headset is already visible, otherwise it scans for it first. If Bluetooth is off or permission is missing, the tap takes you through that requirement first. A reconnect attempt gives up at the scan timeout instead of scanning forever.

The connected-headset card#

Once you connect, the headset gets its own card at the top of the list:

BA MAXI 000                                   [ Ready ]
Peripheral UUID · 32 ch
[ 45% ] [ 250 Hz ]                       [ 30/32 good ]
gain 8 · 32/32 active

[ Stream ]   [ ● Rec ]   [ Impedance ]
--------------------------------------------------
Config       Firmware       Disconnect

Line / control

Meaning

Name and UUID · channel count

Names come from the headset’s Bluetooth advertisement. iOS does not expose a BLE MAC address to apps.

Status pill

Connecting…, Discovering…, Ready, Streaming, Recording, Updating…, Disconnected, or Error: …

Battery chip

Battery percentage, or — if not reported yet. Turns amber at 15% or less while not charging

Sample-rate chip

The configured rate

N/M good chip

Appears while streaming: how many electrodes currently read good signal, dotted with the worst band’s colour. Tap it to open Signal quality

Update amber pill

Appears when newer firmware is available. Tap for Firmware updates

gain N · A/T active

Amplifier gain and how many channels are switched on

Status line

streaming, or recording · BDF / recording · CSV, plus N samples lost if any data was dropped

Stream

Starts streaming and opens the Live signal viewer

● Rec

One tap: starts streaming and recording, staying on the device list

Impedance

Contact check (only when not streaming) — see Contact check

View / Stop / Quality

Shown while streaming

Config

Device settings — only while not streaming

Firmware

Firmware and device info — only while not streaming, and only on headsets that support updates

Disconnect

Drops the link. While recording it reads Stop & disconnect and asks first

The amber Update badge opens firmware information even while streaming. The update action inside that screen remains blocked until streaming/recording stops.

While a stream runs in the background, a bar above the bottom buttons shows Streaming · (or Streaming N devices) with a REC badge if any device is recording. Tap it to jump back into the Live signal viewer.

Device settings (Config)#

Tap Config on a connected, non-streaming headset. It opens a bottom sheet. Tap the Channels summary to replace the form with the channel editor; Done returns to the form without writing to the headset. All, None and Invert change the active selection; cap headsets also have Reset labels. Labels already assigned to another channel are unavailable. Drag the sheet upward or scroll for long lists.

Setting

Options

Sample rate

250 Hz or 500 Hz; HALO V3 also 1000 Hz; EXG8 also 1000 Hz and 2000 Hz. The choices follow the headset’s board, so a development unit on the EXG8 board that still advertises as MINI also offers all four. A new rate takes effect the next time you start streaming

Gain (all channels)

1x, 2x, 4x, 6x, 8x, 12x. If the headset currently has different gains per channel the header reads Mixed

Channels

One checkbox per channel. The header shows how many are active

Electrode labels

On cap headsets (MINI, MIDI, MAXI, EXG8) tap a channel’s label to reassign it from the 10-20 set. HALO has fixed labels, so its labels are read-only

Auto power-off when idle

Minutes (1–255) the headset stays on with no phone connected before it switches itself off; the headset’s own setting is 20. Shown only on headsets whose firmware supports it

Apply writes the configuration to the headset and saves it on the iPhone for that headset; it is disabled if no channel is active. Cancel changes nothing. Electrode labels drive the viewer rail, head maps and recording columns/signals, so set them correctly before you record.

Auto power-off when idle is remembered per headset too. The headset forgets it every time it powers off, so once you have set a value the app writes it back to that headset each time you connect. Until you set one, the app leaves the headset’s own setting alone. The timer only runs while no phone is connected, so it does not interrupt a session. Apply is disabled while the field holds a value outside 1–255.

See also#