ofxEmotiBit

Software code for the EmotiBit. If you just want to visualize and parse data from the EmotiBit (for Windows/ macOS), you can simply download the software directly in releases.

If you want to modify the code(or build the tools in Linux), below are the requirements to build the project.

Requirements

Openframeworks

Install openFrameworks 0.11.2 from the official openFrameworks GitHub repository. Choose the appriopriate version for your operating system.

• For windows: of_v0.11.2_vs2017_release.zip
• For macOS: of_v0.11.2_osx_release.zip
• For linux: of_v0.11.2_linux64gcc6_release.tar.gz

Addons directory structure

Openframeworks uses addons to support adding features to the projects. The addons used by EmotiBit software are listed in the section below. The addons are placed in the OF_ROOT/addons folder and it's structure is shown below. Please download or clone (uses git) the addons listed in the section below in the OF_ROOT/addons directory. You can have additional addons in the addons folder, but the addons linked above are required for building EmotiBit software.

addons
├── ofxEmotiBit
│   ├── src
│   ├── EmotiBitOscilloscope
│   │   ├── EmotiBitOscilloscope.sln
│   │   ├── EmotiBitOscilloscope.xcodeproj
│   │   └── ...
│   ├── EmotiBitDataParser
│   └── EmotiBitFirmwareInstaller        
├── ofxNetworkUtils
├── ofxOscilloscope
├── ofxThreadedLogger
├── ofxBiquadFilter
├── ofxJSON
├── EmotiBit_XPlat_Utils
├── ofxLSL
├── ofxSerial
└── ofxIO

Openframeworks addons

• ofxNetworkUtils: GitHub repository
• ofxOscilloscope: GitHub repository
• ofxThreadedLogger: GitHub repository
• ofxBiquadFilter: GitHub repository
• ofxJSON: GitHub repository
• EmotiBit_XPlat_Utils: GitHub repository

• ofxLSL: GitHub repository

  • Notes for developing with Visual Studio

  • Note: for LSL support, if developing with Visual Studio, code should be compiled for x64

  • liblsl64.dll should always be in the same folder as the .exe (i.e. EmotiBitOscilloscope/bin/liblsl64.dll)

  • liblsl64.lib should always be linked to in under solution properties->linker->general->additional library directories and solution properties->linker->input-> additional dependencies

  • both of these libs are handled properly by default but should be considered if deviating from the release code

• The project is built on a 64-bit architecture. Ensure you are on a machine supporting the x64 build platform.
• Required to build EmotiBit FirmwareInstaller
  • ofxSerial: GitHub repository
  • ofxIO: GitHub repository
• If downloading the zip instead of git clone be sure to remove -master or -xxx-xxx from the folder name to maintain correct path references.

The following script may be run from a bash shell within your openFrameworks/addons/ directory to install ofxEmotiBit and all dependencies.

Note: this requires you to have github SSH key access set up.

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
git clone git@github.com:EmotiBit/ofxEmotiBit.git
git clone git@github.com:bakercp/ofxNetworkUtils.git
cd ofxNetworkUtils
git checkout stable
cd ..
git clone git@github.com:produceconsumerobot/ofxOscilloscope.git
git clone git@github.com:produceconsumerobot/ofxThreadedLogger.git
git clone git@github.com:smukkejohan/ofxBiquadFilter.git
git clone git@github.com:jeffcrouse/ofxJSON.git
git clone git@github.com:EmotiBit/EmotiBit_XPlat_Utils.git
git clone git@github.com:EmotiBit/ofxLSL.git
git clone git@github.com:bakercp/ofxSerial.git
cd ofxSerial
git checkout stable
cd ..
git clone git@github.com:bakercp/ofxIO.git
cd ofxIO
git checkout stable
cd ..

Setup Instructions for Windows 11

Setup Instructions for macOS

Setup Instructions for Linux