ThermoHID Temperature Measurement Software

ThermoHID

Features
Version History
To Add a Function Series to the Chart
Known Problems
Useful Stuff
Observations
To Get the device working
To Delete the Program
Accuracy of the Device
Calibration of the Device
Downloading
FTP Help
Running as a Service
Screenshots
Donations
Useful links
Discussion Forum
Bug Reporting

For those of you who want to use 1-3 USB TEMPer HID devices (from PCSensor) here you have ThermoHID. The software is written in Delphi6 - so there is no need for any .NET framework here. I couldn't find any programs out there, with the features I wanted, so I made my own. These devices do not have any internal power, and therefore cannot work if they are not connected via a USB port.

Note: It does NOT support the older USB TEMPer devices that use a USB serial port (pre mid-2009)
Example: Device Manager reports the TEMPer Hum device as USB-Serial CH340

The following devices CAN be used:-

(without external probe)

(with external probe)

(internal and external probe)

(internal and relative humidity)

(internal and relative humidity. New)

(internal and external probe)

(without external probe, waterproof shell)

(without external probe. New)

(internal and K-Type thermocouple. New)

Features

MS Windows 2000/XP/Vista/7 (32bit and 64bit)

Integration of up to three HID Devices, in one chart

Support for the HID devices: TEMPer, TEMPer1, TEMPer2, TEMPerHUM, TEMPerNTC, TEMPerV1.2, TEMPer (gold), TEMPer1K2 and TEMPerHUMV1.0

Display in Celsius or Fahrenheit

Relative Humidity display (requires HID TEMPerHUM and/or Internet connection)

Upper and lower alarms for each device

Adjustable monitoring interval

To store automatically the data to disk

Automatic graphing

To email on alarm condition

To start a program on alarm condition

To play a sound on alarm condition

To send an SMS (Text) on alarm condition

To upload data to FTP, when the device is measured

Web Server for current temperatures and graph (with optional alarm sound)

Live zoom and automatic scroll of graph

Display of the maximum and minimum temperatures

Adjustable live view of the most recent readings

Graphical display of the difference of two temperatures

To send the temperature's data to URL, to add to a database, etc.

To read the current temperatures of your location (or any other location) from Weather Underground or Google (Internet Connection Required)

Alarm on relative differences between two devices

Show day/night indication on the chart

Devices can be corrected for inaccuracy, over many points.(calibrated)

The alarm for when the calculated dewpoint is reached (only TEMPerHUM)

Alarms can be inhibited at certain times of the day/night.

The alarm can be set for deviation from the current value of a function. E.g. average of device1.

Multi Language Support

Run as a Service

Due to the rate at which the program is changing at the moment, I haven't had time to write a manual for it. When it calms down a bit I'll start one. Until then, you have the tooltip help sprinkled throughout the program. If you have any difficulty working things out, then let me know, because it probably means that it needs to be put in the manual.

The program uses HidFTDll.dll to read/write to the devices, RDingUSB.dll to read/write to the new TEMPerV1.2 devices, and SonixUSB.dll to read/write to the new TEMPer1K2 devices

TODO (Things that are on my list to do)

User Manual

The program is currently distributed as freeware

Version History:

Older Version History

V2.0.1.23 Released 05 Sep 2011

Fixed bug: Fixed error in C to F conversion for external probe of Devices 2 and 3

Added: New '/list' command to Web commands

Changed: '/it=' to '/n=' Web Command

Added: Localization for the following languages: Spanish, Russian, Dutch, Japanese, German, Bulgarian, French, Portuguese.

Changed: Upper and Lower alarms now disabled if device not connected.

Changed: Primary and Secondary alarms are now called Sensor1 and Sensor2 alarms. (For clarity)

Added: Secondary Alarms (used to provide additional alarm if temperature continues to rise/drop)

Fixed: Corrected previous humidity value at program start up. (uses last value from loaded file)

Added: Support for new style TEMPerHUMV1.2 (Currently limited to 1 device)

Added: If 'Read every...' is set to '0' then the program will attempt the maximum possible measurement frequency. (Older type devices: Approx. 1 measurement every 2 seconds. Newer type devices: Approx. 4 measurements/second)

Added: Support for multiple instances. Two instances (in different folders) can now be run to support up to 6 devices.

Changed: Settings now saved when Settings window is closed as well as at program close.

Fixed: Time format can now work with millisecond resolution. (This does not change the time taken to take a reading.)

Changed: Chart library code version. (This means previously saved charts may need to be re-saved.)

Added: Option to turn off Internet Humidity when getting Internet Temperature.

Added: Support for TEMPer1K2 (Currently limited to 1 device)

Fixed: If chart was saved and Show Night activated then duplicate Night bands were shown when chart was reloaded.

