Arquivos
Docs/Tutorials/01-Cyton_Getting Started_Guide.md
AJ Keller 0a955d6de0 Merge pull request #114 from winhowes/patch-1
Update 01-Cyton_Getting Started_Guide.md
2018-03-13 06:41:35 -04:00

36 KiB
Arquivo Executável

Cyton Getting Started Guide

This guide will walk you through setting up your computer to use the Cyton and USB Dongle, using the OpenBCI_GUI Application, and how to get EEG/EMG/EKG from your own body!

I. What You Need

  1. OpenBCI Cyton Board
  2. OpenBCI Dongle
  3. OpenBCI Gold Cup Electrodes and Ten20 Paste
  4. 6V AA battery pack & (x4) AA batteries (batteries not included)
  5. (x4) plastic feet for board stabilization

1. Your Board

This tutorial can be followed if you are working with any Cyton board (8-bit, Cyton, or Cyton with Daisy). I'll be working with the 8-bit board.

2. Your OpenBCI USB Dongle

The OpenBCI USB Dongle has an integrated RFDuino that communicates with the RFDuino on the Cyton board. The dongle establishes a serial connection with your computer's on-board FTDI chip. The serial port is called /dev/tty* (if you're using Linux or Mac) or COM* (if you're using Windows). You'll be connecting to this serial port from the OpenBCI GUI or whatever other software you want to end up using to interface your Cyton board.

3. OpenBCI Gold Cup Electrodes and Electrode Paste

If you ordered an OpenBCI Gold Cup Electrodes and Ten20 Paste you should have:

  • 10 passive, gold cup electrodes on a color-coded ribbon cable
  • 3 2oz Jars of Ten20 conductive electrode paste

If you plan to work with your own electrodes, the touch-proof adapter may come in handy:

It will convert any electrode that terminates in the industry-standard touch-proof design to an electrode that can be plugged into any OpenBCI Board!

4. Your 6V AA Battery Pack & 4 AA Batteries

Cyton boards have specific input voltage ranges. These input voltage ranges can be found on the back-side of the board, next to the power supply. BE VERY CAREFUL to not supply your board with voltages above these ranges, or else you will damage your board's power supply. For this reason, we recommend that you always use the battery pack that came with your OpenBCI kit.

5. (x4) Plastic Feet

Your Cyton kit comes with 4 plastic feet that can be snapped into the holes of your board to provide extra stability while working.

II. Download/Install/Run the OpenBCI GUI

Please follow the step by step guide to install the OpenBCI_GUI as a standalone application. Keep an eye out for specific Cyton requirements such as installing the FTDI VCP driver.

Come back to this guide when your GUI is running!

III. Prepare your OpenBCI Hardware

1. Make sure your FTDI drivers are installed and up-to-date

The Cyton will not work without the VCP drivers. Please see how to get and install the VCP driver in the prerequisites section in the the step by step guide

2. Plug in your OpenBCI USB Dongle

Plug this in (facing upwards!) and you should see a blue LED light up.

Note: make sure your USB Dongle is switched to GPIO 6 and not RESET. The switch should be set closer to your computer as seen in the picture to the right.

3. Plug in your 6V AA battery pack (with batteries)

Cyton boards have specific input voltage ranges. These input voltage ranges can be found on the back-side of the board, next to the power supply. BE VERY CAREFUL to not supply your board with voltages above these ranges, or else you will damage your board's power supply. For this reason, we recommend that you always use the battery pack that came with your OpenBCI kit. There's a good reason we put this notice in here twice!

4. Switch your Cyton board to PC (not OFF or BLE)

Make sure to move the small switch on the right side of the board from "OFF" to "PC". As soon as you do, you should see a blue LED blink 3 times (if youre using the 8-bit board; the Cyton version doesnt blink). If you don't, press the reset button just to the left of the switch. If the LED still does not blink 3 times, make sure you have full battery. If you're sure your batteries are fully charged, consult the hardware section of our Forum.

Note: it's important to plug in your Dongle before you turn on your Cyton board. Sometimes, if the data stream seems broken, you may need to unplug your USB Dongle and power down your Cyton board. Make sure to plug your USB Dongle in first, then power up your board afterwards.

IV. Connect to your Cyton board from the GUI

1. Relaunch your OpenBCI GUI

You may need to relaunch the OpenBCI GUI after installing the FTDI drivers.

2. Select LIVE (from Cyton)

In order to connect to your Cyton, you must specify the data source to be LIVE (from Cyton) in the first section of the System Control Panel. Before hitting the START SYSTEM button, you need to configure your Cyton board (follow the steps below).

3. Select Serial Transfer Protocol

Next select Serial (from Dongle). If you want to use the WiFi Shield, please see the WiFi Getting Started Guide

4. Find your USB Dongle's Serial/COM port

In the first section of the LIVE (from Cyton) sub-panel, find your Dongle's Serial/COM port name. If you're using a Mac or Linux, its name will be in the following format:

/dev/tty*

If you're using Windows, it will appear as:

COM#

Your USB Dongle's port name will likely be at the top of the list. If you don't see it:

  1. Make sure your dongle is plugged in and switched to GPIO 6 (not RESET)
  2. Click the REFRESH LIST button in the SERIAL/COM PORT section of the sub-panel
  3. Make sure you've installed the latest FTDI drivers, as described in section III.1

If you're still having trouble finding your USB Dongle's port name, refer to the Forum about debugging your hardware connection.

5. Select your channel count (8 or 16)

The CHANNEL COUNT setting is defaulted to 8. If you are working with an OpenBCI Daisy Module and Cyton board (16-channel) system, be sure to click the 16 CHANNELS button before starting your system.

6. Optional Settings

If you're comfortable using the GUI, feel free to change some of these optional settings below. Otherwise, skip to step 7!

Check Status or Change Radio Channel

There is a Radio Configuration tab that you can use to check the status of your Cyton system and change the radio channel. Click on the > arrow to open up the options panel. Here you will find tools for configuring your Cyton Radio connection. Let's walk through the functions of each button.

Click on the STATUS button to check the status of your Cyton system. This may take a few seconds to report, as it reaches out to your Dongle and Cyton board to verify that they are talking to eachother. If they are, you will see the message Success: System is Up. If not, you will see Falure: System is Down.

Click the GET CHANNEL button to know the channel that your Cyton system is communicating on. If the system is up, you will get the message Success: Host and Device on Channel number: X. If the system is down, you will get the message Failure: Host on Channel number: X.
NOTE the Host radio is on the Dongle, and the Device radio is on the Cyton board.

Click on the CHANGE CHANNEL button to change the channel that your Cyton system is communicating on. This can be really useful if you have multiple Cyton systems in the same space. When you click the button, a menu will open up with the channels. When you click on the channel you want, it will take just a second, and you should get the message Success: Host and Device on Channel number: X.
IMPORTANT Make sure that there are not other Cytons active in the neighborhood when you change the channel!

Click on the OVERRIDE DONGLE button to change the channel of the OpenBCI Dongle only. When you click the button, a menu will open up with the channels. For the purpose of this Tutorial, go ahead and change the Dongle channel to Channel 15. When you click on the channel number, it will take just a second, and you should get the message Success: Host override - Channel number: 15

Since you have just changed the channel of the Dongle only, When you click on the STATUS button, you will get a failure message. Similarly, when you press the GET CHANNEL button you will also get a failure message. But don't worry! We can use the Autoscan function to get your Cyton Board and Dongle back on the same track!

Now, click the AUTOSCAN button. It may take a few seconds for the Dongle to scan through every channel until it connects to your Cyton, but it will, and you will get the message Success: System is Up Autoscan!

Edit the Playback file name

File Name

In the DATA LOG FIlE section of the LIVE (from Cyton) sub-panel you can specify the name of your playback file. This file name is automatically defaulted to:

SavedData\OpenBCI-RAW- + date/time

You can edit the the name of this file by clicking in the "File Name" text field.

If you're running the OpenBCI GUI from Processing. This file will be saved at the root of your OpenBCI_GUI directory.

If you're running the OpenBCI GUI as a standalone application, this file will be saved in /Contents/Java/Data/EEG_Data/

If working from a Mac, you'll need to right-click on the OpenBCI_GUI application and then select "show package contents" to see the /Contents directory where your playback files are saved.

After creating a Playback file, it can be replayed by running the OpenBCI GUI with the Plaback File data source mode. As a result, you can easily share recorded OpenBCI Playback files with your friends and colleagues.

Select your SD setting

WRITE TO SD

If you want to log data to a MicroSD inserted into the Cyton Board, in the WRITE TO SD (Y/N)? sub-panel section you can select the maximum recording time of the file. This setting is defaulted to "Do not write to SD…" and will automatically switch to this if you do not have a MicroSD card properly inserted into your Cyton board.

Note: be sure to select a file size that is larger than your planned recording time. The Cyton writes to the local SD in a way that enables us to write lots of data very quickly. As a result, however, we must specify how large the file will be before we begin. The technique is known as block writing.

7. Press "START SYSTEM"

START SYSTEM

Now you're ready to start the system! Press the START SYSTEM button and wait for the OpenBCI GUI to establish a connection with your Cyton board. This usually takes ~5 seconds.

Initializing

During this time, the help line at the bottom of the OpenBCI GUI should be blinking the words: "Attempting to establish a connection with your OpenBCI Board..."

TROUBLESHOOTING

If the initialization fails, try the following steps in order:

  1. Making sure you've selected the correct serial/COM port
  2. Power down your Cyton board and unplug your USB Dongle. Then, plug back in your USB Dongle and power up your Cyton board in that order. Then try restarting the system, but pressing the START SYSTEM button again.
  3. If this does not work, try relaunching the OpenBCI GUI application and redo step 2 above. Then reconfigure the SYSTEM CONTROL PANEL settings, and retry START SYSTEM.
  4. Make sure that your batteries are fully charged and then retry the steps above.
  5. If you are still having troubles connecting to your Cyton board, refer to the Forum for extra troubleshooting advice.

8. Your Cyton is now live!

Now that the OpenBCI_GUI is connected to your Cyton you may press Start Data Stream in the upper left hand corner.

cyton serial data stream start

You should see data streaming into the GUI, try running your fingers along the electrode pins at the top of your board.

Touch

You should see the 8 (or 16 if you're using a Daisy module) channels on the Time Series widget behave chaotically in response to you touching the pins and all the traces of the FFT graph on the upper right should instantly shift upwards.

cyton serial chaos

If this is the case, congratulations; you are now connected to your Cyton board. It's time to see some brain waves!

V. Connect yourself to OpenBCI

In this quick demo, we'll be showing you how to set up 3 channels of electrophysiological data that reveal your heart activity (EKG or ECG), muscle activity (EMG), and brain activity (EEG)!

For more information on these three signals, refer to wikipedia:

1. What you need

What You Need

Necessary:

  • Ten20 conductive electrode paste (or other conductive electrode gel)
  • Your Cyton board, USB Dongle, battery pack, and x4 AA batteries
  • x6 gold cup electrodes (from your OpenBCI electrode starter kit or other). If you are using an OpenBCI electrode starter kit, use the following electrodes so as to be consistent with the GUI's color-coding protocol:
    1. Black
    2. White
    3. Purple
    4. Green
    5. Blue
    6. Red

Optional:

  • Paper towels for cleaning excess Ten20 paste
  • Medical tape (or other tape) for adding extra stability to electrodes
  • Ear swabs for cleaning paste from electrodes, once you're finished

2. Connect your electrodes to OpenBCI

Connect the electrode wires to your Cyton board as shown below. The proper wire connections are shown in table form as well.

Electrode Connections 1

Electrode Wire Color Cyton Board Pin
white SRB2 (bottom SRB pin)
black bottom BIAS pin
purple 2N (bottom N2P pin)
green 4N (bottom N4P pin)
blue 4P (top N4P pin)
red 7N (bottom N7P pin)

The white and black electrodes must always connect to the SRB2 pin and the bottom BIAS pin. Also, the green and blue wires must be connected to two pins of the same channel (like 4N and 4P). But the purple, red, and green/blue wires can be connected to any of the N1P through N8P channels. We decided to use channels 2, 4, and 7 for this tutorial.

How Cyton Board Pins are Connected (Optional)

Below is a perspective view of the electrode inputs that we are working with in this tutorial:

Electrode Connections 2

The bottom pins are (N) inputs, and the top pins are (P) inputs. The default board settings look at all N channels in reference to SRB2 (the bottom SRB pin). SRB1 (the top SRB pin) can also be used as a reference, but when it is activated, it is activated for ALL channels. If using SRB1 as the reference electrode, P inputs (the top pin inputs) must be used as the other input of the potential difference measurement. On the contrary, individual channels can be removed from SRB2. If a channel is removed from SRB2, it can be examined as a unique voltage potential, between the N and P pins of that channel. We will be doing this for the heart measurement in this tutorial, while examining 2 EEG channels in reference to SRB2, using the channel 2 and 7 N pins. For more information on this, refer to page 16 of the ADS1299 datasheet. The ADS1299 chip is the analog front-end at the core of the Cyton board.

3. Connect your electrodes to your head and body

Electrode Paste

a) We're going to start with the electrodes on your head. Begin by scooping Ten20 electrode paste into your white gold cup electrode. This is going to be your reference (or SRB2) electrode for the other electrodes on your head. Fill the electrode so there is a little extra electrode paste spilling over the top of the gold cup, as seen in the picture to the right.

Note: Use a paper towl or napkin to remove excess electrode paste as you are applying your electrodes.

SRB2

b) Now apply this electrode to either one of your earlobes (either A1 or A2 as seen on the 10-20 system image below). You can use some medical tape (or electric tape!) to give this electrode some extra stability, ensuring that it does not fall off. This electrode is the reference that all of the EEG electrodes on your head will be measured in comparison to. The uV reading that will appear in the GUI's EEG DATA montage is a measure of the potential difference between each electrode and this reference electrode (SRB2). SRB1 (the top SRB pin) can also be used as a reference pin, but we won't discuss that here. Check out the other docs on how to maximize the usage of the other pins!

