RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
553
Ctrl Command verify_checksum
Function tests for the presence of a checksum or creates a checksum for a correction file.
Call
verify_checksum( Name )
Parameter
Name
name of the correction file as a pointer to a null-terminated ANSI string
Result Result of the test (as an unsigned 32-bit value)
= 0: No error (the tested checksum is o.k.)
= 1: A checksum was newly created (no info about file integrity).
= 2: The tested checksum is incorrect.
= 3: A checksum could not be determined (file error, etc.)
Comments • Verification of correction file downloads only works for files that contain a checksum
(see page 88 and set_verify).
•The verify_checksum command is also available without explicit access rights to a
particular RTC
®
5 board.
• verify_checksum is not available as a multi-board command.
• The programs
CorrectionFileConverter.exe
(version 1.04) and
correXion5.exe
(version 1.01) together with
RTC5Base.dll
(version 1.0.0.4) already automatically
create check sums for the output files.
• The board-specific error variables
LastError
and
AccError
(see "Error Handling", page
87) are neither generated nor altered by verify_checksum.
RTC
®
4
RTC
®
5new command
References set_verify
Normal
List Command
wait_for_encoder
Function waits until the selected encoder counter has overstepped or understepped the specified
count for the first time.
Call
wait_for_encoder( Value, EncoderNo )
Parameters
Value
Count as a signed 32-bit value; allowed range: [–2
31
…+(2
31
–1)]
EncoderNo
Number of the to-be-used encoder counter as an unsigned 32-bit value,
allowed values:
= 0: Encoder counter Encoder0
= 1: Encoder counter Encoder1
Comments • The command is synonymous with wait_for_encoder_mode with parameter
Mode
=0
(see comments there).
RTC
®
4
RTC
®
5 new command
References wait_for_encoder_mode