Scanlab RTC6 PCIe Board - Create_Dat_File

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
349
innovators for industry
Ctrl Command create_dat_file
Function Generates a new RTC6DAT.dat file of the current version.
Call Version = create_dat_file ( Flag )
Parameters Flag As a signed 32-bit value.
1: Generates a new RTC6DAT.dat file and returns the current version.
–1: Only returns the current version.
Result Version As an unsigned 32-bit value.
> 600: Current version.
0: create_dat_file cannot be executed
(get_last_error return code RTC6_BUSY
or no program is loaded on the RTC6).
1: Not enough Windows memory
(get_last_error return code RTC6_OUT_OF_MEMORY ).
2: The output file cannot be opened
(get_last_error return code RTC6_PARAM_ERROR ).
Make sure that you have write permissions granted for the output
path containing the RTC6DAT.dat .
Comments • Earlier RTC6DAT.dat versions cannot be used anymore.
Otherwise, load_program_file returns error code 7
(get_last_error return code RTC6_VERSION_MISMATCH ).
• RTC6DAT.dat version information is available only after load_program_file has also
been executed with the current RTC6 DLL instance.
• RTC6DAT.dat version information is not taken over when acquiring an RTC6 board (no
matter if it is already initialized or not).
• A newly generated RTC6DAT.dat (of a specific version) can be used at any time for all
RTC6 boards that require the same version.
• Each newly generated RTC6DAT.dat contains (besides static initializations) also:
– user definable tables which have been loaded earlier by load_varpolydelay,
load_auto_laser_control, load_jump_table, load_jump_table_offset,
load_position_control
– a “freely definable wobbel shape” which have been defined earlier by
set_wobbel_vector
The user definable tables are automatically available after the next load_program_file
whereas the “freely definable wobbel shape” requires a set_wobbel_mode ( Mode > 1 )
call in addition.
• Note that creat
e_dat_file overwrites an already existing RTC6DAT.dat w
ithout warning.
Keep a copy of your original RTC6DAT.dat in a safe place.
• create_dat_file cannot be executed, while a list is being processed
(get_last_error return code RTC6_BUSY ).