Fp2

c) Follow the same procedure for the purple electrode and apply it to your forehead 1 inch above your left eyebrow (as if you were looking at yourself) and an inch to the left of your forehead's centerline.

1020

This electrode location is Fp2 on the 10-20 System. The 10-20 System international standard for electrode placement in the context of EEG. Fp indicates the a "frontal polar" site.

O1

d) Now follow the same procedure for the red electrode and place it on the back of your head, 1 inch above the inion (as seen on the 10-20 system), and 1 inch to the left. This electrode location is O1 on the 10-20 system. The 'O' stands for occiptal, meaning above your occipital lobe (or visual cortex).

Note: to do this, pull your hair aside and make sure the electrode is nested as deeply as possible, with the electrode paste making a definitive conductive connection between your scalp and the gold cup.

headband

e) Now follow the same procedure as step 2 above to apply the black electrode to your other earlobe (either A1 or A2 from the 10-20 system). The black electrode is connected to the BIAS pin, which is used for noise cancelling. It is similar to a GROUND pin, which establishes a common ground between the Cyton board and your body, but it has some extra destructive interference noise cancelling techniques built in!

You're now done connecting electrodes to your noggin! I like to use a cheap cotton hairband to add extra stability to all of the electrodes connected to my head, by placing it gently on top of all of the electrodes.

