rychan14 / np_mindset

Max/Pd external for the Neurosky Mindset EEG Helmet - Binaries available on externals site

NOTE

THIS EXTERNAL WILL NOT WORK WITH THE NEUROSKY MINDWAVE. IT WILL ONLY WORK WITH THE OLD BLUETOOTH NEUROSKY MINDSET. I DO NOT HAVE A MINDWAVE AND HAVE NO PLANS ON SUPPORTING IT.

np_mindset Max/MSP and Pd External

by Kyle Machulis <[email protected]> Nonpolynomial Labs - http://www.nonpolynomial.com

Description

np_mindset is an external for either Max/MSP or Puredata to receive information from the Neurosky Mindset EEG Development Kit.

Portability of source between Max and Pd is available thanks to flext

• Max: http://www.cycling74.com

• Pd: http://www.puredata.info

• Flext: http://puredata.info/Members/thomas/flext

Mindset Information

More information about the Neurosky Mindset can be found at

http://www.neurosky.com

Source Requirements

ThinkGearStreamParser.c/h and thinkgear.h, while free, are distributed as part of the MindSet SDK, and will need to be retreived from the Neurosky developer site. The SDK is available for free at

http://developer.neurosky.com/

Installation

• Put the .mxo(Mac)/.mxe(Windows) or .pd_[platform] file in a directory that Max/Pd will search for externals (Max: Options → File Preferences → Other Folders, Pd: Options → Paths)

• Max: Put the .help (Max4) or .maxhelp (Max5) file in the max-help directory of your Max/MSP installation

Platform Specifics Issues

ALL PLATFORMS

• Entering a wrong port name may cause Max to crash. Make sure you’ve got the device on and bonded before hitting the start button. This will be fixed soon.

• Currently the I/O thread is taking up a TON of CPU because of the polling frequency (2ms). There’s a good chance the next version of the external will change how the raw wave output works so I can reduce this. So be warned.

Licensing

np_mindset is covered under the GPL License due to Flext. If you can unwind it from flext somehow, consider it BSD.

np_mindset Copyright

np_mindset, Copyright 2009-2010 Kyle Machulis/Nonpolynomial Labs

Flext Copyright and GPL License

flext source code are covered under the GPL v2 License. np_mindset is BSD, but since it’s based on flext, it’s GPL.

flext - C++ layer for Max/MSP and pd (pure data) externals
Copyright (C) 2001-2005 Thomas Grill

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

In the official flext distribution, the GNU General Public License is
in the file gpl.txt
--------------------