Added: Real Time images of current temperature are now saved to disk for use by other applications e.g. WebcamXP

Changed: 'Read Temp' button now disabled if using new type devices.

Added: Title at top of Window now shows current temperature values.

Added: Alternative FTP method. (Selectable with 'Use Indy for Internet')

Fixed: Alarm email subject was sometimes blank.

Added: Password ability to Web server section.

Added: User defineable Timeout to FTP.

To Add a Function Series to the Chart

In the Chart Editor, (ThermoHID menu Options->Chart->Edit)
On the first tab (named "Chart"), select the Add... button to add a new Series to the Chart. In the TeeChart Gallery, choose the Line Series and press the 'OK' button
Press the 'Title' button and rename the series as required.
Select the 'Series' tab on the top row of tabs
Ensure that the new function series is selected in the drop down list
Select the 'General' tab
In the 'Horizontal Axis' box, ensure that 'DateTime' is checked
In the 'Vertical Axis' box, select 'Left' for TEMPerHUM devices, or 'Right' for all the other devices
Click the 'Data Source' tab, and choose 'Function' from the drop down box
In the 'Functions:' drop down box, select the Function that you require, e.g. 'Exp.Mov.Avrg.' (see the description below)
Click the 'Source Series' tab, and choose the graph(s) to use from the 'Available:' list.
When you have selected the ones you want,then press '>' to move it/them to the 'Selected' list.
In the 'Options' tab choose the required options e.g. calculate Exp.Mov.Avrg. every 10 points.
Click the 'Close' button when you have finished.

Function Types

Function Type	Description
Add	'Add' plots the sum of the inputs
Average	The Average Function will calculate the average of every group of Period points
Bollinger	The Bollinger Function uses simple or exponential moving average, to construct Bollinger Trading Bands
Copy	A direct copy of the input Series
Curve Fitting	This draws a fitted polynomial through data inputs, using the TypeFitting formula
Divide	The Divide Function plots inputs, divided in descending order of inclusion
Exponential Average	Exponential average based on Weight
Exponential Moving Average	Exponential moving average based on Weight
Exponential Trend	This draws the best exponential trend line through the points in an input series
High	The High Function plots the high point of inputs
Low	The Low Function plots the low point of inputs
MACD	Moving Average Convergence Divergence
Momentum	Each Y value is the current point's Y value, minus the last Period point's Y value
Momentum Division	Each Y value is the current point's Y value, divided by the last Period point's YValue, expressed in percents
Moving Average	The Moving Average Function will calculate the simple or weighted average of every group of Period points
Multiply	The Multiply Function plots the value of inputs multiplied together
Root Mean Square	The Root Mean Square Function plots the RMS value of the inputs
Relative Strength Index	The RSI Function calculates a percent value, based on financial data. Depending on TRSISyle type a different formula will be used to calculate the RSI value
Standard Deviation	This maps the Standard Deviation (or Complete Standard Deviation) of every group of Period points
Stochastic	This gets all points from the Source series, performs a function operation on points, and stores the results in the ParentSeries
Subtract	This plots the value of inputs subtracted in descending order of inclusion
Trend	This draws the best trend line through the points of the input Series

Known Problems:

Using the 'SimulRead' button makes the program unresponsive for the duration of the measurement time.

Any email Settings using Verizon, do not work.

Only one new type TEMPerV1.2, TEMPer1K2 or TEMPerHUMV1.0 can be used.

The 'Read Temp' button does not work with the new type TEMPerV1.2, TEMPer1K2 and TEMPerHUMV1.0 devices (Use 'SimulRead' instead).

The new type TEMPerV1.2, TEMPer1K2 and TEMPerHUMV1.0 devices and older devices cannot be mixed.

Useful Stuff:

If the data is copied to the clipboard and pasted into MS Excel, then, format the date/time column as Custom dd/mm/yyyy hh:mm:ss

Right-click the temperature display to set the precision (number of decimal digits to display)

The 'Read every' checkbox will act upon the last pressed button 'ReadTemp' or 'SimulRead'

You can change the names of the devices by pressing Options->Chart->Edit, and then hilighting the device that you want to rename and clicking the 'Title...' button.

You may need to switch on the countdown message for Firefox and MSIE7, if you want to update it in the Status Bar of the client's Web Browser. (For instructions see the web page source in the client's Web Browser).

'Send to URL' currently sends to the URL: 'device' (1,2 or 3), 'sensor' (t or h), 'temp' (the temperature or relative humidity) and 'type' (C, F or %).

Click and drag on the Alarm display area, to break it off and reposition it, if the screen resolution is small.

If you have proxy issues, then you can try and uncheck Help->'Use Indy for Internet'. (It uses the MSIE internet settings i.e. WinInet).

