Link to the release of the library as of March 13, 2024
Unfortunately this is an unsigned package so it may not work on your Mac until you allow it in your security settings.
***** The following documentation was written for the Moxsonic conference in March 2024, using the OpenBCI Ganglion/Cyton board as the EEG hardware. *****
First, download the BioSignal library from the link above.
To make the EEG hardware work with your computer, install OpenBCI GUI: https://openbci.com/downloads
Steps to add the BioSignal External Package to your Max:
Once you have the BioSignal external zip file downloaded, unzip it. Then add the "bs.externs" folder to your Max Packages folder:
``` Users / your_username / Documents / Max 8 / Packages ```
Then, in the Max Package Manager, you should see "bs.externs" under the installed packages menu.
If your Max looks like this, you're good to go! The three objects included in the library in its current state are ```bs.upsample~```, ```bs.fft~```, and ```bs.leaky_integrator~```. We will go over these in the workshop! Here is a link to my slides for your future reference: https://docs.google.com/presentation/d/1lJjt-IbuzJHRGvhkO0voZgk0wQ6PEVszWW4YU3VxW-U/edit?usp=sharing
## Steps to run OpenBCI_GUI to send LSL on your computer:
0.) MAKE SURE YOUR BOARD IS OFF. No lights should be on. Then plug in the USB dongle and open OpenBCI GUI.
1.) Under "DATA SOURCE" pick "Ganglion" if you have the blue board or "Cyton" if you have the white one.
2.) Transfer protocol is "Bluetooth (BLED112 Dongle) for the blue board (Ganglion), or "Serial (from Dongle)" for the white one (Cyton).
3.) Turn on your board using the switch on the side. Select the correct device if you are using the Ganglion board. For Cyton, do the switch that says "PC" and NOT the switch that says "BLE".
4.) Under "BRAINFLOW STREAMER" click "Network"
### Cyton settings:
### Ganglion settings:
5.) Hit START SESSION
6.) Click "START DATA STREAM"
7.) Under "LAYOUT" click the 4-square-panels button
8.) Change the accelerometer to "Networking"
9.) Select "LSL" as the protocol
10.) Under "Stream1" select "Time Series Raw" to send the raw data on your computer's LSL port.
11.) Click "Start LSL Stream" to start the stream!
11.) (optional) if you want, change the fourth window in the view to be "Band Power":
12.) Now you should have OpenBCI GUI fully set up and running. If you are wearing a headset, you will be able to see your brainwaves in the GUI. You should be sending LSL on your computer now as well, so we can open Max and check with one of the externals.
13.) Open Max and create an object: ```bs.upsample~ 4``` <- (for Cyton, do ```bs.upsample~ 8```, Ganglion does 4)
14.) You should be able to get the EEG signal out of the outlets! Turn on DSP and attach a live.scope~ object to outlet 1. If it looks empty, attach a number~ object to see what values it is outputting.
15.) Check the help files for bs.upsample~, bs.fft~, and bs.leaky_integrator~. Have fun!