View source for Contributions:NeuSenW

==Location==
http://{{SERVERNAME}}/svn/trunk/src/contrib/SignalSource/NeuSenW

==Versioning==
===Author===
Jintao Li, Frontier Lab for Applied Neurotechnology (https://ant.chenfrontierlab.com), Tianqiao and Chrissy Chen Institute

===Version History===
* V1.00 - 09/15/2022
* V2.00 - 10/08/2022

===Source Code Revisions===

==Functional Description==
This Source module allows BCI2000 to receive electrophysiological data from one single NeuSenW device.

==Known Issues==
This module requires the VS2012 C++ runtime to be installed (https://www.microsoft.com/en-us/download/details.aspx?id=30679). If the runtime is not installed, you will get an error for a missing DLL!

==Usage of Device==
<gallery mode="packed" widths=800px heights=350px>
File:Neusenw_picture_1.jpg|Figure 1: NeuSenW
</gallery>
<gallery mode="packed" widths=800px heights=350px>
File:Neusenw_picture_2.jpg|Figure 2: Smart Sync Center
</gallery>
<gallery mode="packed" widths=800px heights=350px>
File:Neusenw_picture_3.jpg|Figure 3: Dongle
</gallery>
These are all devices you need to use the Source module: NeuSenW amplifier, Smart Sync Center, and the dongle provided by Neuracle. 
Start by connecting the Smart Sync Center to the power source. Then, turn on the amplifier and plug the dongle into the computer. No other software is needed. Make sure the computer and amplifier are connected to the Smart Sync Center through Wi-Fi.
<gallery mode="packed" widths=800px heights=350px>
File:Neusenw_picture_4.jpg|Figure 4: Trigger Box
</gallery>
The trigger box can record a variety of types of events (such as sound, light, program output), with sufficiently high timing accuracy and neurophysiological data synchronously, but it is not supported by the current version of the Source module.

==Setting Up BCI2000==
Once you compiled BCI2000 correctly and generated the solution, create a batch file to run the NeusenW Source Module. Just copy one of the existing batch files in BCI2000/batch. Then replace the first line beginning with "Start executable" with "Start executable NeusenW --local".

==Usage Steps==
Make sure that the device and computer are connecting to Smart Sync Center and the dongle is plugged in before you start BCI2000.
# Double click the batch file you just created.
# Click the "Config" button.
# Set suitable parameters. Detail about these parameters can be found below.
# Click "Set Config".
# Click "Start" to start the experiment.

==Parameters==
===SourceCh===
Define the number of signal channels to be acquired from the NeusenW device given the constraints. Only certain channel numbers are supported for specific sampling rate defined by SamplingRate. When the SamplingRate is not bigger than 1000 Hz (250 Hz/500 Hz/1000 Hz), there is no limit to this parameter. When the SamplingRate is 2000 Hz, SourceCh cannot be bigger than 32. When the SamplingRate is 4000 Hz, the maximum of SourceCh is 16. When the SamplingRate is 8000 Hz, the maximum of SourceCh is 8. When the SamplingRate is 16000 Hz, the maximum of SourceCh is 4. This parameter does not support the “auto” setting.

===SampleBlockSize===
Depending on the system configuration (Neuracle's triggerbox enabled/disabled, wired vs. wireless connection), data acquisition may not be stable, and data loss may occur, when SampleBlockSize is less than 40 ms (i.e., 40 at 1000 Hz sampling rate). This parameter does not support the “auto” setting.

===SamplingRate===
The NeusenW device supports 7 different sampling rates: 250 Hz, 500 Hz, 1000 Hz, 2000 Hz, 4000 Hz, 8000 Hz, and 16000 Hz. This parameter may limit the value of SourceCh as described above. This parameter does not support the “auto” setting.

===SourceChGain===
Use 'auto', or a list of SourceCh numbers of 1.

===SourceChOffset===
Use 'auto', or a list of SourceCh numbers of 0.