Contributions:StimBoxFilter: Difference between revisions

From BCI2000 Wiki
Jump to navigation Jump to search
(Added documentation for the StimBoxFilter)
(No difference)

Revision as of 04:43, 23 September 2013

Synopsis

An integration of the g.STIMbox with BCI2000

Location

http://www.bci2000.org/svn/trunk/src/contrib/Extensions/AudioExtension

Versioning

Authors

Griffin Milsap (griffin.milsap@gmail.com)

Version History

  • 2013/09/23: Initial public release;

Source Code Revisions

  • Initial development: 4580
  • Tested under: 4580
  • Known to compile under: 4580
  • Broken since: --

Functional Description

The g.STIMbox is a USB digital I/O card. This simple filter extension resides in the Application module and makes input and output with the card easy.

Integration into BCI2000

Compile the extension into your source module by enabling contributed extensions in your CMake configuration. You can do this by going into your root build folder and deleting CMakeCache.txt and re-running the project batch file, or by running cmake -i and enabling BUILD_STIMBOXFILTER. Once the extension is built into the source module, enable it by starting the source module with the --StimBoxFilter=[COMPORT] command line argument (NB, as explained below, the numeric value here matters, and denotes the COM port to be used: =1 means COM port 1).

Parameters

The StimBoxFilter is configured in the g.STIMbox tab. The configurable parameters are:

EnableStimBoxFilter

Enables/Disables the StimBoxFilter. This parameter performs double-duty as an audio host API selector. NOTE: The COM port that the g.STIMbox is connected to can be determined by accessing the Device Manager within the Windows control panel.

  • [0] - Disabled
  • Any other number indicates the COM port to attempt communication with the g.STIMbox on.

DigitalOutputs

This matrix of expressions that controls the outputs on the device. The g.STIMbox has 16 digital outputs which can be controlled via expressions in this matrix. Some of the outputs can only be accessed via the D-SUB connector on the front of the box. To control a port, create a new row in this matrix and change the row label to the number of the port you wish to control. If the expression in column 1 in that row evaluates to True, the port will be set high, and the port will be set low whenever the expression evaluates to False. If an 'F' is specified immediately after the row label (for example, '3F'), that port is assumed to be in 'Frequency Mode' and the port frequency will be set to whatever the expression evaluates to. If the expression evaluates to 0 or False, the port will be set low (off). Note that changing the frequency while in frequency mode will reset the port to 'high' immediately. This means that changing the frequency too often will result in the port reading 'high' all the time.

Example:

(Row Label) (Column 1) (Description)
1 1 // Output 1 is always high
2 0 // Output 2 is always low
5 0.5 // Outputs don't need to be specified in order, 0.5 evaluates to True
3 Signal(1,1) > 50 // Output 3 is high when the input signal exceeds 50.
4F StimulusType // Output 4 will evaluate the state "StimulusType" to determine output frequency.
5 !StimBoxInput1 // Line 3 is ignored, Output 5 = Input 1

Special Notes:

  • Valid frequencies for frequency mode are between 1 and 50 Hz.

State Variables

The StimBoxFilter outputs the following state variables:

StimBoxInput[1-14]

There are 14 digital inputs on the StimBox. Some of the inputs can only be accessed via the D-SUB connectors on the front of the box. These inputs are asynchronously sampled at 256 Hz and set as BCI2000 states once per block. Note that this means there is data loss if your signal changes more than once per BCI2000 block. Clocking BCI2000 at >256 blocks per second is also inadvisable, so this is expected.

See also

User Reference:Logging Input, Contributions:Extensions