Calibration and Checks
Downloads
MarStock mode
Menu

Message Editing
"Options"
Parameter Table
Remote Version

Sounds Editing
Subject Response Mode
Thermometer COM Port
TSAII COM Port Troubleshooting Help
What's New

Introduction

Initialization

Medoc TSAII driver Window This UNC program communicates with the Medoc TSAII through an old Visual Basic 6 Medoc driver called "Shoval32.exe". When starting, this Medoc program attempts to communicate with the TSAII as shown at left.
Communication Failure Should communication fail to be established, an error message such as the one at left, or that one , will be displayed.
Sometimes communication fails on the first try and restarting the program may be sufficient provided the TSAII is connected, powered on, and the specified COM port is correct.
For more information troubleshooting initialization errors help.

Modes of Operation

Medoc TSAII
Medoc TSAII . . Subject Display . . Investigator's

Standard

Window

Calibration Check

Window
Report

MarStock Method

Window
Report

Subject Response

Window
Report

Downloads (VB.NET Version)

UNC Software Zipped Folder:

VB.NET version zipped folder with all the files needed to run the application.

UNC Application File:

VB.NET version application: : TSAII_UNC_2014_02.exe February 2014).

Needed Medoc Files:

Medoc Files to be included in the same folder as the executable file above must be purchased from Medoc with the TSA SDK package ($3,200 as of August 2008):
"SHOVAL32.EXE", "AAA.DRV", "Options.ini", "VATOD.DRV", "VSAATOD0.DRV", "VSAATOD1.DRV", "VSATABLE.DRV", "BLACKBOX.DAT" and "LogVAS.drv".
This file is used and modified by "SHOVAL32.EXE": Options.ini

Needed Windows Files:

These old dll's are normally not available on new computers but should be present in the application folder if otherwise not registered:
AxInterop.MCI.dll and Interop.MCI.dll

Other UNC Files:

These files are not required they are rewritten by the UNC software every time the program is exited. They save various settings that will be restored for the next run.
MessagesDefaultsOGM.ini , SoundsDefaultsOGM.ini , and TSA-II_DFTs.ini
These files are made available just for the convenience of the new users; they are examples of parameter tables.
Table1.tsa , Table2.tsa , MessageSoundDemo.tsa , and TableUp11.tsa

Remote Control of the TSAII:

VB.NET "Remote Control" must be in same folder as the SHOVAL32.EXE etc. : TSAII_UNC_Remote_2012.exe (13 January 2012) . (View Window)
...and its companion:
VB.NET "Remote Control Test" can be in any folder: TSAII_Remote_Control_Test.exe (13 January 2012) (View Window)

Standard

UNC TSAII VB.NET Main Window General instructions to program the table.

Menu:

File:

TSAII_File
The "File" menu options are not all visible: only those pertinent to the function in progress, as selected in the "Tools" menu, will be showing

Edit:

Tools menu

Tools:

Tools menu

Calibration, and Accuracy Check vs Calibration Check

Basics:

