Troubleshooting#
macOS#
“BrainAccess Board” cannot be opened / Apple could not verify it. Open System Settings → Privacy & Security and click Open Anyway; see Installation (Opening it the first time).
No headsets appear on the Connect screen. Board was not allowed to use Bluetooth. Turn on BrainAccess Board in System Settings → Privacy & Security → Bluetooth, then restart Board.
The Ctrl+… shortcuts do nothing.
Use the Control (⌃) key, not Command (⌘).
Connecting#
My headset isn’t in the list. Power it on and bring it closer to the computer, then click “Scan for more devices”. Remember the scan pauses while another device is connected.
The device row is dimmed with “Last seen N s ago”. The device stopped advertising — usually powering off, out of range, or low on battery. Charge it / bring it closer; the row becomes active again when the device reappears.
Connecting fails. The row shows the reason with a Retry button:
Connection timed out — out of range, or the Bluetooth adapter was busy; try again.
Could not connect — check the device is nearby and charged.
Device is already connected — another program (or another Board window) is holding it. Close the other consumer first.
Lost connection to the backend during connect — a temporary hiccup; retry.
A connected device drops off the list. The link dropped (power, range, or the stream ended). There is no visible “Offline” label — Board removes the device automatically when the link drops. Reconnect from its card once the device is back.
No LSL streams are listed under Network. Make sure the producing application is running and on the same network, and that the stream isn’t already connected.
A firmware update said the device dropped the link, or the headset switched off after an update. That is how the update ends: the headset installs the firmware and restarts switched off. Long-press it to switch it on and connect it; the banner then says whether the update installed. See Firmware updates.
Recording#
“Start recording” is greyed out. Either no source is connected (open Connect first) or a form field is invalid — check for messages like “Run must be an integer ≥ 1”.
Converting#
“Cannot convert to BIDS — no subject …”
The listed files are not named like Board recordings
(subj-<n>_…) and are not inside a sub-<n> folder, so they have no
participant ID. Untick them (or narrow the search pattern, e.g.
subj*), click “Dismiss”, and convert again.
“Cannot convert to BIDS — no task …” BIDS needs a task for every recording. Type one in “Task for files without one” (BIDS options) and convert again.
“Conversion complete (… run number(s) reassigned …)” or “(… duplicate
file(s) … skipped)”.
Nothing went wrong. Recordings sharing a run number were numbered by
recording time, and BDF files exported from a selected .db were left
out because the .db itself was converted.
Viewing#
The viewer doesn’t show current data.
You are looking at history — click the Latest chip or press
Space to re-follow the live edge.
A channel is flat or looks wrong. Check its electrode contact using Impedance mode on the Connect screen. In the viewer you can hide a bad channel with the eye toggle in the channel rail.
Constant 50/60 Hz noise on every channel. That’s mains hum — enable the Notch chip (pick 50 or 60 Hz to match your region’s mains frequency).
Apps#
SSVEP arrows / P300 experiment won’t launch. These two experiment apps require PsychoPy to be installed on your system.
Getting help#
When you contact support, three things speed everything up:
Your version — shown in the footer of the Resources screen.
The diagnostics dump — press
Ctrl+Alt+D(⌃⌥D on a Mac) to open the diagnostics panel and use its Copy to clipboard button; paste the result into your report.Log files — open Folders → Logs and attach the recent files.
Reach the team via Resources → Contact us, the report form in the Ask Jena (chat assistant) panel, or brainaccess@neurotechnology.com.