NAME

convert − convert object module to downloadable form

SYNOPSIS

convert [-f format ] [-b byte number ] file ... 

DESCRIPTION

convert translates MIPS object files into formats suitable for downloading over serial ports.  The formats supported are intel hex, Motorola S record (S1, S2 and S3), and Step Microword TM.  Valid format specifiers are:

intelhex Intel Hex

s1rec Motorola S record S1, 16 bit addresses

s2rec Motorola S record S2, 24 bit addresses

srec Motorola S record S2, 24 bit addresses

s3rec Motorola S record S3, 32 bit addresses

step Step Microword TM By default the entire object file is converted. If the optional byte number is specified then only those bytes at that position of each word are converted. This is useful in cases where the device being downloaded ( prom programmer or emulator) has insufficient memory to hold the entire image at once. For all formats except "s3rec", the addresses placed in the downloadable records are relative to zero.  This is appropriate for use with most prom programmers.  Format "s3rec" has the record addresses relative to the actual load point of the object module; this is appropriate for downloading programs via the MIPS prom monitor sload command.

EXAMPLES

convert a.out >a.hex

converts a.out into intel hex format

convert -f srec -b0 prom.out >prom.byte0
convert -f srec -b1 prom.out >prom.byte1
convert -f srec -b2 prom.out >prom.byte2
convert -f srec -b3 prom.out >prom.byte3

converts prom.out into 4 Motorola S2 record files, byte 0 of each 32 bit word is in prom.byte0, byte 1 of each 32 bit word is in prom.byte1, etc.