Scanlab RTC6 PCIe Board - Page 811

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
811
innovators for industry
Normal List
Command
time_fix_f_off
Function Stores the current time and date of the RTC clock/calender or a forward-dated date and
time for use with mark_date and mark_time in a cache.
Call time_fix_f_off( FirstDay, Offset )
Parameters FirstDay Defines the starting number for determining the Julian calendar day from
the current date of the RTC calendar: Counting proceeds from FirstDay to
FirstDay + 364 (+1 for leap years).
As an unsigned 32-bit value.
Offset Forward dating. In seconds.
As an unsigned 32-bit value.
Allowed value range: [0…(2
32
–1)].
Comments • Before calling time_fix_f_off, time_fix_f or time_fix, synchronization of the RTC6 and
PC time should be performed (for RTC6 boards, at least once after each
load_program_file) by time_update.
• The complete time can be marked through multiple calls of mark_time and the
complete date through multiple calls of mark_date. time_fix_f_off, time_fix_f or
time_fix must therefore be called before these marking commands so that the to-be-
marked time or date do not change during marking.
• If time_fix_f_off, time_fix_f or time_fix are not called again before a time or date
marking, then the last marked time is marked again. If time_fix_f_off, time_fix_f or
time_fix are not called at all after a load_program_file, then a time of 00:00 or a date
of January 1, 2000 is marked.
• If Offset = 0, then the current date and current time are fixed. One practical use of
forward dating ( Offset > 0) is for setting a date of expiry based on the current date.
• Backdating ( Offset < 0 ) is not possible.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References time_fix, time_fix_f, time_update, mark_time, mark_date