{"id":686,"date":"2017-07-30T19:34:02","date_gmt":"2017-07-30T17:34:02","guid":{"rendered":"http:\/\/jmladeno.net\/?p=686"},"modified":"2018-11-28T17:30:46","modified_gmt":"2018-11-28T16:30:46","slug":"openbci-ganglion-and-openvibe-for-dummies","status":"publish","type":"post","link":"https:\/\/jmladeno.net\/index.php\/2017\/07\/30\/openbci-ganglion-and-openvibe-for-dummies\/","title":{"rendered":"Connect OpenBCI Ganglion with OpenVibe for Dummies"},"content":{"rendered":"

Thanks to the community OpenBCI and Jeremy Frey<\/a> for your python codes accessible on github<\/a><\/p>\n

Connect Ganglion to Ubuntu 16.04 or other versions, via BLE bluetooth, then via LSL to OpenVibe and then via OSC to MAX\/MSP or PureData!
\nCHECK:
\nThe Ganglion<\/a>
\na tutorial for using ganglion<\/a>
\nOpenVibe<\/a>
\nJFREY’s Github<\/a>
\nMAX\/MSP<\/a> or
\nPureData<\/a> – open source<\/p>\n

Instructions for Dummies, non experts in typing terminal commands!!<\/p>\n

For this tutorial, Ubuntu 16.4 was used!!<\/p>\n

BEFORE STARTING:
\nInstall dependencies necessary for this to work!!
\nYou can copy line by line each of these terminal commands presented here in bold<\/strong>!!!
\nCopy here with Ctr-C, and paste in terminal with Ctr-Shift-V!!!
\nA hint for linux terminals, click on keyboard -arrowUp- to see all the previous commands you typed before and reuse them again with modifications!!!<\/p>\n

So, type or just copy\/paste in terminal:
\nsudo apt install git python-pip bluez-tools build-essential<\/strong>
\n(you will be asked to type in your password and to confirm the installations)<\/p>\n

*explanation:
\n1. git is needed so that you can download all the files from github of OpenBCI, with git clone
\n2. python-pip (pip is to install python libraries as we use python code to connect with ganglion)
\n3. bluez-tools (utilities for bluez – permits access to BLE bluetooth)
\n4. build-essential (to compile stuff – probably already exists in your system)<\/p>\n

—————————————————–<\/p>\n

Download files from openBCI
\n(think about where you want to download it), once you are there then type, copy\/paste in terminal:
\ngit clone –recursive https:\/\/github.com\/OpenBCI\/OpenBCI_Python.git<\/strong><\/p>\n

Go to the directory you downloaded, called OpenBCI_Python! To do so type or copy\/paste line by line (until –, so do not copy my explanations on the right) in terminal:<\/p>\n

cd OpenBCI_Python\/bluepy\/bluepy<\/strong> — enter into bluepy
\nmake <\/strong> — compile everything needed
\ncd ..\/.. <\/strong> — go back in the OpenBCI_Python folder and type:<\/p>\n

pip install -r requirements.txt<\/strong> (maybe sudo required, if so then type again:
\nsudo pip install -r requirements.txt<\/strong><\/p>\n

——————————————————————————————–
\n*reduce the latencies, EACH TIME YOU TURN ON COMPUTER* remember to copy\/paste this in terminal:<\/p>\n

sudo bash -c “echo 6 > \/sys\/kernel\/debug\/bluetooth\/hci0\/conn_min_interval”<\/strong>
\n*one line after the other, min before max!!*
\nsudo bash -c “echo 6 > \/sys\/kernel\/debug\/bluetooth\/hci0\/conn_max_interval”<\/strong><\/p>\n

these last 2 commands are necessary because you will lose too many packets from the board OpenBCI ganglion, as the latency of linux is much higher than the one required!! so you need to manually reduce it each time you turn on your computer as linux sets it by default back again! if 6 is too low for your computer type another – higher- value.<\/p>\n

——————————————————————————–<\/p>\n

if your system can’t automatically detect ganglion via Bluetooth devices than you need to type a command line to find the ganglion BLUETOOTH MAC address with:<\/p>\n

sudo hcitool lescan<\/strong><\/p>\n

it will give you an address, so select to copy (with mouse) the one indicated as ganglion, and just ***copy it by clicking Ctr-Shift-C<\/strong>**** on keyboard!
\nonce you copied the address of ganglion, then press:
\nCtr-C <\/strong> — to exit hcitool lescan!<\/p>\n

CONNECT TO GANGLION via BLE:
\nTYPE THIS, don\u2019t copy this line below, because you will loose the address you just copied earlier:<\/p>\n

python user.py –board ganglion -p<\/strong> *** here you will paste the address of ganglion you copied above with Ctr-Shift-V<\/strong>***<\/p>\n

***You do not need to retype each time the same command, just click on the UpArrow on your keyboard! (the MAC address is already typed once, so you don\u2019t need to type it again, so you can copy the next commands in this text below)<\/p>\n

python user.py –help<\/strong> — here you see what you need to type to connect to openBCI boards!<\/p>\n

COMMAND TO SEND LSL TO OPENVIBE:
\n(-Uparrow- on the keyboard, and just add -a streamer_lsl) giving:<\/p>\n

python user.py –board ganglion -p<\/strong> *ganglion address* -a streamer_lsl<\/strong><\/p>\n

*if we use multiple LSL at the same time* need to name each lsl as:
\npython user.py -a streamer_lsl ganglion2_eeg ganglion2_id<\/p>\n

NB *** If you use WIFI at the same time as bluetooth, it can create a bit of interference!
\n——————————————————<\/p>\n

To stream data from ganglion, type:<\/p>\n

\/start<\/strong> — you will see nothing happening for a while, but it is working!! then it will lose some packets, drop packet, which is normal!<\/p>\n

if you wish to stop streaming type:
\n\/stop <\/strong> –keep typing even if you dont see what you are typing as the packets keep coming at she same time!
\nTo take off some electrodes you do not wish to measure, just type
\n2
\n3
\n4<\/strong>
\ntake off each channel you do not use! one by one!
\nIn this example we use only channel 1 for recording!<\/p>\n

——————————————————————
\nNEW TERMINAL FOR OPENVIBE ACQUISITION SERVER:<\/p>\n

To use openvibe acquisition server, you need another terminal, find where you installed openvibe and type:
\ncd openvibe-<\/strong>1.3.0-src, or the version you have, then go to dist
\ncd dist<\/strong>
\n.\/openvibe-acquisition-server.sh<\/strong> — RUN IT!!<\/p>\n

*** an advice, these names are very long, and to help you with this, type only a few first letters, and then click on Tab key to autocomplete the name of the files!!! here eg, openvibe- acq Tab and it will fill the rest \ud83d\ude42<\/p>\n

Once you are in
\nacquisition server<\/strong>
\n– change the Driver into LabStreamLayer (LSL)<\/strong>
\n– go to driver properties (signal stream — EEG_id (lsl)<\/strong>)
\n– go to preferences (augment drift tolerance — 100<\/strong>? if not using ERPs which need a smaller value)
\n– change sample count per sent block — 4 <\/strong>– if computer is strong! default is 32 — sends 32 chunks to the designer, if we put 4 chunks, it sends more frequently… it also needs to be synced with the sampling rate of BLE ganglion (200Hz), so 4 is good!!!<\/p>\n

**if multiple ganglions on one PC, need to change connection port (use 2 openvibe acquisition servers)<\/p>\n

——————————————————————————————
\nNEW TERMINAL FOR OPENVIBE DESIGNER:<\/p>\n

To use openvibe designer, you need to use another terminal, and type:
\ncd openvibe-1.3.0-src<\/strong> , or another version you have installed.
\ncd dist
\n.\/openvibe-d Tab<\/strong>, it will auto-fill the rest giving
\n.\/openvibe-designer.sh<\/strong> — RUN IT
\nOnce you are in the
\ndesigner:<\/strong>
\nopen a file and you will automatically be in scenarios, which give many examples and tutorials!!
\nScenario Neurofeedback, or scenarios for Motor Imagery or for P300!!<\/p>\n

In openvibe designer, there is an OSC controller box, you should add if you want to send data to a sound editing program such as MAX\/MSP, or PureData!
\nDouble click this box and specify the Ip address you send the data to – if the receiver is another computer like a Mac or windows which has MAX.
\nIn the receiving party, there is no need to specify the ip address of the sender!! Only the port specified in the OSC box! however if you are using the sound design on your own computer there is no need to specify any address, it is set by default.<\/p>\n

** command linux to find IP address: ifconfig<\/p>\n","protected":false},"excerpt":{"rendered":"

Clear STEPS to connect the OpenBCI Ganglion board to a Ubuntu 16.04 linux, via BLE bluetooth! And then via LSL to OpenVibe!!
\nFor those who really don’t know anything about terminal commands.<\/p>\n","protected":false},"author":2,"featured_media":691,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-686","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog"],"_links":{"self":[{"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/posts\/686","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/comments?post=686"}],"version-history":[{"count":24,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/posts\/686\/revisions"}],"predecessor-version":[{"id":1195,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/posts\/686\/revisions\/1195"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/media\/691"}],"wp:attachment":[{"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/media?parent=686"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/categories?post=686"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jmladeno.net\/index.php\/wp-json\/wp\/v2\/tags?post=686"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}