BOOT(1)

NAME
boot - assemble, upload and run an 8051 program

SYNOPSIS
boot sourcefile

DESCRIPTION
boot is a shell script that can simplify and speed up the software development cycle of 8051 assembly language programs. It (optionally) resets the 8051 target system, assembles the specified sourcefile, uploads the generated Intel-HEX file over a serial port, and finally runs the program.
For this, a customized version of the bootstrap program BOOT-51 must be installed on the 8051 target board, and the macro assembler ASEM-51 must be installed on the host system!

FILES
boot requires only one command line parameter: the file name of the assembler source (without extension .a51). For example, the command

    boot blink

would (optionally) first reset the 8051 board, then assemble the program blink.a51, upload the generated Intel-HEX file blink.hex to the target system, and finally run it.
Furthermore, the list file blink.lst is generated, containing a detailed assembler listing with error diagnostics.

OPTIONS
In principle, boot itself contains only configuration data. There are several options to reset and bootstrap the 8051 target board. To get the shell script running, change the configuration parameters according to your local requirements. (See commentary inside boot!)
Apart of this, boot calls only the upload script, which does the whole work. Please do not edit upload, and do not run it directly!
If you want to operate several 8051 boards with the same host system, create an individual boot script for every target board (boot1, boot2, boot3, ...) and leave upload unchanged. The number of boards is restricted by the number of ports only.

EXIT STATUS
When terminating, boot returns the exit code 0 on success. In case of error, the exit code of the failed command is returned.

USAGE
For general information on bootstrapping, hardware requirements and BOOT-51 customization see the BOOT-51 User's Manual in ASCII file boot51.doc.
For detailed information on writing 8051 assembly language programs and the usage of the macro assembler ASEM-51 see the ASEM-51 User's Manual in ASCII file asem_51.doc.
Or simply start reading with HTML file docs.htm!

NOTES
For uploading the generated Intel-HEX files, you must have full read/write access to the serial port.
If you decide to automatically reset your target system with a printer port, the reset51 program needs direct access to I/O ports and therefore requires root privileges! (Set the "set-user-id" bit for reset51.)
If you reset your 8051 board with the DTR signal of the serial port (upload device is same as reset device), this is performed with the stty command. This should also work with exotic (non-16450) serial ports. In this case, reset51 doesn't require root privileges, because it is invoked for delay purposes only.

AUTHOR
W.W. Heinz

SEE ALSO
asem(1), hexbin(1), customiz(1), reset51(1)