BCI2000 Wiki - User contributions [en]

Contributions:LiveAmpADC

2017-01-17T13:51:11Z

Ratko:

Contributions:LiveAmpADC

2017-01-17T13:48:54Z

Ratko: /* Parameters:LiveAmpADC */

Contributions:LiveAmpADC

2017-01-17T13:47:17Z

Ratko: /* Parameters:LiveAmpADC */

Contributions:LiveAmpADC

2017-01-17T13:46:54Z

Ratko: /* Installation */

File:LiveAmpADC.png

2017-01-17T13:41:17Z

Ratko:

Contributions:LiveAmpADC

2017-01-17T13:40:01Z

Ratko:

Contributions:LiveAmpADC

2017-01-17T12:00:43Z

Ratko:

LiveAmpADC

==Function==

The ''LiveAmpADC'' filter acquires data from a ''LiveAmp'' wireless (Bluetooth) amplifier.
The ''LiveAmp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''LiveAmpSource.exe'').

===LiveAmp Hardware===

Either up to 32 referential EEG/ExG channels (with either passive or active electrodes) or up to 24 EEG/ExG referential channels plus up to 8 bipolar ExG channels (with passive electrodes only).\\
8 AUX channel can be attached to AUX input, using AUXbox. Tehre si one Trigger channel and 8 Digital I/=.
There are built-in 3-axis acceleration sensor with 3 separate channels (x, y, z).\\
More on hardware can be found at: [http://www.brainproducts.com/productdetails.php?id=63 LiveAmp Technical details].

==Installation==

The BlueTooth dongle UBT21 must be installed first. The driver comes with the LiveAmp.

==Parameters:LiveAmpADC==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''LiveAmpADC'' provides the following parameters:

===SerialNumber===
Each LiveAmp has the serial number. The serial number can be found on the back of the amplifier. This number must be set as a parameter (without letters "LA-"). It is necessary for the Bluetooth connection

===SourceCh===
The total number of channels: EEG + AUX + Acc + Triggers (see parameters below).

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 500 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 25 times per second.

===SamplingRate===
The sample rate of the system. All data is either acquired at 250, 500 or 1000Hz
In case you are experiencing problems by higher sampling rates (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===SourceChGain===
Gain for each channel.

===SourceChOffset===
Offset for each channel.

===ChannelNames===
Names of each channel.

===AcquisitionMode===
Data acquisition mode, it can be: inactive, analog signal acquisition and test signal.

==Parameters:LiveAmp==

===EegChList===
List of indexes of EEG channels used. For example, you can write index in any order, like: 21, 3, 5, 6, 7, 8. That means that only 6 EEG physical channels will be recorder: 3,5,6,7,8 and 21.

===BipolarChannels===
Checking this option the last 8 of 32 channels will be bipolar. When user wants to record bipolar channel, he/she must put appropriate indexes in the 'EegCHList' (indexes between 25 and 32).

===AuxChList===
List of indexes of AUX channels. For example, if there are 6 AUX available, you can put 1, 2, 5, 6. That mans that only 4 AUX channel will be recorder, with indexes 1,2, 5 and 6.

===ACCList===
List of indexes of Acc (acceleration sensor) channels. There are 3 Acc channels, with indexes 1(x) ,2(y) and 3(z).

===TriggerChList===
List of indexes of trigger channels. There is one analog and 8 digital channels.

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

Now you can use V-Amp device.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:LiveAmpADC

2017-01-17T11:45:21Z

Ratko:

LiveAmpADC

==Function==

The ''LiveAmpADC'' filter acquires data from a ''LiveAmp'' wireless (Bluetooth) amplifier.
The ''LiveAmp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''LiveAmpSource.exe'').

===LiveAmp Hardware===

Either up to 32 referential EEG/ExG channels (with either passive or active electrodes) or up to 24 EEG/ExG referential channels plus up to 8 bipolar ExG channels (with passive electrodes only).\\
8 AUX channel can be attached to AUX input, using AUXbox. Tehre si one Trigger channel and 8 Digital I/=.
There are built-in 3-axis acceleration sensor with 3 separate channels (x, y, z).\\
More on hardware can be found at: [http://www.brainproducts.com/productdetails.php?id=63 LiveAmp Technical details].

==Installation==

The BlueTooth dongle UBT21 must be installed first. The driver comes with the LiveAmp.

==Parameters:LiveAmpADC==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''LiveAmpADC'' provides the following parameters:

===SerialNumber===
Each LiveAmp has the serial number. The serial number can be found on the back of the amplifier. This number must be set as a parameter (without letters "LA-"). It is necessary for the Bluetooth connection

===SourceCh===
The total number of channels: EEG + AUX + Acc + Triggers.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 500 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 25 times per second.

===SamplingRate===
The sample rate of the system. All data is either acquired at 250, 500 or 1000Hz
In case you are experiencing problems by higher sampling rates (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===SourceChGain===
Gain for each channel.

===SourceChOffset===
Offset for each channel.

===ChannelNames===
Names of each channel.

===AcquisitionMode===
Data acquisition mode, it can be: inactive, analog signal acquisition and test signal.

==Parameters:LiveAmp==

===EegChList===
List of indexes of EEG channels used.

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

Now you can use V-Amp device.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:LiveAmpADC

2017-01-16T15:24:55Z

Ratko:

LiveAmpADC

==Function==
The ''LiveAmpADC'' filter acquires data from a ''LiveAmp'' wireless (Bluetooth) amplifier.
The ''LiveAmp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''LiveAmpSource.exe'').

===LiveAmp Hardware===
The LiveAmp consists of 32 independent 24-bit A/D converters that can sample at: 250, 500 and 1000 Hz.

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

Now you can use V-Amp device.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:LiveAmpADC

2017-01-16T15:17:45Z

Ratko: Created page with "LiveAmpADC"

LiveAmpADC

Contributions:ADCs

2017-01-16T15:16:51Z

Ratko: Add a link to the LiveAmpADC page

The following data acquisition filters are available in the [[Contributions:Contents|Contributions]] section of BCI2000:

*[[Contributions:AmpServerProADC]]: Interface to the EGI AmpServerPro.
*[[Contributions:BioRadioADC]]: Interface to the BioRadio amplifer.
*[[Contributions:Biosemi2ADC]]: Interface to the Biosemi amplifier.
*[[Contributions:Blackrock]]: Interface Blackrock devices through CereLink.
*[[Contributions:B-Alert]]: Interface to B-Alert brain monitoring systems.
*[[Contributions:DAS_ADC]]: Interface to MeasurementComputing AD cards.
*[[Contributions:DTADC]]: Interface to Data Translation boards.
*[[Contributions:Emotiv]]: Interface to the Emotiv EPOC.
*[[Contributions:FieldTripBufferSource]]: Interface to the FieldTrip buffer.
*[[Contributions:FilePlayback]]: A source module that replays sessions from recorded data files.
*[[Contributions:gHIamp]]: Interface to the gHIamp.
*[[Contributions:gNautilus]]: Interface to the gNautilus bypassing the server
*[[Contributions:gNautilusNEEDAccess]]: Interface to the gNautilus via g.NEEDAccess.
*[[Contributions:MicromedADC]]: Interface to the Micromed EEG system.
*[[Contributions:ModularEEG]]: Interface to the ModularEEG system.
*[[Contributions:Neuralynx]]: Interface to Neuralynx systems
*[[Contributions:NIADC]]: Interface to National Instruments boards.
*[[Contributions:NIDAQ-MX]]: Interface to National Instruments boards using the MX driver.
*[[Contributions:NIDAQLogger]]: Interface to multiple National Instruments DAQ boards using MX driver (INPUT ONLY).
*[[Contributions:NIDAQFilter]]: Interface to multiple National Instruments DAQ boards using MX driver (OUTPUT ONLY).
*[[Contributions:NeuroscanADC]]: Neuroscan Acquire socket protocol client.
*[[Contributions:NeuroscanAccessSDK]]: Interface to Neuroscan Direct Access SDK.
*[[Contributions:NeuroSky]]: Interface to Neurosky MindSet.
*[[Contributions:NicoletOne]]: Interface to NicoletOne nEEG series amplifiers.
*[[Contributions:ctfneurod]]: CTF RealTime to Neuroscan Acquire relay.
*[[Contributions:RDAClientADC]]: Brain Vision RDA socket protocol client.
*[[Contributions:TDTADC]]: Interface to Tucker-Davis Pentusa systems.
*[[Contributions:TMSiADC]]: Interface to TMSi Refa and Porti systems.
*[[Contributions:vAmpADC]]: Interface to Brain Products V-amp systems.
*[[Contributions:EnobioADC]]: Interface to Enobio sensor.
*[[Contributions:DSISerial]]: Interface to Dry Sensor Interface (DSI) EEG systems by Wearable Sensing.
*[[Contributions:MicRecorderFilter]]: Interface to the system soundcard, logging audio input.
*[[Contributions:actiCHampADC]]: Interface to the Brain Products actiCHamp system.
*[[Contributions:LiveAmpADC]]: Interface to the Brain Products LiveAmp system.

==See also==
[[User Reference:Filters]], [[Contributions:How to use a Contributed Source Module]]

[[Category:Contents]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:47:43Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

Now you can use V-Amp device.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:46:41Z

Ratko: /* V-Amp Service Troubleshooting */

Contributions:vAmpADC

2016-06-20T12:40:45Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:40:31Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png |thumb]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:39:47Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png|thumb |]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png|thumb |]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png|thumb |]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:39:17Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png| thumb]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png| thumb]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png| thumb]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:38:41Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png|thumb]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:35:17Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[File:ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:33:31Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[ServiceExplorer.png]]
[[File:Example.jpg]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:33:08Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]
[[File:Example.jpg]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:32:17Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]
[[File:Example.jpg]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[VampServiceOff_step1.png]]