forearm

f) Now connect the green electrode to your right forearm, somewhere on top of a muscle that you can flex easily. With this electrode we will be looking at both heart activity and muscle activity. I also like to use tape to hold this electrode in place. That's going to hurt a little bit to take off. Hopefully your arms aren't as hairy as mine...

wrist

g) Finally, connect the blue electrode to your wrist on the opposite arm with the green electrode. The blue electrode will serve as the reference electrode for the green electrode. If you noticed, the blue electrode is on the pin above the green electrode. We will be removing pin 4 from SRB2 so that it is not included in the same reference signal being used to measure brain waves. The main reason for this is because the microvolt (uV) values produced by your heart and muscles are much stronger than the signals we can detect from your brain, so we don't want these signals to interfere. I'll go into more detail about this later on, when it comes time to adjust the channel settings in the GUI.

4. Launch the GUI and adjust your channel settings

a) If your OpenBCI GUI is not already running, relaunch it and configure the DATA SOURCE mode to LIVE (from Cyton) and Serial (from Dongle). Select your Cyton board from the list of devices, set the Channel Count to 8, and click START SYSTEM. Refer to section IV of this guide for more information on this process.

If you're using the Daisy Cyton board, still set the Channel Count to 8, even though the Daisy has 16 channels. Nothing will go wrong if you start the system with 16 channels, except the EEG DATA display will be unnecessarily cluttered.