Relative Alarms will only work once per trigger (They currently don't use 'Single Shot' nor 'Latch' checkbox).

The small red dot next to each temperature/humidity display, denotes that it is 'calibrated'. (The hint shows by how much).

If a chart (*.tee file) is found called 'default.tee', it will be loaded on the program 'startup'.

If you would like to view or edit chart (*.tee) files then you can use TeeChart Office.

Please only delete series that YOU create. The program will crash if you try to delete the series that it came with.

To use the 'image' with WebcamXP (written for V5.5.0.8):-
In ThermoHID, go to Options->Settings
Choose the 'URL' tab.
In the section called 'Real Time Images' you will see an image for each device that you have connected.
Right-click on the image to change the settings to whatever you like.

In WebcamXP,
On the left side of the screen, click the 'Monitor' button
In the 'Source Selection' section click on the 'Overlay Editor'
Click on the fourth button from the left (Hint says 'Local Image')
Click in the camera image and browse to the 'ThermoHIDRealTimeX.png'
Double-click on the png file you have just loaded and tick 'Transparent' in the 'File' tab
In the 'Auto-refresh' box enter the number of milliseconds to refresh the image.
Click 'OK'
Drag the png to where you would like it and press 'OK'.

Observations

TEMPerV1.2 devices
The DLL does not have a function to enumerate devices (meaning, I don't know how to read multiple devices)
Each device has the ability to store a single calibration/correction value. (ThermoHID has its own table anyway)
My measurements show that they have an internal self-heating of approximately 1->2°C
They have a faster measurement time. Approximately 4 readings per second can be achieved compared with 1 reading every 2 to 3 seconds for the older devices.

To Get the device working

There are no configuration files or 'Setup' routine - it should just work when you plug it in and start the program.
The devices are seen as standard 'Human Interface Devices' (HID), and MS Windows 2000 and above should automatically install the required drivers
If you are having difficulty, please try these steps:
1) Put the 'ThermoHID.exe', 'HidFTDll.dll', 'RDingUSB.dll' and 'SonixUSB.dll' in a folder of your choice.
2) Start ThermoHID.exe
3) In the Options -> DLL menu option at the top, look to see if 'DLL Loaded' is greyed out and followed by some long number in brackets.
4) Plug in the device.
5) Ensure that the first button (just below the File menu) shows 'No Devices' if there are none plugged in, or it shows '1 device(s) found' if there is one device plugged in, etc.
6) Go to 'Help-> Debug' and look at the middle box at the bottom, which, when you move the mouse over it, pops up a tooltip saying 'HID Devices Found'. Each TEMPerHID device is found twice. (Sensor and LED)'. Ensure this box contains 'PCsensor Temper' or 'TEMPerV1.2' written twice.
7) Select 'Help->Debug' again to turn off the debug windows.
8) Press 'Read Temp' or 'SimulRead' button to read the device. The device should display the temperature where it initially says 'Temp1'.

If you are using MS Windows 2000, then 'HID.dll' from WinXP is required. This is provided in the downloaded zip.

To Delete the Program

There is no install/uninstall routine for the program.
If you want to delete it, then first start the program and check 'File->Use Ini File For Settings'
If necessary, untick it and then tick it again.
When you are asked 'Remove Registry Settings?' answer 'Yes'.
Ensure that 'Run when Windows Starts' in the Advanced Tab is unchecked.
The program can now be closed and the contents of the program folder can be deleted.
This may include the following files:-
ThermoHID.exe -> The program
ThermoHID.ini -> The Settings
HidFTDll.dll -> Library for accessing the TEMPerHID devices
RDingUSB.dll -> Library for accessing the new TEMPerHID and Waterproof TEMPerHID devices
SonixUSB.dll -> Library for accessing the new TEMPer1K2 devices
libeay32.dll -> Library for SMTP authentication
ssleay32.dll -> Library for SMTP authentication
InternetTempData_COMPUTERNAME_YYYY_MM.txt -> Internet Temperature Log
TempHIDData_COMPUTERNAME_YYYY_MM.txt -> Temperature Log
TempHIDData.txt -> Temperature Log
TempHIDGraph.jpg -> Graph of Temperature (used for Web Server)
ThermoHID.htm -> Output File to FTP
ThermoHID.txt -> Input File for FTP
ThermoHIDCal_COMPUTERNAME.cal -> Calibration offsets
SomeName.tee -> Saved chart files
ThermoHID.log -> Diagnostic log of program actions
ThermoHIDRealTime.txt -> Single line file containing the most recent measurements to be used for further processing.
ThermoHIDRealTime1.png -> Image of device1 current value for other applications e.g. WebcamXP
ThermoHIDRealTime2.png -> Image of device2 current value for other applications e.g. WebcamXP
ThermoHIDRealTime3.png -> Image of device3 current value for other applications e.g. WebcamXP

Accuracy of the Device

