Jump to content

Contributions:BrainFlow: Difference between revisions

From BCI2000 Wiki
Rlellis (talk | contribs)
Rlellis (talk | contribs)
No edit summary
Line 1: Line 1:
[[File:Brainflowpic.png|400px|thumb|right]]
==Synopsis==
==Synopsis==
This module integrates the data aquistion capabilities from [https://brainflow.readthedocs.io/en/stable/ BrainFlow] into BCI2000, allowing for compatibility with several new boards.
This module integrates the data aquistion capabilities from [https://brainflow.readthedocs.io/en/stable/ BrainFlow] into BCI2000, allowing for compatibility with several new boards.

Revision as of 22:05, 21 May 2024

Synopsis

This module integrates the data aquistion capabilities from BrainFlow into BCI2000, allowing for compatibility with several new boards.

BrainFlow Installation/Setup

Before installation, please install git bash and python. Note that VS2022 is not compatible with this module.


Automatic Installation

Note that instillation will take around 125MB. Also ensure that you are using VS2019.

Libraries generated from BrainFlow are needed for this module, which requires the user to download and build the project. The download/compilation process can be automated using this script located in SignalSource\BrainFlow:

All that needs to be done to use this scripts is: locate them in {BCI2000 Folder}\src\contrib\SignalSource\BrainFlow, and double click on "GenerateLibraries.bat". This will clone the BrainFlow repository into src\extlib. The script will build libraries for both debug and release configurations, so there will be two folders installed. Make sure to press enter when indicated. Do not exit the console until everything has finished installing--just follow the prompts given by the console. After each set of libraries are installed, you will be told to add the directories {BCI2000 Folder}\src\extlib\brainflowDebug\installed\lib and {BCI2000 Folder}\src\extlib\brainflow\installed\lib to your systems PATH (please follow this tutorial if you are unsure how to do this).

In CMake, make sure under "BUILD" that "BUILD_ALL_SOURCEMODULES" is selected. In the batch file to be used, append start executable BrainFlowADC --local to the line corresponding to the source module.

Parameters

BoardID

Identifier for the board in use, compatible with any board able to be used with BrainFlow.

RecordingChannels

Sets which board channels will be used for data acquisition. Some boards will not have all listed channel types, in which case no data will be collected from such types. If channels are found and ChannelNames is set to auto, listed channels will be given their designated names.


The following information might not be needed for specific boards. Search for your board here to see which parameters are necessary 

COM

Specifies the port the device is connected to (this must be found by the user--the program will not search ports to find which the device is connected to. Open your systems device manager to determine this) if needed. If not needed, leave as auto.

MAC

Specifies the MAC address of the device if needed. If not needed, leave as auto.

IPPort

Specifies the address of an IP port if needed. If not needed, leave as auto.

SerialNumber

Specifies the serial number of the device if needed. If not needed, leave as auto.