Recommended for Windows 7 OS.

Installation
Parameter Table Help

Installation

Supported Hardware

WINDOWS machines with Microsoft .NET Framework 3.5 (free to download from Microsoft)

Software Downloads

See below.

Running for the first time.

Software Download

VB.NET software for the UNC-CNSD Thumb Nail Stimulator controller with LabJack U12 data acquisition and the newer version (to come soon) with the LabJack U3 data acquisition. Just downloading the executable file will not work unless you have previously installed a version of this software and all the needed files. VB.NET also requires "Framework3.5" to be installed.
Some problems were reported running this version under Windows XP. XP users who experience problems with this version should got back to the VB6 version downloadable from: The original "Thumb Nail Stimulator Software Help."

Files associated with the VB.NET Thumb Nail software:
  1. AxInterop.MCI.dll
  2. Interop.MCI.dll
  3. ljackuw.dll
  4. LJDotNet.dll
  5. ThumbNail2012_U12.exe - 11 September 2012
  6. TubeTest.exe
  7. NoSound.wav A silent wave file used to initialize the sound system to prevent a long delay the first time a sound file is used.
  8. ThumbNail_DFTs.ini
    And if you use this defaults file you may want to also have the specified parameter table:
  9. DeltaTest.dnc

Software Help

General Info.

The software layout is based on a software package originally developed for the Medoc TSA II thermode controller. The parameter table and the sound option are practically identical in both packages; anybody familiar with one should have no problem mastering the other.
The basic system consists of a Thumb Nail Stimulator pressure controller (Visual Interface front panel) and an optional dual push button switch input unit to replace the Medoc TSA mouse like input box.

Parameter Table Description.

Definition of Parameters

Parameter Table Help in HTML form (With "Sounds", Magnitude Estimation device "Messages" and TTL input Options).

File Format

The tables are saved in text files with the ".dnc" extension. Their format is as follows:
Line 1: number of columns
Each following line represents each column of the table. Each parameter separated by commas in the same order as in the table:
"Destination" (amplitude in PSI), "Delta" (PSI), "Rate" (PSI/sec.), "Duration" (sec.), "Jump to" (column number), "Repeat", Sound.
Example parameter text file:

7
0,,,-1,,,,
10,,,3,,,1,
20,,,3,,,2,
40,,,3,,,3,
70,,,3,,,4,
100,,,3,2,2,5,
,,,,,,6,
Number of columns in the table.
Set pressure at 0 PSI and wait for Space Bar.
Go to 10 PSI, Sound the wave file defined by #1, Stay at 10 PSI for 3 seconds.
Go to 20 PSI, Sound the wave file defined by #2, Stay at 20 PSI for 3 seconds.
Go to 40 PSI, Sound the wave file defined by #3, Stay at 40 PSI for 3 seconds.
Go to 70 PSI, Sound the wave file defined by #4, Stay at 70 PSI for 3 seconds.
Go to 100 PSI, Sound the wave file defined by #5, Stay at 100 PSI for 3 seconds, then jump to column #2 two more times.
Go to 0 PSI, Sound the wave file defined by #6, End of program.

Followed by the "options" below. Sample parameter file (Text File)

Options.

NEW August 2010
Except for the "Pressure" options that remain the same for all the parameter tables, these options are saved along with the parameter table data and caution should be taken that they be set correctly whenever the tables are being saved to disk.

Trigger Source

1 - Specifies the way to skip to the next parameter table column during an experiment, when the "Duration" is set to a negative value (other than a time in seconds).
2 - Specifies the way to perform an "Emergency Jump" when the column number in the jump row is set to a negative number (See sample parameter table). The optional dual push button switch input unit should be used for this purpose rather than the keyboard spacebar.

Destination Delta

Specifies the way to increase and decrease the "Destination" value, when the parameter table "Delta" value is other than zero. The optional dual push button switch input unit can be used for this purpose as well as the keyboard "Page Up" and "Page Down" keys..

Program Settings

These option settings are saved along with the index of the selected column at the time the table is being saved to disk.
Program Starts at: Instead of always starting the experiment at column #1 of the parameter table, it is possible to have the experiment start at whatever column has been selected. This option however could present some problems with inexperienced users and, in some cases, should be avoided.
Table is disabled check box: To avoid accidently entering bad data into the parameter table it is possible to "disable" it through this option.

Pressure

Hardware Factory Maximum -- The pressure regulators are ordered to meet the user specifications. Because the pressure command to the regulator has a range of 0 to 10vdc corresponding to 0 PSI to the factory maximum, this maximum will have to be entered into the new software options “Factory Maximum (PSI)” text box (shown on the left), for the software to correctly adjust the command amplitude.
-- The software can still be limited to a lower maximum by entering its value into the “Maximum allowed (PSI)” text box.
-- The "Adaptation stimulus" should probably be called something like the "Idle Pressure". Instead of returning to a zero pressure it is recommended to keep a very low pressure to prevent any movement of the subject thumb in relation to the plunger.
-- The “PSI limiting jumper” electronically limits the maximum to approximately ½ the “Factory Maximum”. It is imperative that this check box agrees with the actual position of the hardware jumper on the circuit board. A calibration must also be performed whenever the jumper position is changed.

Miscellaneous.

Force Display

The units of force to be displayed are selectable through the "menu/View/Units of Force" option.
The displayed force is derived from the pressure in PSI, the area of the piston applying the force, and the selected choice of unit of force. The piston area is set at the factory and is saved in the "Defaults" file named : "ThumbNail_DFTs.ini" and should only be changed if found to be erroneous. Sample "Defaults" file. Because the pressure is measured in PSI (pound per square Inch), the piston diameter is in inches (Sorry, it is Reagan's fault if the US is the only country in the world to have never adopted the metric system).

Tube color

The color of the empty portion of the tube, as well as the color of the liquid, can be changed by clicking on the portion to be changed. A standard color dialog opens in order to permit color selection.

Calibration

Calibration panel.

In Case of Problems

The main window does not show on the monitor.

The window location specified in the defaults file may be off the current monitor. Press "F2" to restore the location to x=0 y=0.

Thumb Nail not found - or - In Edit Mode?

The intent of the edit mode is to design and test parameter tables without the pressure controller being attached to the computer interface unit.
When in "Edit Mode", the information text box and selected column background colors become beige (See a jpeg image of the front panel in edit mode).
To revert to "Normal Mode" go to the menu "Tools" then "Thumbnail Pressure" and click on "On".
The front panel gage and information text background colors should turn aquamarine (as seen on this jpeg image).

Should the software experience difficulties finding the interface unit...
Several messages, including those mentioned at the top of this page, may appear depending on the circumstances:
If the Thumb Nail Stimulator is not connected to the computer: No LabJack found
If several LabJack DAQ units are connected to the computer: Several LabJacks found
If the Thumb Nail Stimulator is the only LabJack connected to the computer, but is a different unit from the last time the software was used:
or
If the Thumb Nail Stimulator is the only LabJack connected to the computer, but this is the first time it is used:
One LabJack found
If the Thumb Nail Stimulator is connected to the computer, but its power is off: Thumb Nail Power is Off

Testing the Computer Interface Unit.

A jumper was added to the circuit board as an option to wrap the "command out" around to the "pressure feed back" / "Monitor" that normally comes from the pressure regulator (See schematics and jumper J7 location a 50KB GIF file).


  To: Thumb Nail Stimulator main page.

2006 October 23
Latest update 2012 September 11