Has anyone tested these devices for accuracy?
If anyone has done any tests, I would be pleased to know the results.

Results of some accuracy testing on my devices.

Calibration of the Device

The "Cal. Temp" column holds the temperatures for which you have calibrated the device.
If you have calibrated at more temperatures than the two extremes shown by default, you can add rows with 'Edit->Add Row'.
The offset columns show the amount by which the read temperature is adjusted, to give the final "calibrated" temperature.
The offset at other temperatures, will be interpolated between these cardinal points.
Example1: if at 0 deg the offset=4 and at 100 deg the offset= -6 then at 50 deg the reading would be adjusted by -1 deg to show 49 deg
Example2: if your device is constantly overreading by, let's say, 3 deg, then, put in an offset of -3 deg for both -40 deg and 120 deg

Downloading

The program can be downloaded here:

(approx. 2MB)

If you want to use one of the languages below please place the .lng file in the same folder as the program.
Then in ThermoHID, go to Options->Settings. Select the 'Language' Tab. Select your desired language.
If you find any mistakes in the language (.lng) files please edit them with a Unicode editor ( e.g. BabelPad) and email the new file to me and I will put it on the website.
I you are willing and able to translate into any other languages then email me and I will supply the file to translate.
(Right click or option-click the link and choose "Save As..." to download this file.)

Russian Language File (updated 5 September 2011)

Japanese Language File (updated 5 September 2011)

Bulgarian Language File (updated 5 September 2011)

Dutch Language File (updated 5 September 2011)

French Language File (updated 5 September 2011)

Portuguese Language File (updated 5 September 2011)

Spanish Language File (updated 5 September 2011)

German Language File (updated 5 September 2011)

Greek Language File (updated 25 September 2011)

If you need to get in touch, my email address is in the program 'About' box or Help->Email the Author

Web Help for keywords that can be used in the FTP file template

In order to use FTP, first make a text file (template) with the HTML code that you would like to present on the destination site.
From the table below, place the codes (inside square brackets) that you wish to use into the HTML file at the appropriate places.
Save the file and reference it in 'Local Destination' on the FTP tab.

An example template suitable for an FTP file template can be downloaded here

Keyword	Example
[NumActiveDevices]	1 to 3
[TempUnits]	°F or °C or %
[Popup]	Popup Visible
[CommentText]	text to write to client web page
[History=x]	shows x number of history lines
[RangeText]	24 hours
[RefreshLimit]	1m
[PageCreateTime]	3/22/2010 10:51:59 AM
[CurrentInternetTemperature]	11
MeasTimeIntenetTemperature]	Last Updated on May 1,8:50 AM BST
[InternetTemperatureLocation]	Birmingham,UK
[CurrentInternetHumidity]	58
[InternetActive]	1
[CurrentInternetConditions]	Mostly Cloudy
The following end in a number for each device (1 to 3)
[DeviceID1]	Phil's Cubicle
[CurrentTemperature1]	75.9 or Temp1
[MeasTimeTemperature1]	3/22/2010 10:51:59 AM
[UpperAlarmLimit1]	80
[LowerAlarmLimit1]	70
[EitherAlarmState1]	OK or Triggered
[UpperAlarmState1]	OK or Triggered
[LowerAlarmState1]	OK or Triggered
[MinTemperature1]	68.6
[MaxTemperature1]	82.1
[LowTemperature1]	72.6
[AverageTemperature1]	73.9
[HighTemperature1]	76.7
[LastAlarmMeasTime1]	3/22/2010 10:51:59 AM
[CurrentHumidity1]	36.4
[DeviceType1]	HidTEMPer1
[CurrentExternal1]	27.1
[DeviationAlarm]	0.5
[DeviationTrace]	Average
[CurrentDeviation]	0.75
[DeviationAlarmState]	OK or Triggered
[Dewpoint1]	7.3
[DewAlarmState1]	OK or Triggered

See my own Latest FTP files

Running As A Service

ThermoHID can be run as a Service under Windows NT/2000/XP/2003/7
See this page for details

Advantages of doing so:
1) ThermoHID will automatically start when Windows starts, even before you log in. That’s helpful for continuous temperature monitoring, even with power interruptions, automatic system restarts, etc.
2) The running program will be invisible, with no icon in the system tray.

The downside is that you’ll need to have everything configured and ready to “run on autopilot.”
Program adjustments are a little more tedious to make since you cannot have the program running both as a service AND running the same EXE from your desktop.
To make a configuration change, you must
1) temporarily stop the service,
2) run ThermoHID.exe manually,
3) make your tweaks,
4) exit the program, and
5) restart the service.
Please be aware that, if you are storing the settings in the registry, then the settings will belong to the user that the service is started under.
If you only want one set of settings available then please ensure that File->Use ini file for settings is ticked.