Note for all A-D converters: Modern Macs lack built-in serial ports, so you'll need a USB to serial converter and driver software. The units made by Keyspan (now, TrippLite), specifically the USA-19HS, function reliably with LabHelper. Other brands have not worked well, or at all.
serial device sends a periodically updated stream
of text-format data consisting of numeric variables (delimited by
commas), with each batch of data concluded with a carriage return
character. In the window shown below, you can select which of the variables in a 'stream' to use. Variables are shown in the 'value'
column. Text blocks that do not convert into numbers (i.e., they
contain characters other than " + - . 0 1 2 3 4 5 6 7 8 9 ") are shown
as blank ('--').
The program knows the parameters of a number of streaming serial-capable instruments (mainly those from Sable Systems), such as the Sable RH-100 relative humidity sensor in the example at right. For a 'known' instrument, the appropriate variable labels are automatically inserted. If your instrument is not read correctly, try clicking the Reload data button.
- If your instrument is not recognized by LabHelper, fill in the 'label' edit fields with appropriate information (variable names) and click the 'Add to Instrument Database' button. You will be asked for a name for the instrument in a small window, and then the name and channel labels will be appended to the instrument list. This is a small text-format file called 'serial instrument database.txt', which should be in the same folder as the LabHelper application. You can edit this file yourself, but be sure to keep it in simple text (.txt) format.
numbers (shown in the rightmost column) are assigned according to the
order of selected variables in the sample string. Do not attempt to
adjust this in the Display
window or problems will ensue.
that responses to button clicks, etc. can be slow in this window,
since the software spends a lot of time reading and verifying the
serial data. Responses when gathering data can also be slow. For
example, to enter a marker, hold the key down until the marker
appears. Similarly, click and hold a toobar icon until you get the
response you want.
this mode there is no 'handshaking:' the serial device is not controlled
by the computer (it's just 'listened to'). LabHelper checks each
sample string to make sure it is complete before it is accepted for
processing, but the update rate is pretty much entirely a property of
the serial instrument.
- Use the 'select' check buttons to indicate which variables to use. When you
select a variable, the computer automatically gives it a channel
can enter channel labels here, or later in the Conversions window or the Display
- The program will use the last-received data from each instrument channel to generate and upper or lower limit for screen display, as shown in the the Display
setup window. These are arbitrarily set to ~1.2 times the current data value; you will likely want to change them before starting to acquire data.
Serial connections are simple in principle but can be tricky in
practice. If you have problems, start by making sure the baud rate is correct (the default is 9600 baud).