Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 499 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
499
innovators for industry
RTC
®
4

RTC
®
5 new command
This command has no RTC
®
4 compatibility mode for
Value
.
References set_auto_laser_control
Undelayed
Short
List Command set_vector_control
Ctrl Command set_verify
Function Activates or deactivates a download verification (see page 88 ).
Call
OldVerify = set_verify( Verify )
Parameter
Verify
Parameter as an unsigned 32-bit value:
= 0: Verification is deactivated.
> 0: Verification is activated.
Result The
Verify
parameter that was active before calling the command (as an unsigned 32-bit
value)
Comments • If verification is activated, the download times will be extended.
• Complete download verification (as described in "Download Verification", page 88 )
requires driver version 1.0.4.0 or higher. Though older DLLs also function with the new
driver, verification would then either be limited to checking of list command downloads
(DLL version 511), or not functional at all (DLL version < 511). If a newer DLL (version
> 511) is used in conjunction with an older driver version, then it will return error code
9 (DriverCall error) during
load_program_file .
• Verification of correction file downloads only works if the correction file contains a
checksum (otherwise the error code
RTC5_VERIFY_ERROR
is generated). To ensure that
a checksum is present (which is not the case for older ct5 correction files), you should
test your correction file prior to loading by using the control command
verify_checksum . If the correction file didn’t contain a checksum, then this command
will create and insert a checksum into the file.
• The commands set_verify and n_set_verify are also available without explicit access
rights to a specific RTC
®
5 board. These commands only change settings in the DLL of
the specified (or default) board. They have no effect on the board itself.
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87 ) are neither generated nor altered by set_verify .
• As of DLL 535, activation of the verify option via set_verify can generate the
get_last_error return code
RTC5_OUT_OF_MEMORY
if a DLL-internal WINDOWS memory
request fails. In this case, the verify option remains deactivated.
RTC
®
4

RTC
®
5 new command
Version info • Available beginning with version DLL 511, OUT 510, RBF 504
• Change with version DLL 512: enhanced download verification
• Last change with version DLL 535 (see comment).
References get_error , get_last_error , verify_checksum