Rustymind is a driver and parser for NeuroSky MindWave EEG headset written in pure Rust.

Junjun Dong

Last update: Sep 13, 2022

Related tags

Utilities rust plot neuroscience eeg neurosky bci brain brain-computer-interface mindwave eeg-headset eeg-readings brainwave eeg-signals-processing

Overview

rustymind

Rustymind is a driver and parser for NeuroSky MindWave EEG headset written in pure Rust. You can use it to connect, interact, and plot real time data from the headset.

The parser is based on the mindwave mindset communication protocols published by NeuroSky.

See below for a screenshot of real time mindwaves plotted by rustymind-plot CLI based on rustymind parser.

Getting Started

rustymind-plot takes two arguments to run:

MindWave device path. On Mac, the path would be in the format of /dev/tty.usbserial-10000
Headset ID (printed inside the battery case)

cargo run --bin rustymind-plot "/dev/tty.usbserial-10000" a05f

If you don't pass in the headset ID argument, the dongle will auto-connect to any headsets it can find.

To use rustymind as a library, you need to use connect_headset function and Parser struct. For example:

= vec![0; 2048]; let mut parser = Parser::new(); loop { let bytes_read = port.read(buffer.as_mut_slice()).unwrap(); for i in 0..bytes_read { if let Some(x) = parser.parse(buffer[i]) { for r in x { match r { PacketType::Attention(value) => { println!("Attention value = {}", value); } PacketType::Meditation(value) => { println!("Meditation value = {}", value); } PacketType::AsicEeg(value) => { println!("EEG power values = {:?}", value); } _ => (), } } } } } ">

use rustymind::{connect_headset, PacketType, Parser};

let mut port = connect_headset("/dev/tty.usbserial-10000", b"\xa0\x5f")?;
let mut buffer: Vec<u8> = vec![0; 2048];
let mut parser = Parser::new();

loop {
    let bytes_read = port.read(buffer.as_mut_slice()).unwrap();
    for i in 0..bytes_read {
        if let Some(x) = parser.parse(buffer[i]) {
            for r in x {
                match r {
                    PacketType::Attention(value) => {
                        println!("Attention value = {}", value);
                    }
                    PacketType::Meditation(value) => {
                        println!("Meditation value = {}", value);
                    }
                    PacketType::AsicEeg(value) => {
                        println!("EEG power values = {:?}", value);
                    }
                    _ => (),
                }
            }
        }
    }
}