
Appendix D
D-12
Convert Binary Files to S-Record File/S-Record to Binary
Syntax
binex [<opts>] [<inpath>] [<outpath>]
exbin [<opts>] [<inpath>] [<outpath>]
Function
binex converts binary files to S-record files. exbin converts S-record
files to binary.
An S-record file is a type of text file that contains records representing
binary data in hexadecimal form. This Motorola-standard format is often
directly accepted by commercial PROM programmers, emulators, logic
analyzers, and similar devices that use the RS-232 interface. It can be
useful for transmitting files over data links that can only handle character-
type data. You can also use it to convert OS-9 assembler or compiler
generated programs to load on non-OS-9 systems.
binex converts the OS-9 binary file specified by <inpath> to a new file
with S-record format. The new file is specified by
<outpath>. S-records
have a header record to store the program name for informational
purposes. Each data record has an absolute memory address. This
absolute memory address is meaningless to OS-9 because OS-9 uses
position-independent code.
binex currently generates the following S-record types:
S1 records Use a two-byte address field.
S2 records Use a three-byte address field.
S3 records Use a four-byte address field.
S7 records Terminate blocks of S3 records.
S8 records Terminate blocks of S2 records.
S9 records Terminate blocks of S1 records.
To specify the type of S-record file to generate, use the
-s=<num> option.
<num> may be 1, 2, or 3, corresponding to S1, S2, or S3.
exbin is the inverse operation.
<inpath> is assumed to be an S-record
format text file that
exbin converts to pure binary form in a new file
(<outpath>). The load addresses of each data record must describe
contiguous data in ascending order.
exbin does not generate or check for
the proper OS-9 module headers or CRC check value required to actually
load the binary file. You can use the
ident utility to check the validity of
the modules if they are to be loaded or run.
exbin converts any of the
S-record types mentioned above.
binex/exbin
Komentáře k této Příručce