Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 294 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
294
innovators for industry
Ctrl Command get_waveform
Function transfers to the PC the data that was measured and stored onto the RTC
®
5 via set_trigger
or set_trigger4
Call
get_waveform( Channel, Number, Ptr )
Parameters
Channel
measurement channel [1 or 2; if recordings started via set_trigger4 , then also
3 or 4]; specified as an unsigned 32-bit value
Number
number [1…2
20
for set_trigger , 1…2
19
for set_trigger4 ] of measured values
to transfer; specified as an unsigned 32-bit value. Values of measurement
positions 0 to (
Number
–1) will be transferred.
Ptr
pointer (in C and C ++ data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to a location in the PC’s memory to where the measured values should
be transferred
Comments • In the following cases, no data is transferred ( get_last_error return code
RTC5_PARAM_ERROR
):
– if
Number
= 0
– if
Number
> 2
20
– if
Number
> 2
19
when
Channel
= 3 or 4 was selected or if a file was loaded as cor-
rection table
No
=3 or
No
=4 with load_correction_file
– if
Ptr
= NULL
• PCI transmission errors will generate the get_last_error return code
RTC5_SEND_ERROR
.
• Before calling get_waveform , you can check via measurement_status whether a
measurement session is currently running that was started with set_trigger or
set_trigger4 . We recommend not reading any data when data recording is currently
active. The number
Pos
for the last (or current) data pair of the measurement session
can be queried via measurement_status . No more than
Pos
+1 data elements should
be read. Any further elements are from earlier recordings or the initialization.
RTC
®
4

RTC
®
5 Essentially unchanged functionality, however:
Even in RTC
®
4 compatibility mode, all values are in the RTC
®
5’s 20-bit range, but get
transferred to the PC as 32-bit data. Therefore, you must evaluate the values accordingly
(see comments for
get_value ).
Version info Last change with version DLL 536, OUT 536:
Channel
= 3 and 4
References set_trigger , set_trigger4 , get_value , get_values