3. Service window opens, showing the list of services running on your PC.

[[ServiceExplorer.png]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

File:ServiceExplorer.png

2016-06-20T12:31:33Z

Ratko:

File:VampServiceOff step1.png

2016-06-20T12:30:54Z

Ratko:

Contributions:vAmpADC

2016-06-20T12:23:10Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]
[[File:Example.jpg]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:StartWin.png]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:Example.jpg]]

3. Service window opens, showing the list of services running on your PC.

[[File:Example.jpg]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

File:StartWin.png

2016-06-20T12:22:47Z

Ratko:

Contributions:vAmpADC

2016-06-20T12:22:08Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]
[[File:Example.jpg]]

In order to stop the “VAmpService.exe”, the following steps need to be done:

1. Open Windows Start menu by clicking on icon [[File:Example.jpg]] in left-bottom corner.

2. In Windows Start menu type Services, and click on „Services“ when it appears in the menu.

[[File:Example.jpg]]

3. Service window opens, showing the list of services running on your PC.

[[File:Example.jpg]]

4. Search for the „VAmpService“ in the list.

5. Right-click on „VAmpService“ and the drop-down menu will appear.

6. From the drop-down menu select “Stop”. This action stops the service.

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

File:Log VampServiceDetected.png

2016-06-20T12:18:26Z

