RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
278
Ctrl Command get_serial
Function returns the current serial number of the serial-number-set selected via select_serial_set
(or of serial-number-set 0 after load_program_file).
Call
CurrentSerialNo = get_serial()
Result Serial number (as 64-bit IEEE floating point value)
Comments • For command usage, see chapter 7.5.2 "Marking Serial Numbers", page 150.
• This command should not be confused with get_serial_number, which returns the
product serial number of the RTC
®
5 board.
RTC
®
4
RTC
®
5new command
References select_serial_set
Ctrl Command get_serial_number
Function returns the individual serial number of the active RTC
®
5 board
Call
RTCSerialNumber = get_serial_number()
Result RTC
®
5 serial number as an unsigned 32-bit value
Comments • Serial numbers of installed boards are ascertained by init_rtc5_dll, page 306 and
cached in the DLL, from where you can query them via get_serial_number.
• The command get_serial_number is helpful when using several RTC
®
5 boards in one
computer (see chapter 6.6, page 83). The associated multi-board command
n_get_serial_number can be used for determining the relationship between the
installed boards and the DLL-internal numbers assigned to them during initialization.
The DLL-internal numbers will be newly assigned during each initialization of an appli-
cation (see init_rtc5_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 via rtc5_count_cards (page 396).
•The get_serial_number and n_get_serial_number commands are also available
without explicit access rights to a specific RTC
®
5 board.
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87) are neither generated nor altered by get_serial_number.
RTC
®
4
RTC
®
5 unchanged functionality
References rtc5_count_cards