Kontron Bootstrap Loader - Manual (Page 15)

Bootstrap Loader
2/98 Page 9 © PEP Modular Computers
3 OS-9 Module Support
3.1 General
The commands lsmod, rmmod and ldmod can be used to display, delete, load and update OS-9 modules on base of a single
module.
The progress of searching, loading, removing and programming modules can be monitored over the term port. None of the
displayed characters indicate an error. The characters displayed have the following meaning:
• s Valid OS-9 module found
• r Read S-record; valid and in range
• e Rease sector
• p Programm record
Note: Every OS-9 module contains a header with a parity value and a CRC value for the whole module. Both values are
checked and only modules having a valid header parity and a valid CRC value are accepted as OS-9 modules.
3.2 Display OS-9 Modules
The command lsmod displays a list of all valid OS-9 modules in the programmable FLASH area. It is always an extended
list displayed which is similar to the output of the OS-9 utility 'mdir -e'.
If there is any gap between two modules the command produces a separate line, giving information about the position and
the size of the gap. This line is indicated by '*** gap ***'.
After the last valid module is displayed the command produces a special line giving information about the position and the
size of the free FLASH area. This line is indicated by '*** gap ***'.
3.3 Removing OS-9 Modules
Every OS-9 module displayed with lsmod can be removed with rmmod. Removing a module will unrecoverable remove
the module from the FLASH. The resulting gap in the FLASH is filled by shifting all modules behind the removed module.
Note: At least one module must stay in the FLASH. This module cannot be removed.
Note: Removed modules cannot be recovered.
3.4 Loading and Updating OS-9 Modules
With the command ldmod existing OS-9 modules can be updated and new modules can be loaded over the serial connec-
tions term or ser0 using S-records.
Loading a module which is already in the FLASH will remove the existing module from the FLASH. Removing a module
will unrecoverable remove the module from the FLASH. Loading an existing module will always update the existing mod-
ule in the FLASH. There is no check of the module edition number. The new module is always programmed behind the
last module in the FLASH.