Ratko: Ratko uploaded a new version of "File:Log VampServiceDetected.png"

Contributions:vAmpADC

2016-06-20T12:17:08Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need be done:

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:16:55Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Log_VampServiceDetected.png]]

In order to stop the “VAmpService.exe”, the following steps need be done:

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

File:Log VampServiceDetected.png

2016-06-20T12:16:03Z

Ratko: Ratko uploaded a new version of "File:Log VampServiceDetected.png"

Contributions:vAmpADC

2016-06-20T12:14:42Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier.

[[File:Example.jpg]]

In order to stop the “VAmpService.exe”, the following steps need be done:

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

Contributions:vAmpADC

2016-06-20T12:13:53Z

Ratko: /* V-Amp Service Troubleshooting */

==Function==
The ''vAmpADC'' filter acquires data from a ''V-Amp'' or ''FirstAmp'' EEG amplifier.
The ''V-Amp'' is an amplifier/digitizer combination from Brain Products.
Support for this device in BCI2000 consists of a BCI2000-compatible Source Module (''vAmpSource.exe'').

===V-Amp Hardware===
The V-Amp consists of 16 independent 24-bit A/D converters that can sample at
up to 2 kHz per channel (16 channels, plus 2 auxiliary) or 20kHz per channel (4 channels).

==Installation==
The necessary system drivers are located in the BCI2000\src\extlib\brainproducts\vamp\ folder. To install the driver, follow these steps:

# Plug in the V-Amp to a USB port. Windows should recognize it, and start to install drivers.
# Depending on the version of Windows being used, a Found New Hardware dialog should appear. Do NOT search online for drivers; instead, select Don't Search Online.
# When it asks you to insert the disc that came with the amplifier, select the option that allows you to browse for the driver.
# Navigate to BCI2000\src\extlib\brainproducts\vamp\. It should find the driver files, and installed the necessary software.
# For the last step, copy the files DiBpGmbH.dll and FirstAmp.dll to the BCI2000\prog\ folder.
# You should now be able to run the vAmpSource.exe module in BCI2000.

