RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
284
Ctrl Command get_sync_status
Function returns the master/slave synchronization status of the addressed RTC
®
5 board.
Call
MasterSlaveSyncStatus = get_sync_status()
Result Master/slave synchronization status [0 … 640] as an unsigned 32-bit value:
< 11: The board is synchronized to the master board (or to the preceding board in
the master/slave chain)
= 640: The addressed board is operated as master.
Comments • For usage of this command, see chapter 6.6.3 "Master/Slave Operation", page 84.
• If the addressed board has not been initialized previously via load_program_file, the
get_sync_status returns 0.
• First synchronize the boards of the master/slave chain via the sync_slaves command
before using get_sync_status.
•To ensure that get_sync_status will actually return the current master/slave synchroni-
zation status, you should first have already triggered an external list start for the master
board via an external start signal or a command (see section "External List Start" on
page 210). This list start then initiates measurement of the time differences between
each board’s /SLAVE start pulse and the corresponding 10 µs clock. This time difference
gets stored on each board as the master/slave synchronization status (in units of 15 ns)
and remains stored there until the a new external list start is triggered for the master
board. This gives you the flexibility to query the synchronization status via
get_sync_status even at a later point in time.
• In the synchronized state, measured time differences are shorter than the transit time
difference for synchronization between the boards themselves (see page 84):
master/slave synchronization status < 11. The master/slave synchronization status is
typically 7.
• In a not-explicitly-synchronized state (prior to sync_slaves), the master/slave synchro-
nization status might coincidentally be < 11. If so, then the boards will behave as if
synchronized.
RTC
®
4
RTC
®
5 new command
Version info Available beginning with version DLL 531, OUT 532, RBF 523
References sync_slaves, get_master_slave