b) Click START DATA STREAM to begin streaming data from your board. You should see live data from your body (and the unattached channels) streaming into the EEG DATA montage on the left side of the GUI.

Power Down

c) Now we are going to power down the channels we aren't using. Do this by clicking the circular channel number buttons outside of the left side of the EEG DATA montage. Each time you power down a channel, the channel will show a burst of signal and then settle at 0 mV.

Signals At Start

We are only using channels 2, 4, and 7, so power down every other channel. You can also power down the channels with keyboard shortcuts (1-8). Power them back up with [SHIFT] + 1-8. If you are working with a daisy module, channels 9-16 can be powered down with q, w, e, r, t, y, u, i, respectively. You can power those channels back up with [SHIFT] + the same key.

Don't bother with the ohm symbols to the right of the buttons with numbers; they are used for impedance measuring, but we won't go into that now.

e) Now it's time to optimize your Cyton board's channel settings for this setup. Click the CHAN SET tab to the right of the EEG DATA tab, and an array of buttons should appear of the EEG DATA montage:

Adjust Channel Settings

These buttons indicate the current settings of the ADS1299 registers on your Cyton board. For more information on these settings, refer to pages 39-47 of the ADS1299 datasheet.

We have simplified the interface through the OpenBCI firmware and OpenBCI GUI to allow easy, real-time interaction with these registers. For more information on this, please refer to our doc page regarding the ADS1299 interface.

