HandVibrationFilter

Introduction

This filter uses BCI2000 States to modify the output signal of the Arduino. This was designed for use with a hand vibration device connected to the Arduino, in which the output of the Arduino changes the intensity and location of the vibration.

Location

http://www.bci2000.org/svn/trunk/src/contrib/SignalProcessing/HandVibrationFilter

Authors

Alexander Belsten (belsten@neurotechcenter.org)

Integration into BCI2000

The driver of the Arduino device must be installed. The device it has been tested on is the Adafruit Metro Arduino, in which you can download the drivers here.

To use it in BCI2000, compile and build the HandVibrationFilter, and start it as the SignalProcessing filter in your batch file: Start executable HandVibrationFilter --local.

Parameters

ActivateHandVibration

Enable to use this module.

COMPort

Use the Device Manager to choose the COM Port the Arduino is connected to.

UseStateModulation

Enable to use the state value to modulate amplitude.

DecimationOfModulation

ModulationState

Define the state used to modify configuration of the vibrotactile device. For example, StimulusCode will use the stimulus codes during an experiment to control the features/configuration of the vibration device.

Configurations

Table that specifies the Expression, Amplitude, and Frequency for each configuration. Expression is used to define the state that will produce the features defined within a configuration. For example, StimulusCode==1 will execute the configuration when the experiment is in stimulus code 1. Amplitude controls the intensity of the vibration element. This is a number from 0-100, where 0 corresponds to the minimum intensity (amplitude) of the vibration and 100 is the maximum intensity. The intensity is specified as a ratio that maps to the maximum pulse width ratio (on/off). The frequency specifies the rate the vibrotactile element is turned on and off within the state in Hz. For example, a frequency of 4 will pulse the motor on and off 4 times per second.

States

HandVibration

Whether or not the hand is vibrating.