Installation#

Prerequisites#

  • desktop MATLAB R2025b or newer

  • the platform-specific .mltbx toolbox package

  • Bluetooth support on the machine

Install the Toolbox#

The recommended user install path is the packaged platform-specific .mltbx toolbox.

  1. Download the toolbox package for your platform.

  2. Install it by double-clicking the .mltbx file, or from MATLAB:

matlab.addons.toolbox.installToolbox("brainaccess-matlab-api-<platform>-<version>.mltbx");

  1. Start MATLAB and initialize the API:

ba_setup();
ba_init();
devices = ba_scan()

On Linux, the packaged toolbox still expects the system runtime libdbus-1.so.3 to be available.

Bluetooth Connection Setup#

  • Turn on the BrainAccess device.

  • Use the Bluetooth name printed on the device label.

  • Do not pair the device in the operating system Bluetooth settings. The BrainAccess API manages the connection directly.

First Connection Check#

After installation, a minimal first check is:

ba_setup();
ba_init();
devices = ba_scan();
disp({devices.name});
ba_close();

If you see your device name in the scan results, continue with the examples in Usage.