By deactivating channels 1, 3, 5, 6, and 8, those channels were automatically removed from the BIAS and SRB2, so as not to interfere with the signal. The only thing left to do is update channel 4, the input we are using for EMG and EKG. Begin by clicking the PGA Gain button for channel 4 until it is set to x8. Then remove it from the BIAS and SRB2. The reason we do this is because the uV values for EMG and EKG are much bigger (and easier to pick up) than the EEG signals on channels 2 and 7. As a result, we want to prevent channel 4 from influencing the common mode noise rejection of the BIAS, as well as remove it from the EEG reference channel (SRB2).

f) After updating these settings, click the EEG DATA tab again, and your EEG DATA montage should now appear similar to the image below:

EEG DATA AFTER ADJUSTING SETTINGS

Notice that you no longer see the heart beat artifacts in channels 2 and 7. Additionally, the heart beat signal in channel 4 should be more steady, looking more like a typical EKG signal.

5. Minimizing noise

So there's a good chance your current setup isn't showing clean data like the screenshots above. There are a number of possible reasons for this. We'll go through troubleshooting them here.

Notch Filter

Get rid of AC noise

Get rid of 60 Hz (or 50 Hz if you're in Europe or any country that operates on a 50 Hz power grid). The OpenBCI has a built-in notch filter, that does a decent job at eliminating 60 Hz noise. You can adjust the notch filter to 50 Hz by clicking the "Notch 60 Hz" button. Additionally, if your Cyton board is on a table with any power chords or devices that are plugged into a wall outlet, move it to a location away from any electronic devices plugged into the wall. This will drastically reduce the alternating current (AC) influence on your signal.

Stabilize Your Cables w/ Tape

Stabilize your electrodes

Make sure your electrode cables are steady. If you shake the electrodes that are dangling from your head/body, you'll notice that it severely affects the signals. This movement noise is something that could be greatly improved with "active" electrodes, but when using the "passive" electrodes that come with the OpenBCI electrode starter kit, you have to be very careful to remain steady while using the system, in order to produce the best signal. Sometimes, I'll bind all of the electrode cables together with a piece of electric tape to secure them and minimize cable movement. If you do this, don't worry about including the blue and green electrodes in the bundle, since movement noise doesn't affect the EMG/EKG signal as significantly.

Ensure that your electrodes are securely connected

Ensure that your electrodes are connected securely (especially your reference)!

Make sure your OpenBCI hardware is streaming data properly

Every so often, an error will occur with the wireless communication between your OpenBCI Dongle and board. If you've followed all of the steps above, and the data that you are seeing in the GUI interface is still illegible, try the following:

Power down your Cyton board and unplug your USB Dongle. Then, plug back in your USB Dongle and power up your Cyton board in that order. Then try restarting the system, but pressing the START SYSTEM button again.

Further troubleshooting

If you're still having issues, refer to the Forum for further troubleshooting techniques.

VI. Check out your body's electrical signals!

Congratulations! If you've made it this far, it's finally time to check out your body's electrophysiological signals!

1. Check out your heart activity (EKG)

Heart Beat

Channel 4 in the GUI should now be producing a nice steady succession of uV spikes. This is your heart beating! Try taking slow, deep breaths and watch how it influences your heart rate. If you look carefully, you may notice your heart beat more rapidly as your inhaling, and more slowly as you're exhaling.

Analyzing EKG

For more information on how to analyze an electrocardiography (EKG) signal, or on how to set up a full EKG (with 10 electrodes), check out the wikipedia page on EKG. The image to the right (pulled from the Wikipedia page) shows the various segments of a single heart beat.

2. Watch your muscles flex (EMG)

Forearm Flex

Now, try flexing your forearm or whatever muscle you placed the green electrode on top of. You should see a high-amplitude, high-frequency signal introduced into channel 4. This is the electric potential created by you activating your muscle!

If you relax your muscle again, you should see the channel 4 signal return to your heart beat (just EKG). The picture on the right shows this transition. When you're flexing your muscle, the electrode is picking up EMG and EKG at the same time. After you relax your muscle, the high-frequency signal disappears, and you're able to see just EKG.

Now blink your eyes a few times. Each time you blink you should see a strong spike on the EEG DATA montage. It should be most visible in channel 2, the channel for the electrode directly above your eye! This uV spike is a result of the muscles in your forehead that make your eyes blink.

Now try clenching your jaw. You should see a big uV spike in both channels 2 and 7. Each time you clench your jaw, you are introducing a strong EMG artifact into any electrodes on your scalp. If you put your fingers on the side of your head (above your ear) and clench your teeth, you should be able to feel the muscles in your head flexing.

Eye Blink & Jaw Clench EMG Artifacts

In the photo above, you can see what these signals look like the green highlighted region shows a single eye blink. The two blue sections show an extended period of jaw clenching.

It's interesting to note that these signals are not picked up in channel 4. This is because channel 4 is only looking at the potential difference across your body—from your right forearm to your left wrist. As a result the EMG/EEG artifacts being produced on your head (in reference to SRB2) are not visible in this channel.

4. Alpha brain waves (EEG)

Alpha Brain Waves!

Now, for what we've all been waiting for... let's check out some brain waves!

Firstly, deactivate channel 4 so that you are only looking at the EEG channels (2 and 7).

It's best to do this portion of the tutorial with a friend. You'll understand why in a second. It just so happens that the easiest way to consciously produce brain waves is by closing your eyes. When you do this, your occipital lobe (the part of your brain responsible for processing visual information) enters into an alpha wave state at a frequency between 7.5-12.5 Hz. Alpha brain waves are the strongest EEG brain signal! Historically, they are thought to represent the activity of the visual cortex in an idle state. An alpha-like variant called mu (μ) can be found over the motor cortex (central scalp) that is reduced with movement, or the intention to move [Wikipedia].

For more information on Alpha waves check out Wikipedia and Chip's EEG Hacker blog post about detecting alpha waves with OpenBCI V3.

Once you've closed your eyes, have your friend press the 'm' key on your keyboard to take screenshots. Tell him or her to wait until a strong alpha spike emerges on the Fast Fourier Transform (FFT) Graph, the graph in the lower-right of the GUI. The spike should be somewhere between 7.5-12.5 on the the x-asix of the FFT graph, indicating that there is a strong presence of waves in that frequency range.

After you've taken a few good screenshots, open up the .JPGs and take a look. Note: the screenshots are located in the root directory of your application, or in the OpenBCI_GUI directory if you are working from Processing.

You'll notice that the strongest alpha wave signals should be appearing in channel 7, the O2 (O standing for occipital) electrode on the back of your head. Count the number of waves in a single 1-second time period on channel 7 of the EEG DATA montage. The number of waves should correspond x-axis position of the spike on the FFT graph. If you've identified your alpha waves, congratulations! You've now seen your first brain waves with OpenBCI!

5. What's next?

For more ideas on what to do next, check out the OpenBCI [Community Page] (http://openbci.com/community/) and the other OpenBCI Docs pages.

Also, if you have a great follow-up tutorial to this getting started guide or something else you want to share, feel free to create your own by following format we have in the Docs repo of our Github. It's really easy to create your own Docs page with a Markdown editor like Mou or MacDown. If you do so, send us a pull request on Github and we'll add your tutorial to the Docs! If you have troubleshooting questions be sure to visit the OpenBCI Forum. For all other inquiries, contact us at contact@openbci.com.

Trouble shooting on macOS SIERRA

If you have any other trouble with your permissions, or if you don't see the option to Open the app, check your Settings/Security & Privacy and make sure you tick the Anywhere button. If you don't see the Anywhere button, jump down a paragraph and follow the terminal instructions.

Allow Form Anywhere

When Apple updated their Operating System to Sierra (v10.12.x), they changed a few things about your Security & Privacy default settings. We have fixed this issue since 2.1.x of the OpenBCI_GUI, but there still are versions where the permission issue could arise.

Here's how to do it:

sudo

  1. Open the Terminal app from your /Applications/Utilities/ folder and then enter the following command syntax: sudo spctl --master-disable and press the return key.
  2. You will be prompted to enter your administrator password. Do that, and then press return key.

This hack was published by osXdaily September, 2016.

Allow Apps

Now, go to your System Preferences/Security & Privacy and make sure that your system allows apps downloaded from Anywhere. You may again be prompted for your administrator password.
Now go back to where you were before to continue!