Contributions:Blackrock - Revision history

Gmilsap: /* NSPInstances */

2016-03-27T00:51:03Z

NSPInstances

← Older revision		Revision as of 00:51, 27 March 2016
Line 97:		Line 97:

	===NSPInstances===		===NSPInstances===
	This parameter determines how many NSPs you intend to record from. Setting this parameter to '2' enables the hardware synchronization described earlier, and using more than 2 NSPs is untested.		This parameter determines how many NSPs you intend to record from. This is the other parameter that you might want to play with, but only if you have more than one NSP. Setting this parameter to '2' enables the hardware synchronization described earlier, and using more than 2 NSPs is untested.

	===DigitalOutput===		===DigitalOutput===

Gmilsap: /* Parameters */

2016-03-27T00:49:47Z

Parameters

← Older revision		Revision as of 00:49, 27 March 2016
Line 78:		Line 78:

	==Parameters==		==Parameters==
	This module used to fully-configure the NSPs directly from BCI2000. The NSP system is sooo configurable that this became a big source of headaches. In the most recent version, BCI2000 will auto-configure ~~everything based on~~ the ~~currently selected~~ SampleGroup. The NSPs always acquire data at 30Khz, but channels can be added to a SampleGroup which is downsampled (with antialiasing) in real-time by the NSP before being streamed over ethernet to receivers. You can add channels to these channel groups in the Central software by enabling continuous streaming on individual channels, and selecting the sampling rate.		This module used to fully-configure the NSPs directly from BCI2000. The NSP system is sooo configurable that this became a big source of headaches. In the most recent version, you will configure the recording setup using the Blackrock "Central" software, and BCI2000 will auto-configure to match the SampleGroup dictated by the SamplingRate parameter. The NSPs always acquire data at 30Khz, but channels can be added to a SampleGroup which is downsampled (with antialiasing) in real-time by the NSP before being streamed over ethernet to receivers. You can add channels to these channel groups in the Central software by enabling continuous streaming on individual channels, and selecting the sampling rate.

	The following parameters are available for configuring the Blackrock source module. You will find these parameters in the Source -- Signal Properties section.		The following parameters are available for configuring the Blackrock source module. You will find these parameters in the Source -- Signal Properties section.

Gmilsap: /* Multi-NSP Synchronization */ clarification

2016-03-27T00:46:34Z

Multi-NSP Synchronization: clarification

