RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
540
Normal List
Command
mark_time
Function Marks a part of the time previously stored by time_fix, time_fix_f or time_fix_f_off in the
specified format at the current position.
Call
mark_time( Part, Mode )
Parameters
Part
Specifies which part of the time to mark.
= 0: Hours (24-h time, no a.m./p.m.)
= 1: Minutes
= 2: Seconds
= 3: Hours (12-h time, no a.m./p.m.)
= 4: a.m./p.m. (automatically switched in accordance with 24-h time)
As an unsigned 32-bit value.
Allowed value range: [0…4].
Mode
Format.
As an unsigned 32-bit value.
Allowed value range: [0…3], only affects
Part =
0…3).
a) Number of leading zeros:
Bit #0 = 0: Leading zeros are suppressed.
Bit #0 = 1: Always two digits.
b) Character set choice for marking of digits:
Bit #1 = 0: The indexed text strings for digits [0…9], as defined by
load_text_table or set_text_table_pointer, are marked.
Bit #1 = 1: The indexed characters for digits [0…9], as defined
by load_char or set_char_pointer, are marked.
The desired character set can be
specified with select_char_set.
a.m./p.m. (Part = 4) can only be marked in accordance with the indexed text
strings (Index = 40, 41) defined by load_text_table or
set_text_table_pointer. Here, the parameter Mode is ignored.
Comments • Before marking times (after every boot-up), the RTC6 and PC times should be
synchronized (see time_update) and the current (to be marked) time should be stored
with time_fix, time_fix_f or time_fix_f_off, see Chapter 7.5 ”Marking Dates, Times
and Serial Numbers”, page 210.
• The complete time can be marked by multiple calls of the mark_time command.