Muse Blink Light Demo

This code was written to demo how easy it is to integrate a mobile, consumer-grade EEG device with an Arduino microcontroller.

This demo requires basic skills in hardware and intermediate skills in software development, you should be able to run a python3 script on your computer, and load an arduino script to an Arduino microcontroller. I did all of this on a Lenovo laptop running Fedora 24. I have never owned a Mac, and quit Windows as a kid. So if you're running linux I am more than willing to help debug. But if you are running Mac or Windows, I won't be able to offer much assistance.

An outline of the project flow:

• upload script to arduino
• connect muse to computer (bluetooth)
• run muse-io
• run blink.py script

Prep Work

• Install Muse SDK
• Install Arduino IDE
• Requres Python 3
  • python3 -m venv venv-muse
  • source venv-muse/bin/activate
  • pip install -r requirements.txt

Starting

Arduino

• Load the led_blink.ino onto your Arduino
• record Arduino port name e.g. /dev/ttyACM0

Muse

Step 1: Connect Muse EEG device to computer, and keep track of MAC Address.

• This may be tricky on Apple products. Perhaps opening up a terminal and typing system_profiler SPBluetoothDataType will do the trick.

Step 2: Start muse-io with --device and --osc flags

• For linux users, this is done by running: ./muse-io --device <mac-address> --osc osc.udp://localhost:5000
• This starts the muse-io server, it is streaming data on port 5000.
• If you installed MuseLab (which you probably did if you have muse-io, you can quickly check the status of your signal)
• You should see the muse-io stats for the Muse device. This gives an overview, in real-time, of the connection quality, battery life, and other metrics of the Muse EEG device.

Step 3: Run blink.py script.

• blink.py, by default, does not assume a serial connection with an arduino. Passing the --serial <port> argument to the blink.py script will setup a serial connection with an already connected arduino device.
• other default assumptions are that you are streaming osc udp packets on localhost:5000
• However, if, for some reason you aren't doing the default, you can change the server and port configuration by passing --ip <ip_address> and --port <port_number> arguments to blink.py
  • Run blink.py like this python3 blink.py
  • Or, if connected to an Arduino python3 blink.py --serial /dev/ttyACM0