Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 365 / 622

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