==Parameters==
Parameters common to all source modules are described under [[User Reference:DataIOFilter]].
In addition, the ''vAmpADC'' provides the following parameters:

===SamplingRate===
The sample rate of the system. All data is either acquired at 2000 Hz or 20 kHz, and then decimated to the desired rate. Therefore, only rates that are integer divisors of the base rates are accepted. In 2000 Hz mode, the valid rates are:

*2000
*1000
*666.6
*500
*400
*333.3
*285.7
*250
*222.22
*200

In 20 kHz mode, 10 times the above rates are valid.
Prior to decimation, a 2nd-order anti-aliasing Butterworth filter with a corner frequency of 0.45 times the sample rate is applied to the signal.
All sampling rates are supported for one or more amplifiers. If you are sampling at high rates, the CPU may be overloaded depending on the speed of your computer and the BCI2000 configuration. In case you are experiencing problems (e.g., data loss, jerky display, etc.), increase the SampleBlockSize so that you are updating the system less frequently (usually, updating the system 20-30 times per second is sufficient for most applications), and increase Visualize->VisualizeSourceDecimation. This parameter will decrease the number of samples per second that are actually drawn in the Source display.

===HPFilterCorner===
A high-pass digital filter for removing DC offsets. This occurs after data has been read into BCI2000.

===SampleBlockSize===
Samples per channel per digitized block.
Together with the sampling rate, this parameter determines how often per second data are collected, processed, and feedback is updated. For example, at 600 Hz sampling and a SampleBlockSize of 20, the system (e.g., source signal display, signal processing, and stimulus presentation) will be updated 30 times per second.

===SourceCh===
The total number of channels. In high-speed mode, this number may not be higher than 5 (4 channels + digital).

===SourceChList===
The list of channels that should be acquired from the vAmp device.
The total number of channels listed should correspond to ''SourceCh''.
The order of channels does not matter; i.e., '1 2 3 4' is the same as '2 3 1 4'. The channels are always in ascending order.
Channels may not be listed twice; e.g., entering '1 2 3 4 5 6 7 1' if ''SourceCh'' = '8' will result in an error.
If this parameter is left blank (the default), then all channels are acquired.
For the V-Amp 16, channels 1-16 are EEG channels, 17-18 are Auxiliary channels, and 19 are the 8 digital channels stored in bits.
For the V-Amp 8, channels 1-8 are EEG channels, 9-10 are Auxiliary channels and 11 is the digital channel.

===AcquisitionMode===
*If set to ''analog signal acquisition'', the V-Amp records analog signal voltages (default).
*If set to ''high-speed acquisition'', the V-Amp records analog signals at 20 kHz instead of 2000 Hz.
*If set to ''Calibration'', the signal output is a square wave test signal generated by the V-Amp (which can be used to verify correct system calibration).
*If set to ''Impedance'', impedance data is recorded instead of the signal. The impedance values are showm in the V-Amp display. Values are currently updated 3 times per second.
*If set to ''high-speed calibration'', a square wave is generated at 20 kHz.

==Additional Information==

===Data Storage===
*The signal is originally recorded from the V-Amp as 32-bit integers, and converted into <math>\mu V</math>.
*The auxiliary input units are in volts.
*(''SourceChOffset'' is assumed (and required) to be zero for all channels.)
BCI2000 Signal Processing or any offline analysis routine can derive, as with any other BCI2000 source module, sample values in <math>\mu V</math> by subtracting, from each stored sample, ''SourceChOffset'' (i.e., zero), and multiplying it with ''SourceChGain'' for each channel. If ''SignalType'' is set to float32, data samples are stored in units of <math>\mu V</math>. In this case, ''SourceChGain'' should be a list of 1's (because the conversion factor between data samples into <math>\mu V</math> is 1.0 for each channel). Still, when values other than 0 and 1 are specified, a consistent data file will be produced, i.e. values will be transformed before they are written to the file, such that applying SourceChOffset and SourceChGain will reproduce the original values in <math>\mu V</math>.

===V-Amp Service Troubleshooting===
Please note that when BrainVision Recorder was running on the computer before you are using BCI2000 there is a daemon service called "VAmpService.exe" running in background on the computer. This service must be stopped before using V-Amp amplifier. In order to stop the “VAmpService.exe”, the following steps need be done:

A more convenient way to solve this problem is to edit the *.bat-file for your experiment like described below, especially if you are using BCI2000 and BrainVision Recorder alternately. This avoids problems with BrainVision Recorder that you might encounter when killing the "VampService.exe" process.

