************************************************************************* * * * HEX - Microprocessor object file management utility * * * * Author: Kevin Angley * * Telex Computer Products * * 3301 Terminal Drive * * Raleigh, North Carolina 27604 * * (919) 834-5251 * * * * Modified by: Chris Doran * * Sira Ltd. * * Research & Development Division * * South Hill, Chislehurst, Kent BR75EH * * England * * 01-467 2636 * * Telex: 896649 * * * * Submitted by: Scott Smith * * Telex Computer Products, Inc. * * Raleigh, North Carolina 27604 * * * ************************************************************************* revision 11-480 HEX: Microprocessor File Management Utility Version: 18APR4 Author: Kevin Angley, Telex Computer Products, Raleigh, N.C. Operating System: RSX11M, VAX/VMS Compatability Mode Keywords: Microprocessor; File Management The HEX utility is designed to manipulate ASCII hex formatted files as output by cross-assemblers and linkers for microprocessors (Z80, 8085, 68000, etc.). HEX supports all of the popular ASCII hex formats: Intel, Motorola, Rockwell, RCA, TekHex, Extended TekHex, Texas, Mostek, Hex-space, Octal-space, and TCI, plus several binary ones: Whitesmiths', PDP-8 RIM and BIN, and PDP-11 object and task formats. The principle component of the HEX utility is a 32K byte virtual memory area that allows the user to manipulate code in memory as if it were in the target machine. Note that the 32K byte virtual memory can be extended to cover the entire 2**32 address range via the OFFSET command. HEX will handle 16, 24, or 32-bit addresses. Operations that can be performed on a hex file in virtual memory: AND - logically AND (mask) bytes in a range. APPEND - append a range of memory to an existing hex file. COMPARE - compare specified addresses to another hex file. COMPLEMENT - perform a logical (1's) complement on a range. COPY - copy from one area to another. CRC - compute the standard cyclic redundancy check. CSUM - place a 4-byte checksum block in memory. DECREMENT - subtract a constant (default 1) from a range of memory. DISPLAY - display to the screen or to a listing file in hex or ASCII. DIVIDE - divide a range of memory by a constant. ECHO - turn on echoing of commands read from an indirect file. EDIT - examine and optionally replace values. EXIT - exit to the CLI. FILL _ fill a range with a value. FORMAT - establish the object file format. HELP - provide on-line help on HEX commands. IDENT _ display the HEX program identification. INCREMENT - add a constant (default 1) from a range of memory. INIT - resets the utility to initial conditions. MOVE - move byte or word values. MULTIPLY - multiply a range of memory by a constant. NAME - establish the object program name. NEGATE - perform the arithmetic (2's) complement. NOECHO - turn off echoing of commands read from an indirect file. OFFSET - establish offset. OR - logically inclusive OR bytes in a range with a constant. READ - read a hex file into virtual memory. REMAINDER - compute the remainder on division (modulus) of bytes in a range. REVERSE - reverse the order of bytes in a range. ROTATE - rotate bytes in shift a range of memory by n bits. SEARCH - search the specified range for a byte or word value. SHIFT - arithmetic or logically shift bytes in a range by n bits. SUM - compute a 16-bit byte-wise summation. TRANSFER - set the transfer address. USE- specify which 8-bit section of an addressable unit to use. WRITE - write a range of virtual memory to a hex file. XOR - logically exclusive OR bytes in a range with a constant. . - spawn another task without losing the HEX edit buffer To build HEX, type @BUILDHEX For a demonstration/test, HEX @HEXTEST. If you need to assemble a module, type @MAC and respond with the module name that you wish to assemble. HEX.HLP is a help file on HEX and all subcommands. HEXRNOMAN.RNO is a manual in a form suitable for input to the RSX SIG's RUNOFF version S1.4 (submitted by Charles Spalding), and HEXDSRMAN.RNO is a form suitable for input to DIGITAL Standard Runoff. See the comments at the top of each of these files for information on conditional processing. Generate the HEX Manual including the Installation Notes for information on tailoring HEX to suit your site's needs. *************************************************************************