Scanlab RTC6 PCIe Board - Mark_Serial

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
535
innovators for industry
Normal List
Command
mark_serial
Function Marks the current serial number of the serial-number-set most recently selected by
select_serial_set_list (or of serial-number-set 0 after load_program_file) in the selected
format at the current position. Afterward the serial number is (optionally) automatically
incremented.
Call mark_serial( Mode, Digits )
Parameters Mode Selection of the serial number format and (de)activation of automatic serial
number incrementing. As an unsigned 32-bit value.
Mode = 20 × M
1
+ 10 × M
2
+ M
3
Allowed value range: for M
1
[0, 1], for M
2
[0, 1], for M
3
[0…2].
a) Selection of the character set for digit marking.
• M
1
= 0: The indexed text string for digits [30…39], as defined by
load_text_table or set_text_table_pointer, is marked.
• M
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
selected (previously) with select_char_set.
b) Incrementing of the serial number after marking.
• M
2
= 0: The serial number is incremented after marking.
• M
2
= 1: The serial number is not incremented after marking.
c) Marking of leading zeros.
• M
3
= 0: Leading zeros are marked as zeros. Dependent on M
1
the
corresponding indexed text string definition (Index = 30) or the indexed
character definition ’0’ is used.
• M
3
= 1: Leading zeros are suppressed (left-justified marking).
• M
3
= 2: Leading zeros are marked as blank characters (right-justified
marking). Dependent on M
1
the corresponding indexed text string
definition (Index = 29) or the indexed character definition ’ ’ is used.
Digits Number [0-12] of to-be-marked digits. As an unsigned 32-bit value.
Allowed value range: [0-12]. Larger values are clipped.
Comments • The first serial number to be marked must have been previously specified by set_serial,
set_serial_step or set_serial_step_list; otherwise, the starting serial number is 0. The
starting serial number can have a maximum length of 10 digits.
• With every call of mark_serial, the serial number is formatted in accordance with M
3
and when M
2
= 0 it is automatically incremented before the actual marking. Here, the
increment size is 1 unless otherwise specified by set_serial_step or
set_serial_step_list.
• The current serial number can be queried with get_list_serial, for example, after an
aborted list to determine if the current number has been incremented or not.
• If the incremented serial number exceeds 10
Digits
, then marking begins again at 0. The
control command set_max_counts allows specification of the maximum number of
External Starts and thus the maximum number of markings. Here, all markings of all
serial-number-sets contribute jointly to the count.