'''start C:\Vision\Recorder\VAmpService.exe -Uninstall'''
cd ..\prog
start '''vAmpSource.exe''' 127.0.0.1
start ARSignalProcessing 127.0.0.1
start CursorTask.exe 127.0.0.1
'''operator.exe'''
'''start C:\Vision\Recorder\VAmpService.exe -Install'''
cd ..

Make sure that the path to "VAmpService.exe" is correct on your system.
Please keep in mind that you have to customize the *.bat-file shown above regarding your experiment. For using the V-Amp in the way described, the highlightened parts are important.
Please note that the commandline-window will stay open during the usage of BCI2000 (unlike when using the other *.bat-files) because of the operator.exe is started without the "start"-parameter. This is necessary to make sure that the VAmpService.exe process is started again just when BCI2000 is closed.

==See also==
[[User Reference:Filters]], [[Contributions:ADCs]]

[[Category:Contributions]][[Category:Data Acquisition]]

File:Log VampServiceDetected.png

2016-06-20T12:10:18Z

Ratko:

Contributions:ADCs

2016-04-26T12:40:45Z

Ratko: add link to the new page: actiCHampADC

The following data acquisition filters are available in the [[Contributions:Contents|Contributions]] section of BCI2000:

*[[Contributions:AmpServerProADC]]: Interface to the EGI AmpServerPro.
*[[Contributions:BioRadioADC]]: Interface to the BioRadio amplifer.
*[[Contributions:Biosemi2ADC]]: Interface to the Biosemi amplifier.
*[[Contributions:Blackrock]]: Interface Blackrock devices through CereLink.
*[[Contributions:B-Alert]]: Interface to B-Alert brain monitoring systems.
*[[Contributions:DAS_ADC]]: Interface to MeasurementComputing AD cards.
*[[Contributions:DTADC]]: Interface to Data Translation boards.
*[[Contributions:Emotiv]]: Interface to the Emotiv EPOC.
*[[Contributions:FieldTripBufferSource]]: Interface to the FieldTrip buffer.
*[[Contributions:FilePlayback]]: A source module that replays sessions from recorded data files.
*[[Contributions:gHIamp]]: Interface to the gHIamp.
*[[Contributions:gNautilus]]: Interface to the gNautilus bypassing the server
*[[Contributions:gNautilusNEEDAccess]]: Interface to the gNautilus via g.NEEDAccess.
*[[Contributions:MicromedADC]]: Interface to the Micromed EEG system.
*[[Contributions:ModularEEG]]: Interface to the ModularEEG system.
*[[Contributions:Neuralynx]]: Interface to Neuralynx systems
*[[Contributions:NIADC]]: Interface to National Instruments boards.
*[[Contributions:NIDAQ-MX]]: Interface to National Instruments boards using the MX driver.
*[[Contributions:NIDAQLogger]]: Interface to multiple National Instruments DAQ boards using MX driver (INPUT ONLY).
*[[Contributions:NIDAQFilter]]: Interface to multiple National Instruments DAQ boards using MX driver (OUTPUT ONLY).
*[[Contributions:NeuroscanADC]]: Neuroscan Acquire socket protocol client.
*[[Contributions:NeuroscanAccessSDK]]: Interface to Neuroscan Direct Access SDK.
*[[Contributions:NeuroSky]]: Interface to Neurosky MindSet.
*[[Contributions:NicoletOne]]: Interface to NicoletOne nEEG series amplifiers.
*[[Contributions:ctfneurod]]: CTF RealTime to Neuroscan Acquire relay.
*[[Contributions:RDAClientADC]]: Brain Vision RDA socket protocol client.
*[[Contributions:TDTADC]]: Interface to Tucker-Davis Pentusa systems.
*[[Contributions:TMSiADC]]: Interface to TMSi Refa and Porti systems.
*[[Contributions:vAmpADC]]: Interface to Brain Products V-amp systems.
*[[Contributions:EnobioADC]]: Interface to Enobio sensor.
*[[Contributions:DSISerial]]: Interface to Dry Sensor Interface (DSI) EEG systems by Wearable Sensing.
*[[Contributions:MicRecorderFilter]]: Interface to the system soundcard, logging audio input.
*[[Contributions:actiCHampADC]]: Interface to the Brain Products actiCHamp system.

==See also==
[[User Reference:Filters]], [[Contributions:How to use a Contributed Source Module]]

[[Category:Contents]][[Category:Data Acquisition]]