Scanlab RTC 5 PC Interface Board, Installation And Operation Manual

Page: 330 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
330
innovators for industry
Comments Other notes:
• RTC
®
5 correction tables contain parameters that formerly (with an
RTC
®
4/RTC
®
3/RTC
®
2) had to be manually copied into an application from a supplied
ReadMe file. To directly integrate these parameters into the user program, the RTC
®
5
can load them via get_table_para (page 285) from the currently loaded correction
table or read them via get_head_para (page 265) from the assigned correction table.
• During execution of load_correction_file , no other control commands can be
executed; external starts will be disabled.
• The load_correction_file command will be ignored ( get_last_error return code :
RTC5_BUSY
) if the board’s BUSY status is currently set (list is being processed or has been
halted via pause_list ) or the board’s INTERNAL-BUSY status is currently set. In contrast,
the command is executed when a list has been paused via set_wait ( PAUSED status set).
But for older versions (prior to DLL 521, OUT 521), you should absolutely call
select_cor_table before restarting a list. This ensures a smooth transition via
jump_speed
from the old galvanometer positions to the new ones. Otherwise, hard
jumps can occur (also see notes on page 123 ).
• If an
RTC5_VERSION_MISMATCH
error occurs (return value 11), a DLL version appropriate
for the program file must be chosen and the board must be made currentless (to unload
the program software) or alternatively program files appropriate for the DLL version
must be reloaded via the multi-board command
n_load_program_file (after
RTC5_ACCESS_DENIED
, the single-board command load_program_file does not get
access rights for the board). Only afterward (and after the board has been accessed via
acquire_rtc or select_rtc and possibly specified as default board via select_rtc )
load_correction_file can be normally executed again.
RTC
®
4

RTC
®
5 Other than its primary purpose and its first two parameters (loading of correction files),
the command’s functionality has substantially changed:
• The command now uses the new parameter
Dim
. This allows, for instance, storage of
3D correction files as 2D correction tables and storage of 2D correction files as 3D
correction tables.
• Now, two 3D correction tables can be stored in RTC
®
5 memory (in the 3D-enabled
version). However, two 3D correction tables can not be simultaneously assigned to the
scan head control ports (see select_cor_table , page 400 ).
• The parameters
k
,
Phi
and
Offset
no longer exist. Therefore, table transformations
(scaling, rotation, translation) are no longer possible during loading of the correction
file. Such coordinate transformations can now be specified via
set_scale (page 474) ,
set_angle (page 405) and set_offset (page 463) in addition to set_matrix (page 449) .
• As of version DLL 521, OUT 521, select_cor_table is automatically called (see
comments above and notes on page 123 ).
• As of version DLL 527, OUT 529, the command only returns after the correction motion
has completed (see comments above).
• As of version DLL 533, OUT 534 up to four correction files can be loaded (see comments
above)
Version info Last change with version DLL 533, OUT 534 (see above)
Ctrl Command load_correction_file