Scanlab RTC6 PCIe Board - Page 849

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
849
innovators for industry
Normal List
Command
wait_for_timestamp_counter_long
Function Waits for an absolute 64-bit “Timestamp Counter” value.
Call wait_for_timestamp_counter_long( WaitCounterL, WaitCounterH, MaxWaitTime, Mode )
Parameters WaitCounterL Lower part of the 64-bit “Timestamp Counter” value to wait for.
As an unsigned 32-bit value.
WaitCounterH Upper part of the 64-bit “Timestamp Counter” value to wait for.
As an unsigned 32-bit value.
MaxWaitTime Longest waiting time.
As an unsigned 32-bit value.
Mode Routines after a timeout.
As an unsigned 32-bit value.
= 0: Ignore the RTC6 command.
Continue with next list command.
= 1: Abort list by stop_execution.
= 2: Abort list by simulate_ext_stop including forward to all
slaves, see Chapter 6.6.3 ”Master/Slave Operation”, page 124
and Chapter 9.3.1 ”Starting and Stopping Lists by External
Control Signals and Master/Slave Synchronization”, page 289.
> 2: Wait endlessly until an External Stop occurs.
Comments • wait_for_timestamp_counter_long waits until the current
64-bit “Timestamp Counter” has reached the following value:
WaitCounterL + ( WaitCounterH << 32 )
• This allows absolute time references to a synchronization point in time defined in the
user program to be established when loading a list. Accuracy: 10 µs.
• An error flag is set, if:
– The specified point in time has already passed when
wait_for_timestamp_counter_long is reached
– The requested waiting time is beyond the running 64-bit “Timestamp Counter” by
more than MaxWaitTime .
The error flag can be read out by get_startstop_info( Bit #5 ).
The Mode parameter determines how to proceed in case of a timeout.
• Synchronization with other RTC6 commands, such as wait_for_encoder or conditional
commands, depends on external hardware.
• See Chapter 8.12 ”Time Measurements”, page 281.
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 624, OUT 624.
References get_timestamp_long