Metrologic Optimus R, Руководство по программированию

Страница: 43 / 241

Chapter 3 Terminal Specific Function Library 37
Description Upon calling this routine, the user program stops running and jumps to the
kernel, and then the Program Manager will take over the control.
The Program Manager menu is displayed.
Return None
See Also
ActivateProgram, LoadProgram, ProgramInfo
UpdateBank
Purpose To copy a user program from SRAM to flash memory.
Syntax int UpdateBank (const char *filename);
char *filename; /* file name of program to be loaded */
Example
val = UpdateBank ("PlayTest");
Description This routine copies a user program from the file system (SRAM) to Program
Manager (flash memory).
A file name can be 8 bytes at most, the null character not included.
If the file name specified is identical to that of an existing program in flash
memory, the new program will replace the old one.
Otherwise, it will be stored in an automatically assigned residence
location.
Return
If successful, it returns the residence location of program, i.e. slot 1 ~ 6.
On error, it returns -1.
See Also DownLoadProgram, UpdateUser
UpdateUser
Purpose To make a user program (.SHX) in SRAM become the active program.
Syntax
int UpdateUser (const char *filename, int mode, int remove);
char *filename;
/* pointer to a buffer where filename of the program is stored */
int mode; /* clear or keep file system */
int remove; /* if file system is kept, may remove the program from it */
Example
val = UpdateUser ("PlayTest", KEEP_FILE_SYSTEM, 0);
/* activate the program, and keep the file system as well as this program */
Description This routine copies the desired program from the file system directly to the
active area of the Program Manager in flash memory, and thus makes it become
the active program. The original file system may be kept or cleared (
mode
).