Working with LSL#
BrainAccess Board uses the Lab Streaming Layer (LSL) to move signals between devices, applications and computers on the same network.
What Board sends#
Every connected device — BrainAccess hardware or a synthetic source — is published as an LSL data stream. Markers added in Board are published on a separate marker stream. Each data stream describes itself completely in its header: device model, serial number, firmware, channels, reference and ground electrodes, cap, electrode type and versions. The exact layout is the LSL contract (v1).
Because the description travels with the stream, a recording made anywhere keeps it:
another Board on a different computer that connects the stream,
LabRecorder (XDF files) or your own LSL client.
What Board receives#
Any LSL stream on the network appears on the Network card of the Connect screen. When you connect it, Board reads the stream’s header and saves that description with every recording of it.
A stream from another Board is recognised as a BrainAccess device: model, template, reference and ground are shown and recorded as if the device were connected locally.
A stream from another application keeps whatever its sender describes. Board reads the standard XDF fields (channel labels, types and units, positions, reference, cap, ground position, filters).
If a connected device’s description is incomplete, its card on the Connect screen shows a chip after the device name. Hover it to see what is missing:
Chip |
Meaning |
|---|---|
⚠ Metadata |
A required field is missing — usually the reference electrode of a stream from another application. Recordings work, but a BIDS dataset needs the value. |
Metadata (muted) |
Only recommended fields are missing (for example serial number, firmware, cap, electrode positions). |
BrainAccess devices and synthetic sources never show the chip.
Reading Board streams with other tools#
LabRecorder stores the full header in the XDF file.
pyxdf returns the header as a dictionary (
stream["info"]["desc"]).mnelab / LSL-to-BIDS tools read channel labels, types and units.
Channel types follow the contract (EEG, ACCEL, GYRO, …). Tools
that only know EEG types treat the other channels as miscellaneous.
Dropped samples#
If the device loses a packet, Board fills the missing samples with
zeros so the stream keeps its sample rate. Filled samples have
Streaming = 0; the Sample channel (the device’s own sample
number) keeps counting through them, and jumps only over a gap too
long to fill.
Two Boards on one network#
Every Board publishes its own marker stream named
BrainAccessBoardMarkers. Each Board identifies its own by a unique
source ID and records only its own markers. Run one Board per
computer.