Scanlab RTC 5 PC Interface Board - measurement_status

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
365
innovators for industry
Ctrl Command measurement_status
Function returns the status of a measurement session started via set_trigger or set_trigger4 and
the current position of the measurement pointer.
Call
measurement_status( &Busy, &Pos )
Returned
parameter
values
Busy measurement status as a pointer to an unsigned 32-bit value:
> 0: a measurement session is currently in progress
= 0: no measurement session is currently in progress
Pos current position of the measurement pointer (within the RTC
®
5’s
measurement storage area) as a pointer to an unsigned 32-bit value
(0 
Pos  2
20
–1 or 0  Pos  (2
19
–1) or Pos = 2
32
–1, see below).
Comments • If a measurement session started with set_trigger or set_trigger4 is no longer active,
then Pos +1 indicates the number of recorded data pairs up to termination (maximum
2
20
for set_trigger, maximum 2
19
for set_trigger4).
•
Pos = 2
32
–1 indicates that data recording still hasn’t occurred after
load_program_file.
• Stored data can be queried with get_waveform.
• The status of a measurement session will reset via set_trigger(
Period = 0),
set_trigger4(
Period = 0), stop_trigger or stop_execution (see set_trigger
comments).
RTC
®
4  RTC
®
5 unchanged functionality
Version info Last change with version DLL 516, OUT 515
References set_trigger .set_trigger4