RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
263
Ctrl Command get_error
Function returns the cumulative error code (i.e. a list of error types occurring since the last reset or
error reset).
Call
AccError = get_error()
Result error code as an unsigned 32-bit value
If multiple errors occurred, then multiple bits will be set.
Error constants are predefined for the specific errors.
Bit Error type Error constant
no error
RTC5_NO_ERROR
=0
Bit #0 (LSB) = 1: no board found
(this error can only occur via init_rtc5_dll)
RTC5_NO_CARD
=1
Bit #1 = 1: access denied
(this error can occur via init_rtc5_dll, select_rtc,
acquire_rtc or any multi-board command)
RTC5_ACCESS_DENIED
=2
Bit #2 = 1: command not forwarded
(this error implies an internal, PCI or driver error, e.g. caused
by a hardware defect or an incorrect connection)
RTC5_SEND_ERROR
=4
Bit #3 = 1: no response from board
(it is likely that no program has been loaded onto the
RTC
®
5; this error can especially occur in connection with
control commands that expect a response, e.g.
get_hex_version)
RTC5_TIMEOUT
=8
Bit #4 = 1: invalid parameter
(this error can occur through all commands for which
invalid parameters are not automatically corrected to valid
values, e.g. parameters with limited choices such as
get_head_para; if this error occurs for a list command, it
will be replaced with list_nop; if this error occurs for a
control command, it will not be executed)
RTC5_PARAM_ERROR
=16
Bit #5 = 1: List processing is (not) active
(e.g. for execute_list, if a list is currently being processed
e.g. for stop_execution, if no list is currently being
processed
e.g. for restart_list, if pause_list was not previously
called)
RTC5_BUSY
=32
Bit #6 = 1: List command rejected, illegal input pointer
(e.g. for any list command directly after load_char +
list_return: the list command will then not be loaded)
RTC5_REJECTED
=64
Bit #7 = 1: List command was converted to a list_nop
(e.g. set_end_of_list in a protected subroutine)
RTC5_IGNORED
= 128
Bit #8 = 1: Version error: DLL version (driver DLL), RTC version
(firmware file) and HEX version (DSP program file) not
compatible (also see load_program_file)
RTC5_VERSION_MISMATCH
= 256
Bit #9 = 1: Verify error: The download verification (see page 88) has
detected an incorrect download.
RTC5_VERIFY_ERROR = 512
Bit #10 = 1: DSP version error: DSP version too old (this error only occurs
with older RTC
®
5 boards – see get_rtc_version bits #16-23
– and only through a few commands such as
mark_ellipse_abs; the corresponding command
description’s “Version info” section contains related
comments; Commands that generate the error will neither
be executed nor replaced by list_nop)
RTC5_TYPE_REJECTED
= 1024
Bit #11 = 1: A DLL-internal Windows memory request failed RTC5_OUT_OF_MEMORY
= 2048
Bit #12 = 1: EEPROM read or write error (can occur during initialization
or auto_cal)
RTC5_EEPROM_ERROR
= 4096
Bits #13…
#15
reserved