Calibration vs Calibration Check To compensate for the fact that Medoc does not provide a useful method for calibrating the TSAII (1C offset), three types of Calbration/TSAII Accuracy Checks are now available with this package:
  1. A TSAII Accuracy Check procedure (used to be called: "Calibration Check") to enable the user to verify the actual temperature put out by the TSAII when using other programs such as the Medoc WinTSA and Covas, and our previous versions. See also how to improve the TSAII accuracy.
  2. A Software Calibration procedure is now available. The calibration values are saved in the defaults file: "TSA-II_DFTs.ini". It is very important to understand that only this new version of UNC programs located in the same folder as the defaults file can take advantage of such calibration: none of the Medoc software nor our previous versions will be affected by this calibration in any way.
  3. A Software Calibration Check procedure that is similar to the TSAII Accuracy check procedure (#1 above) can also be performed while preserving the calibration settings, thus checking the effectiveness of the "Software Calibration".
All 3 features require a precision thermometer to be connected to the computer(see below).

Thermometer:

The thermometer supplied by Medoc is a YSI 4600 precision thermometer with an RS232 serial interface that can be connected to any computer with an RS232 serial port, or a USB port through a serial to USB adapter.

Thermometer COM Port:

COM Port Selection Window Selecting any of the 3 calibration and check features above will cause the software to search for a valid thermometer. Should the thermometer not be found, the feature will not be enabled, but clicking the menu => Tools => "Thermometer COM Port" will show the form at left permitting to manually select a COM port to help troubleshot the problem.

Options

Medoc Options:

TSAII COM port:

The COM port refers to the port to which the TSA II is connected (not to be confused with the YSI4600 thermometer COM port).
To find out to which COM port the TSAII is connected, go to the windows "Start" menu and select the Control Panel at the control panel in the "Hardware and Sounds" section, select View Devices and Printers. Below the "Devices" and the "Printers and Faxes", there should be an "Unspecified" section in which you should find the TSAII COM port that will appear and disappear as you plug and unplug the TSAII cable. If you are planning on using the pain "Magnitude Estimation" device, you should also see a mention of the "LabJack U3" device.

Temperature Offset:

TSAII_Options
The Medoc WinTSA and Covas programs have a special offset feature accessible through a special code. The range of this offset is ±1.0C. It permits correcting for differences between thermodes. If your thermode calibration is off and Medoc changed that offset for you, then you should type the same value in the "Temperature Offset" text box of the "UNC-TSA Options" form.

UNC Options:

Trigger Source.

(See Description of the Duration Parameters special feature)
The keyboard space bar is the only source normally available. The TTL input can only be used on TSA II equipped with the special Medoc TTL option.

Destination Delta.

(See Description of the Delta Parameters)
The keyboard up and down arrows are the only Destination Delta activation options currently available.

Program Settings.

These options are saved along with the parameter table at the end of the file (See sample parameter table file).

Data Sampling Rate.

Self explanatory.

Calibration Check Settings.

The "Precision" and the "Offset" are used in accuracy and calibration check modes, to decide whether the thermode "Passes" or "Fails" the test.

Sounds Editing

Messages Editing

Editing the Message List

Sounds Editing Messages Editing Deletion
  1. click the down arrow and select the message to be deleted.
  2. click the "Delete this Message" button.
Editing
  1. click the down arrow and select the message to be edited.
  2. Edit the message in the text box next to the selection number.
  3. Press the keyboard "Enter" key.
Insertion
  1. click the down arrow and select the message located where the new message is to be inserted.
  2. Enter/edit the new message in the text box next to the selection number.
  3. Click the "Insert this Message" button.

MarStock Method:

Mode Setting

The MarStock method is a threshold determination protocol for the thermal senses. It was originally developed by Drs. Heinrich Fruhstorfer and W. Schmidt of Marburg, and Dr. Ulf Lindblom of Stockholm.
The MarStock mode can be entered through the menu Tools => MarStock Mode => On.
If the parameter table is saved while this menu option is checked, the mode will be automatically entered whenever this same table is loaded.

Report

The MarStock report consists of a certain number of columns (6 in our example) containing the temperature at which the response was received, each followed by a column containing the device through which the response was received: KB = Keyboard spacebar; TSA = The TSAII mouse-like input device; ME = the UNC pain "Magnitude Estimation" device.
Four more columns give, first, the average of all the columns, and second, the average of all the columns except the first and the last (4 in our example).

Subject Response Mode:

Mode Setting

The subject response mode can be entered through the menu Tools => Subject Response Mode => On - Upward or Downward.
If the parameter table is saved while one of these menu options is checked, the mode will be automatically entered whenever this same table is loaded.

Report

The subject response report as it will appear on a spreadsheet.

Remote Control Mode:

Software Downloads:

UNC TSAII - VB.NET Software Help (13 January 2012).

Purpose:

It allows any software to control a TSA II using text files.

Description:

TSAII driver for remote control
...and its companion (for demo):
Remote control test program.

Command File:

The command file is generated by the controlling software and must be located in the same folder as the TSAII application.
Its name must be: TSAII_Remote_Cmd.txt.
It must contain one of the following:
  1. - A temperature command in C.
  2. - The word: "Off" to close the TSAII application.

Status File:

The Status file is generated as fast as the computer permits.
The Status file resides in the same folder as the command file.
Its name is: TSAII_Remote_Stat.txt.
It contains the TSA thermode tip temperature as reported by the TSA.
The absence of this file is an indication that the TSA is not online.

Remote feature test software:

Downloadable remote feature test software: TSAII_Remote_Control_Test.exe(VB.NET)

What's New

Calibration

Software Calibration

This program can now be used with more accuracy: it incorporates a software calibration that makes the TSAII more accurate by adjusting the commands to compensate for the inaccuracy of the device.

Software Calibration Check

The "Calibration Check" no longer checks the accuracy of the TSAII, instead, it checks the accuracy of the software calibration that only affects this program.

TSAII Accuracy Check

This is not a new feature; rather, it is a new name for the previously misnamed: "Calibration Check".

Use Calibration Check Box

A check box label: "Use Calibration" was added to the "Status" frame at the right side of the main window. When this box is checked, the software uses the calibration factor and offset determined by the last calibration.

Excel File

Recording is no longer sent directly to Excel, instead it is saved in a "csv" file that can later be displayed with any spreadsheet software, such as Excel, that recognizes this format (see sample file).

Magnitude Estimation Device

When the menu "Tools=>Magnitude Estimation=>On" is checked, this TSAII program communicates with the Magnitude Estimation program. The "Messages" are then displayed to the subject and the subject response can be recorded along with the thermal stimuli and/or used for timing when in "Subject Response" mode. The estimated pain magnitude is displayed in the main window. "Status" frame under: "Pain Magnitude" and the value display turns red whenever the Magnitude Estimation device "OK" button is depressed.

Stimulus On / Off

Now the user can turn the TSAII pump off (menu Tools=>Stimulus=>Off) when not in use without having to exit the program. Testing can be resumed by turning the "Stimulus" back on.

Temperature and Magnitude Estimation Recording

The temperature files are now saved in "csv" format. Whenever the "Magnitude Estimation" device is available and checked on in the tools menu, the estimated pain magnitude and "OK" button status are recorded alongside the temperature (see sample file).

TSAII COM Port Troubleshooting Help

Using the Program Menu=>Tools=>Options

  1. From "Edit" mode select the "Options" from the "Tools" menu.
  2. Clicking the COM Port combo box down arrow, will give you the list of COM ports currently present on the computer, including the one the TSAII is connected to, that should look something like this list.
  3. Disconnect the TSAII serial port at the computer end.
  4. Clicking the COM Port combo box down arrow again should show the same list minus the port that was just disconnected: the TSAII port. It should now look something like this list.
  5. Reconnect the TSAII serial cable.
  6. Click the COM Port combo box down arrow once more and select the COM port that just re-appeared.
  7. Click the "OK" button.
  8. Exit the program.
  9. Restart the program.
  10. You should now be able to hear the TSAII water pump chirping away, or should I say: sputtering away:)

Using Medoc Options.ini File

  1. Through the computer "Start" button open the "Control Panel" "Devices and Printers" . Locate the TSAII COM port (plugging and unplugging the TSAII USB cable will help identify the port).
  2. Open the Options.ini file in a text editor.
  3. In the [Miscellaneous] section, edit the line containing the COM Port number: " Port=COM#"
  4. Start the program.
  5. You should now be able to hear the TSAII water pump chirping away.

2011 October 04
Last updated 2014 October 28