Bootstrap Loader A software package for on-site programming of FLASH devices Manual Order Nr.
Preface Bootstrap Loader Revision History Index Comment 0100 First Issue 0110 Load/remove of OS-9 modules Date Initiator September,1997 acb Jan. 1998 mf This document contains proprietary information of PEP Modular Computers. It may not be copied or transmitted by any means, passed to others, or stored in any retrieval system or media, without the prior consent of PEP Modular Computers or its authorized agents.
Bootstrap Loader Page 0- 2 Preface © PEP Modular Computers 2/98
Table Of Contents Bootstrap Loader Table of Contents Chapter 1 Introduction .............................................................................1 Chapter 21 System Operation .....................................................................2 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.10 2.11 Startup...............................................................................................2 Entering the Command Mode ...........................................................
Table of Contents Bootstrap Loader 3.4 3.5 3.6 Loading and Updating OS-9 Modules ..............................................9 Example using OS-9 development system.......................................10 Example using Hyperterminal from Windows 95® or Windows NT® ...........................................................................10 Chapter 4 Command Reference ............................................................11 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 Boot Wait .................
Bootstrap Loader BOOTSTRAP LOADER FOR VM 30, VM 162, VM 172, VM(6)62, VM(6)42, VSBC 32, IUC-32, (V)IUC, VSBC-4, SMART I/O AND SMART II (CM302) 1 Introduction The Bootstrap Loader is a stand-alone software located in FLASH memory which allows the user to safely update the contents of the FLASH and delay the boot process for a specified time. The Bootstrap Loader has the capability of programming FLASH memory from “MOTOROLA S-RECORDS” or from an absolute memory address.
Bootstrap Loader 2 System Operation 2.1 Startup After system reset, the Bootstrap Loader is started. It searches the FLASH memory area for a valid start key. If this start key is found, the Bootstrap Loader checks the 'BootWaitTime' from serial EEPROM or RTC. If the entry is valid, the continuation of the boot process is delayed by this time while flashing the green front panel LED to indicate that the system is alive but waiting for continuation.
Bootstrap Loader 2.3 Preparing the Image The image must be compiled / linked to run from the FLASH base address of the CPU. The image must start with the ResetSP / ResetPC vectors as usual for ROM / FLASH images on 68000 processor boards. A binary image must be converted to Motorola S-records or loaded to a VME memory board with battery-backup, FLASH or EPROM population. 2.4 Programming with Motorola S-Records Programming is done with the If command. The If command accepts S1, S2 and S3 records.
Bootstrap Loader Host: xmode /t0 baud=38400 nopause iniz /tO Target: pf ser0 38400 lf -u Host: binex -s3 -a=4000000 pbVM42 >/t0 2.6 Example using DOS The host is assumed to be a PC with Windows, Windows95 or WindowsNT. A serial cable is used to connect the ser0 port of the board to program to COM2 of the PC. Additionally, we assume that we want to program a Motorola S-record built for address 0, e.g the VxWorks file bootrom.hex. The serial connection should run at 19200 Baud.
Bootstrap Loader WARNING ! When programming FLASH memory, *NEVER* press the RESET button or cycle power! This may damage the Bootstrap Loader and will consequently leave the board unusable due to damaged FLASH contents. The ABORT button may be used to cancel a running operation. '-q' suppresses all messages and warnings except error messages.
Bootstrap Loader 2.10 ISaGRAF Start Flag The command si can be used to display / change the setting of the ISaGRAF Start Flag. Valid values are 0 and 1. See pep-vdme.wri on ISaGRAF Workbench for more information about the usage of this flag. Note: The ISaGRAF Start Flag is stored in the boot section of the serial EEPROM or RTC. This section is validated with a CRC code to avoid the setting of random parameters.
Bootstrap Loader After entering the Command Mode the following screen should appear: Enter 'lf' on the target. The target now waits until the MOTOROLA S-records have been transfered over the term. Select Transfer/Send Text file dialogue box and select the file containing the MOTOROAL S-records.
Bootstrap Loader After selecting Open the dialogue box disappears and the MOTOROLA S-records are transfered As soon as the complete file is sent, the prompt of the Bootstrap Loader appears again. Note: No status information is displayed.
Bootstrap Loader 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.
Bootstrap Loader Note: The maximum size of the binary module which can be loaded or updated is 256 Kbytes. If a module greater than 256 kBytes is sent to the Bootstrap Loader each S-record which exceeds this size will be refused. As a result the loaded module is declined due to an invalid CRC value. Note: If only one module is in the FLASH, this module cannot be updated. Note: Loading or updating modules from an absolute memory address is not supported. 3.
Bootstrap Loader 4 Command Reference 4.1 Boot Wait Syntax bw [
Bootstrap Loader 4.4 Port Format Syntax pf [ [][/[][/[][/]]]] Description Without parameters specified, the current serial port settings are displayed. specifies the serial port. Valid values are term or serO. specifies the baud rate. The values 50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200 and 38400 Baud can be specified. specifies the bits / character. Valid values are 7 or 8.
Bootstrap Loader 4.6 Reset System Syntax rs Description This command exits the Bootstrap Loader and resets the system. It terminates the Bootstrap Loader command mode and resets the complete system, generating a system reset with the on-board watchdog. 4.7 Help Syntax ? or help Description This command prints the online help page. The display of the help text varies between the different CPUs reflecting the difference of the CPUs. 4.
Bootstrap Loader 4.10 Remove Modules Syntax rmmod [-q] Description Remove module with the from the FLASH. [-q] suppress all messages except error messages.
Bootstrap Loader Appendix A ISaGRAF applications on CM-302 On the CM-302 80 Kbytes of the FLASH are reserved for ISaGRAF applications. The commands ldmod, lsmod and rmmod have a different behavior on the CM-302 than on the other CPUs concerning the handling of this special FLASH area for ISaGRAF applications. Each module with a name according to 'isa?1' is treated as ISaGRAF application on the CM-302. Note: Do not include any ISaGRAF applications in the image programmed via lf.
Bootstrap Loader Appendix B Utility 'genflash' This utility is included in the 'PEP Utilities'. 'genflash' takes the image of the Bootstrap Loader '-l' and an user-images '-i' and generates a FLASH image '-o' for a specific board '-b'. The output-file has the exact size '-s' and contents of the installed FLASHs. This image can directly programmed into the FLASHs.
Bootstrap Loader Appendix C Bootstrap Loader Start - 1 sec BREAK Signal On CPUs without an ABORT button, the Bootstrap Loader will enter the command mode on detecting a BREAK character of at least one second length at the terminal connector. Since not all terminals are capable of generating a BREAK signal lasting for one second, the modification described below helps achieve it. One possibility to generate the BREAK character is to use a special adapter.
Bootstrap Loader B) Adapter at 25 pin connector on PC side Normal Operation: 1-2 Sending BREAK: C) 1-3 Adapter at 9 pin connector on PC side Normal Operation: 1-2 Sending BREAK: 1-3 Note: Always use a serial cable for CTS/DTR handshake from the adapter to the host. Note: This description stands for x seperate lines.
