Scanlab RTC6 PCIe Board - Get_Serial; Get_Serial_Number

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
424
innovators for industry
Ctrl Command get_serial
Function Returns the current serial number of the serial-number-set selected by select_serial_set
(or of serial-number-set 0 after load_program_file).
Call CurrentSerialNo = get_serial()
Result Serial number.
As a 64-bit IEEE floating point value.
Comments • For usage of get_serial, see Chapter 7.5.2 ”Marking Serial Numbers”, page 210.
• get_serial should not be confused with get_serial_number, which returns the
product serial number of the RTC6 board.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References select_serial_set
Ctrl Command get_serial_number
Function Returns the individual serial number of the active RTC6 board.
Call RTCSerialNumber = get_serial_number()
Result RTC6 serial number.
As an unsigned 32-bit value.
Comments • Serial numbers of installed boards are ascertained by init_rtc6_dll and cached in the
RTC6 DLL, from where you can query them by get_serial_number.
• get_serial_number is helpful when using several RTC6 boards in one computer (see
Chapter 6.6 ”Using Several RTC6 PCIe Boards in One PC”, page 123). The associated
multi-board command n_get_serial_number can be used for determining the
relationship between the installed boards and the RTC6 DLL-internal numbers assigned
to them during initialization. The RTC6 DLL-internal numbers are newly assigned
during each initialization of a user program (see init_rtc6_dll) and must be supplied
for a variety of commands (in particular, all multi-board commands). The number of
boards found during initialization can be queried by rtc6_count_cards.
• get_serial_number and n_get_serial_number is available even without (current)
explicit access rights to a specific RTC6 board. However, the return values are 0 as long
as no access to the addressed board has been successful at least once before.
• The board-specific error variables LastError and AccError (see Chapter 6.8 ”Error
Handling”, page 130) are neither generated nor altered by get_serial_number.
RTC4RTC6 Unchanged functionality.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References rtc6_count_cards