RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
277
Ctrl Command get_rtc_mode
Function returns the currently set operation mode of the RTC
®
5 DLL
Call
DLLMode = get_rtc_mode()
Result DLL operation mode as a 32-bit value:
=4: RTC
®
4 compatibility mode
=5: RTC
®
5 mode (default setting)
Comments • The DLL operation mode can be set via set_rtc4_mode, page 473 or set_rtc5_mode,
page 473. The default setting is RTC
®
5 mode.
•The get_rtc_mode command is also available without explicit access rights to a partic-
ular RTC
®
5 board.
• get_rtc_mode is not available as a multi-board command.
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87) are neither generated nor altered by get_rtc_mode.
RTC
®
4
RTC
®
5new command
References set_rtc4_mode, set_rtc5_mode
Ctrl Command get_rtc_version
Function returns the version number of the RTC
®
5 firmware (
RTC5RBF.rbf
) and additional
information about enabled options of the RTC
®
5 board
Call
RTCVersion = get_rtc_version()
Result RTC
®
5 version number as an unsigned 32-bit value:
Bit #0 (LSB) … Bit #7 Firmware version of the RTC
®
5 board
Bit #8 = 1: The Processing-on-the-fly option is enabled (see page 177).
Bit #9 = 1: The “second scan head control” option is enabled (see page 41).
Bit #10 = 1: The 3D option is enabled (see page 171).
Bits #11…#15 reserved
Bits #16…#23 DSP version number
Bits #24…#31 Firmware subversion of the RTC
®
5 board
Comments • The RTC
®
5 firmware version numbers are in the range 500 … 599. get_rtc_version
(bit#0…7) returns values in the range 0 … 99 (version number - 500).
• The current DSP version number is 2 (0 and 1 are older versions).
• The current firmware subversion is 0.
• For DLL 535 and higher: The firmware version can also be returned after an
RTC5_VERSION_MISMATCH
or
RTC5_ACCESS_DENIED
error. The return value is 0 if no
program has yet been loaded. Here, an
RTC5_TIMEOUT
error will not be generated.
RTC
®
4
RTC
®
5 unchanged functionality
Version info Change with version DLL 518, OUT 517: bits#16…23
Last change with version DLL 535: bits#24…31 (also see comment)
References get_hex_version, get_dll_version