beautypg.com

Usb_tc08_get_temp_deskew – Omega Speaker Systems 8 Channel Thermocouple USB Data Acquisition Module TC-08 User Manual

Page 37

background image

Technical reference

33

3.3.3.5

usb_tc08_get_temp_deskew

long usb_tc08_get_temp_deskew
(

short handle,
float * temp,
long * times,
long buffer_length,
short * overflow,
short channel,
short units,
short fill_missing

)

Same as

usb_tc08_get_temp

but the times take account of small differences caused

by the order in which channels are converted. Note: Unless there is a specific reason
to use the

usb_tc08_get_temp_deskewed

routine, use

usb_tc08_get_temp

instead.

Arguments

handle

Specifies the USB TC-08 unit.

temp

Pointer to a location where the temperature is to be
placed.

times_ms_buffer

Returns the exact time that this channel was
converted (optional.)

buffer_length

Specifies the length of the sample buffer.

overflow

Pointer to a variable that will be assigned a value of
1 if an overflow occurred on any of the readings
copied into temp_buffer, or 0 if an overflow did not
occur. An overflow occurs when the input signal is
higher than the measuring range of the USB
TC-08.

channel

Specifies the channel to read the temperature from.

units

Specifies the temperature units in which the data
are returned:

0: USBTC08_UNITS_CENTIGRADE
1: USBTC08_UNITS_FAHRENHEIT
2: USBTC08_UNITS_KELVIN
3: USBTC08_UNITS_RANKINE

Voltages are always returned in millivolts.

fill_missing

Choose whether or not to replace QNaN values
(missing readings) with the last known value:

0 - Use QNaNs to represent missing readings.
1 - Fill missing readings (no QNaNs.)

Returns

-1

An error occurred, use

usb_tc08_get_last_error

to

get the code.

0

Currently no readings to collect.

> 0

Number of readings copied into array (there may
still be more readings in the driver's internal
buffer.)