[370,150] HEX FILE EDITOR ------------------------- Submitted by: Chris Doran Date: October 1986 Sira Ltd., South Hill, Chislehurst, Kent, BR7 5EH, England. Tel: +44 1 467 2636, Telex: 896649, FAX: +44 1 467 6515 This is the Sira version of HEX, DECUS 11-480, submitted by Telex Computer Products (TCP) to the DECUS library, and various SIG tapes. I note that TCS have now translated the whole thing to Pascal, to run in VAX native mode, and that it is no longer in the DECUS library, so TCS have probably given up supporting this version. ************************************************************************* * * * 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 * * +44 1 467 2636 * * Telex: 896649 * * Fax: +44 1 467 6515 * * * * Submitted by: Scott Smith * * Telex Computer Products, Inc. * * Raleigh, North Carolina 27604 * * * ************************************************************************* revision 11-480 HEX: Microprocessor File Management Utility Version: 23Sep6 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, Hex-SMS, Octal-SMS, Fairchild, and TCI, plus several binary ones: Whitesmiths', PDP-8 RIM and BIN, and PDP-11 object and task formats. The principal 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 HEX.RNO is a manual in a form suitable for almost any Runoff with the basic commands. It can be easily edited for input to the RSX SIG's Runoff version S1.4 (submitted by Charles Spalding), Bonner Lab Runoff, or Digital Standard Runoff. See the comments at the top of the file for information on conditional processing. Generate the HEX Manual including the Installation Notes for information on building and tailoring HEX to suit your site's needs. ************************************************************************* NOTE ---- The files MAX.MAC, OUTPUT.MAC, PATCH.MAC, PROC.MAC, and TYPE.MAC are included in this kit because they appeared on an RSX SIG tape. They are probably required if you enable the TC274 conditional, but there is no documentation as to what this is for, or what they do. They are therefore untried and untested (by me, anyway). Chris Doran, Sira