Calibration and Checks
MarStock mode

Message Editing
Parameter Table
Remote Version

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



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.


Avoid running the UNC TSAII software while:
  1. the computer is performing a scan.
  2. the Wi-Fi is on.

Modes of Operation

Medoc TSAII . . Subject Display . . Investigator's



Calibration Check


MarStock Method


Remote Mode


Subject Response


Downloads (VB.NET Version)

UNC Software Zipped Folder:

VB.NET version zipped folder with all the files needed to run the application.
VB.NET version Beta 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).
VB.NET version application: : TSAII_UNC_2015.exe (May 2015 with "Remote" mode ).

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):
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:
apigid32.dll , AxInterop.MCI.dll , cw3230.dll , Interop.MCI.dll ,and user32.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

Sound Files:

"Wav" files of voiced numbers 1 to 12 can be found at this URL


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



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


Tools menu


Tools menu

Calibration, and Accuracy Check vs Calibration Check


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).


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.


Medoc Options:


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:

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.
  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.
  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.


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).

Remote Control Mode:

Software Downloads:

TSAII_UNC_2015.exe with the "Remote" feature (26 May 2015).
This application should be copied into the same folder as all the other files that came in the zipped folder.


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


The "Remote" mode must be entered through the "TSAII_UNC_2015.exe" program Menu => Tools => Remote Mode => On.
The controlling program must write the temperature commands in the command file and read the status file to learn of the current temperature as reported by the TSA.
Image of program in "Remote" mode.

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 exit the "Remote" mode.

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 either the TSA is not online or the specified folder for the TSAII_UNC software is incorrect.

Remote feature test software:

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

Remote Demo Program window

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.


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

What's New


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.

Remote Mode

See above

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 2015 July 02