Scanlab RTC 5 PC Interface Board, Инструкция по установке и эксплуатации

Страница: 332 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
332
innovators for industry
Comments • For
Name
= 0, only the internal management tables will be initialized as with
Mode
= 0
(no loading will occur, no “empty“ binary file must be provided). Otherwise, the
load_disk command can only be used for reading files that were stored with save_disk .
• For all indexed characters, text strings and subroutines in the specified file, load_disk
executes a corresponding load_char , load_text_table or load_sub command. The
corresponding list commands are thereby written to the protected memory area and
appropriate entries are made in the internal management tables in accordance with the
index assignment stored in the file. If there is no character, text string or subroutine for
a particular index in the specified file, then no list commands will be loaded for this
index, and if
Mode
> 0 then any already existing entries in the internal management
table will remain unaltered. Thus, supplementary loading of indexed characters, text
strings and subroutines from various files is possible.
• Together with the save_disk command, load_disk can be used, for example, to defrag-
ment the protected memory area and to subsequently protect subroutines (see page 78
and page 79 ). If the characters, text strings and subroutines come from various files,
then defragmentation can be achieved if the first file is loaded in
Mode
= 0 and subse-
quent files are loaded with
Mode
> 0, provided that no indices are used simultaneously
in different files. Memory gaps in the protected area caused by dereferencing of
indexed characters, text strings or subroutines will be thereby closed.
• If, during loading, the end of the protected memory area is reached before the end of
the file (EOF), then all further list commands in the file will be ignored. Likewise, incom-
plete characters, text strings and subroutines (as with individual
load_char ,
load_text_table or load_sub commands) will not be stored. Before each load_disk
command, be sure that the memory configuration provides a sufficiently large
protected area above the list areas (“List 1” and “List 2”). The
save_disk command
returns the number of list commands stored in the file. If a board changes ownership,
it is the user’s responsibility to ensure that the memory configuration data is consistent
(
Mem1
and
Mem2
are queried from the DLL, not from the board – also see get_config_list
and page 86 ).
• If the specified file is corrupt and can’t be read to the end, then only the characters, text
strings and subroutines fully readable to that point will be stored.
• The command will be ignored ( get_last_error return code :
RTC5_PARAM_ERROR
) if
“List 3” hasn’t been assigned a memory area (
Mem1
+
Mem2
= 2
20
). The command will
likewise 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, if a list has only been paused via
set_wait ( PAUSED status set), then load_disk can be executed. But the user is respon-
sible for ensuring that no still-needed commands will be overwritten, e.g. if set_wait
was called from an indexed subroutine.
• While the load_disk command is running, no other commands can execute. During
execution of the command, external starts will be suppressed.
RTC
®
4

RTC
®
5 new command
References save_disk
Ctrl Command load_disk