← Older revision		Revision as of 00:46, 27 March 2016
Line 71:		Line 71:

	In order to enable NSP Hardware Synchronization:		In order to enable NSP Hardware Synchronization:
	* Connect Digital Output 1 on any of the NSPs to Analog Input 16 on all the NSPs. You'll probably need BNC T-Connectors for this.		* Connect Digital Output 1 on any '''one''' of the NSPs to Analog Input 16 on all the NSPs. You'll probably need BNC T-Connectors for this.
	* Ensure Analog Input 16 is in the same SampleGroup as the channels you wish to acquire using BCI2000.		* Ensure Analog Input 16 is in the same SampleGroup as the channels you wish to acquire using BCI2000.
	* If BCI2000 recognizes that Analog Input 16 is being acquired at the correct SamplingRate on all NSPs and that there is more than 1 NSP, hardware synchronization will occur automatically upon SetConfig.		* If BCI2000 recognizes that Analog Input 16 is being acquired at the correct SamplingRate on all NSPs and that there is more than 1 NSP, hardware synchronization will occur automatically upon SetConfig.

Gmilsap at 00:40, 27 March 2016

2016-03-27T00:40:09Z

Show changes

Gmilsap: /* Functional Description */

2013-08-10T20:29:09Z

Functional Description

← Older revision		Revision as of 20:29, 10 August 2013
Line 25:		Line 25:

	You will also need to change your interface's network configuration ([http://www.howtogeek.com/howto/19249/how-to-assign-a-static-ip-address-in-xp-vista-or-windows-7/ Windows]):		You will also need to change your interface's network configuration ([http://www.howtogeek.com/howto/19249/how-to-assign-a-static-ip-address-in-xp-vista-or-windows-7/ Windows]):
	IP address: 192.168.137.XXX where XXX is less than 128. Ensure no other computers have this same address on this switch.		* IP address: 192.168.137.XXX where XXX is less than 128. <u>This number needs to be below 16 and not 10.</u> Ensure no other computers have this same address on this switch.
	Subnet Mask: 255.255.255.0		* Subnet Mask: 255.255.255.0
	Default Gateway: <Blank>		* Default Gateway: <Blank>
	To test your network configuration, open a terminal or command prompt and type '''ping 192.168.137.128'''. This is the NSP's default network address. If you can ping the NSP, you should be able to run the module.		To test your network configuration, open a terminal or command prompt and type '''ping 192.168.137.128'''. This is the NSP's default network address. If you can ping the NSP, you should be able to run the module.

Gmilsap: Finalized v1.0 Documentation

2013-01-30T16:46:58Z

Finalized v1.0 Documentation

← Older revision		Revision as of 16:46, 30 January 2013
Line 45:		Line 45:
	The following parameters are available for configuring the Blackrock source module. You will find these parameters in the Source -- Signal Properties section.		The following parameters are available for configuring the Blackrock source module. You will find these parameters in the Source -- Signal Properties section.
	===SourceCh===		===SourceCh===
	~~"Source:Signal%20Properties int SourceCh=~~ 144 ~~// number~~ of ~~digitized~~ and ~~stored~~ channels		The Blackrock module supports a maximum of 144 analog channels. The first 128 of these channels are the analog EEG channels, and the following 16 are the analog input channels on the NSP itself.
	===AnalogCh===		===AnalogCh===
	~~"Source~~:~~Signal%20Properties intlist~~ AnalogCh= 0 ~~// Analog~~ channels to acquire ~~from Blackrock~~		This parameter specifies what channels to acquire from the NSP. Again, the first 128 of these channels are the analog EEG channels, and the following 16 are analog input channels on the NSP itself. You can specify this parameter in two ways.
			====Manual====
			Specify a vector of 144 '0's and '1's; where there are ''SourceCh'' '1's. Example:
			SourceCh = 16;
			AnalogCh = 0 0 0 1 0 0 0 1 1 1 0 0 0 0 0 0 1 1 1 0 0 0 1 0 0 0 0 0 1 0 0 0 1 0 0 0 1 0 1 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0
			This parameterization acquires channels 4, 8, 9, 10, 17, 18, 19, 23, 29, 33, 37, 39, 44, 50, AINP1, and AINP2
			====Automatic====
			If you just want a sequential number of channels starting from channel 1, specify the number of channels to acquire as a negative number. Example:
			SourceCh = 32;
			AnalogCh = -32;
			This parameterization acquires channels 1-32. NOTE: 0 is interpreted as -144 which means every channel is acquired.
	===SignalFilter===		===SignalFilter===
	~~"Source:Signal%20Properties int SignalFilter= 0 // Filter~~ to ~~apply~~ to ~~data:~~		The following filters can be applied to DESTRUCTIVELY filter the data on the NSP before it is passed to BCI2000.
	*0 -- No Filter		*0 -- No Filter
	*1 -- HP 750Hz		*1 -- HP 750Hz
Line 64:		Line 74:
	*12 -- BP 250Hz-5kHz		*12 -- BP 250Hz-5kHz
	===SampleBlockSize===		===SampleBlockSize===
	~~1000 //~~ number of samples ~~transmitted at~~ a ~~time",~~		Any number of samples is valid here: even 1. You may want to not do that, however. Clocking the system above 20-30 Hz [http://www.youtube.com/watch?v=2FM3Em7FIOc is a bad choice].
	===SamplingRate===		===SamplingRate===
	~~30000Hz~~		Only the following sample rates are supported.
			500
			1000
			2000
			10000
			30000
			==Future Work==
			*Digital Input as States
			*Digital Output
			*Serial Input
			==See also==
			[[User Reference:Filters]], [[Contributions:ADCs]]

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

Gmilsap: More information

2013-01-29T20:07:08Z

More information

← Older revision		Revision as of 20:07, 29 January 2013
Line 19:		Line 19:
	The Blackrock source module is used for acquiring recordings from the Blackrock NSP through CereLink (https://github.com/dashesy/CereLink). It also happens to be one of the first BCI2000 SignalSource modules to function under Linux. This documentation explains the parameterization and specifics on how to set up the system.		The Blackrock source module is used for acquiring recordings from the Blackrock NSP through CereLink (https://github.com/dashesy/CereLink). It also happens to be one of the first BCI2000 SignalSource modules to function under Linux. This documentation explains the parameterization and specifics on how to set up the system.

	===~~Compilation~~===		===Configuration===
			Building the Blackrock module should copy .bat files for standard experiments into the batch directory, in addition to a parameter fragment for the amplifier, placed in parms/fragments/amplifiers.

	~~===Installation===~~		Ensure your machine is connected to a switch or router that the NSP is also connected to. This module communicates to the NSP using UDP, and is susceptable to packet loss. In the event of a lost packet, the module will crash (this is rare with a good switch). Ensure you have a commercial grade switch to avoid dropping packets. You can also use a crossover cable to connect directly to the NSP, but this prevents other computers from receiving data from the NSP.

	===~~Configuration~~===		You will also need to change your interface's network configuration ([http://www.howtogeek.com/howto/19249/how-to-assign-a-static-ip-address-in-xp-vista-or-windows-7/ Windows]):
			IP address: 192.168.137.XXX where XXX is less than 128. Ensure no other computers have this same address on this switch.
			Subnet Mask: 255.255.255.0
			Default Gateway: <Blank>
			To test your network configuration, open a terminal or command prompt and type '''ping 192.168.137.128'''. This is the NSP's default network address. If you can ping the NSP, you should be able to run the module.

			====Windows====
			This should work out of the box with standard parameters.
			====Linux====
			If you encounter a segfault or error message on SetConfig, one of the most common issues is with permissions. NSP 6.03 and previous opens port 1002 and 1001 to communicate packets. This was a rather unfortunate choice, as administrative privileges are required in order to open ports below 1024 on standard *nix systems. NSP Firmware 6.04+ uses higher port numbers to avoid this problem. If you're running 6.03 firmware or below, you will need to start the Blackrock module with administrative privileges. One way to accomplish this is to comment out the "Start Blackrock" line in your batch file, and launch the Blackrock module from a separate terminal with "sudo ./Blackrock", executed from the bci2000/prog directory.

			You may also receive an error complaining about the size of your network buffer size:
			Socket memory assignment error
			Consider using sysctl -w net.core.rmem_max=8388608
			or sysctl -w kern.ipc.maxsockbuf=8388608

			Depending on your operating system (OSX or your favorite flavor of Linux) you should execute one of these commands with administrative privileges. You will need to do this once every time the computer reboots. There may be a way to do this on boot using some config file somewhere. If you have any ideas, edit this section. net.core.rmem_max is the proper key to use for Fedora 17.

	==Parameters==		==Parameters==

Gmilsap: Documentation Template (WIP)

2013-01-25T19:55:26Z

Documentation Template (WIP)

New page

==Synopsis==
The Blackrock acquisition module enables signal acquisition from Blackrock Microsystems Cerebus and Neuroport acquisition hardware through the CereLink "cbsdk".

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

==Versioning==
===Author===
Griffin Milsap (griffin.milsap@gmail.com)
===Version History===
*V1.0 -- Analog Signal Acquisition and Digital Filtering Functionality
===Source Code Revisions===
*Initial development: 4365
*Tested under: 4365
*Known to compile under: 4365
*Broken since: N/A

==Functional Description==
The Blackrock source module is used for acquiring recordings from the Blackrock NSP through CereLink (https://github.com/dashesy/CereLink). It also happens to be one of the first BCI2000 SignalSource modules to function under Linux. This documentation explains the parameterization and specifics on how to set up the system.

===Compilation===

===Installation===

===Configuration===

==Parameters==
The following parameters are available for configuring the Blackrock source module. You will find these parameters in the Source -- Signal Properties section.
===SourceCh===
"Source:Signal%20Properties int SourceCh= 144 // number of digitized and stored channels
===AnalogCh===
"Source:Signal%20Properties intlist AnalogCh= 0 // Analog channels to acquire from Blackrock
===SignalFilter===
"Source:Signal%20Properties int SignalFilter= 0 // Filter to apply to data:
*0 -- No Filter
*1 -- HP 750Hz
*2 -- HP 250Hz
*3 -- HP 100Hz
*4 -- LP 50Hz
*5 -- LP 125Hz
*6 -- LP 250Hz
*7 -- LP 500Hz
*8 -- LP 150Hz
*9 -- BP 10Hz-250Hz
*10 -- LP 2.5kHz
*11 -- LP 2kHz
*12 -- BP 250Hz-5kHz
===SampleBlockSize===
1000 // number of samples transmitted at a time",
===SamplingRate===
30000Hz