mirror of
https://github.com/AK6DN/dec-utilities-for-pdp.git
synced 2026-01-11 23:42:54 +00:00
Updates to Makefile paths
This commit is contained in:
AK6DN
parent
e980f7c85f
commit
c6f0ec3090
145
README.md
145
README.md
@ -1,146 +1,7 @@
|
||||
<B>obj2bin.pl</B> is a PDP-11 object file translator / linker, transforming an .obj file as output from macro11 into an absolute binary load image file (.bin) or other useful formats (.hex).
|
||||
<B>DEC Utilities for PDP-8, PDP-11, VAX Systems and Software</B>
|
||||
|
||||
If run with no options, it prints a usage screen:
|
||||
TBD ...
|
||||
|
||||
```
|
||||
obj2bin.pl v2.0 by Don North (perl 5.022)
|
||||
Usage: ./obj2bin.pl [options...] arguments
|
||||
--help output manpage and exit
|
||||
--debug enable debug mode
|
||||
--verbose verbose status reporting
|
||||
--boot M9312 boot prom
|
||||
--console M9312 console/diagnostic prom
|
||||
--binary binary program load image
|
||||
--ascii ascii m9312 program load image
|
||||
--bytes=N bytes per block on output
|
||||
--nocrc inhibit output of CRC-16 in hex format
|
||||
--logfile=LOGFILE logging message file
|
||||
--outfile=OUTFILE output .hex/.txt/.bin file
|
||||
OBJFILE... macro11 object .obj file(s)
|
||||
Aborted due to command line errors.
|
||||
```
|
||||
|
||||
If run with the --help option it prints a longer manual page:
|
||||
|
||||
```
|
||||
NAME
|
||||
obj2bin.pl - Convert a Macro-11 program image to PROM/load format
|
||||
|
||||
SYNOPSIS
|
||||
obj2bin.pl [--help] [--debug] [--verbose] [--boot] [--console] [--binary]
|
||||
[--ascii] [--bytes=N] [--nocrc] [--logfile=LOGFILE] --outfile=BINFILE
|
||||
OBJFILE...
|
||||
|
||||
DESCRIPTION
|
||||
Converts a Macro-11 object file to various output formats, including M9312
|
||||
boot and console PROM, straight binary records, ASCII format for M9312
|
||||
console load commands, and loadable absolute binary program images (.BIN)
|
||||
files.
|
||||
|
||||
Currently the program is limited to a single object input file that can be
|
||||
output in the selected format. Multiple .psect/.asect ops are supported,
|
||||
as well as all local (non-global) relocation directory entries. Multiple
|
||||
object files are (not yet) supported.
|
||||
|
||||
OPTIONS
|
||||
The following options are available:
|
||||
|
||||
--help
|
||||
Output this manpage and exit the program.
|
||||
|
||||
--debug
|
||||
Enable debug mode; print input file records as parsed.
|
||||
|
||||
--verbose
|
||||
Verbose status; output status messages during processing.
|
||||
|
||||
--boot
|
||||
Generate a hex PROM file image suitable for programming into an M9312
|
||||
boot prom (512x4 geometry, only low half used).
|
||||
|
||||
--console
|
||||
Generate a hex PROM file image suitable for programming into an M9312
|
||||
console/diagnostic prom (1024x4 geometry).
|
||||
|
||||
--binary
|
||||
Generate binary format load records of the program image (paper tape
|
||||
format) for loading into SIMH or compatible simulators. These files
|
||||
can also be copied onto XXDP filesystems to generate runnable program
|
||||
images (used to write custom diaqnostics).
|
||||
|
||||
--ascii
|
||||
Generate a a sequence of 'L addr' / 'D data' commands for downloading
|
||||
a program via a terminal emulator thru the M9312 user command
|
||||
interface. Suitable only for really small test programs.
|
||||
|
||||
Exactly ONE of --boot, --console, --binary, or --ascii must be
|
||||
specified.
|
||||
|
||||
--bytes=N
|
||||
For hex format output files, output N bytes per line (default 16).
|
||||
|
||||
--nocrc
|
||||
For hex format output files, don't automatically stuff the computed
|
||||
CRC-16 as the last word in the ROM.
|
||||
|
||||
--logfile=FILENAME
|
||||
Generate debug output into this file.
|
||||
|
||||
--outfile=FILENAME
|
||||
Output binary file in format selected by user option.
|
||||
|
||||
OBJFILE...
|
||||
Input object file(s) in .obj format.
|
||||
|
||||
ERRORS
|
||||
The following diagnostic error messages can be produced on STDERR. The
|
||||
meaning should be fairly self explanatory.
|
||||
|
||||
"Aborted due to command line errors" -- bad option or missing file(s)
|
||||
|
||||
"Can't open input file '$file'" -- bad filename or unreadable file
|
||||
|
||||
"Error: Improper object file format (1)" -- valid record must start with
|
||||
0x01
|
||||
|
||||
"Error: Improper object file format (2)" -- second byte must be 0x00
|
||||
|
||||
"Error: Improper object file format (3)" -- third byte is low byte of
|
||||
record length
|
||||
|
||||
"Error: Improper object file format (4)" -- fourth byte is high byte of
|
||||
record length
|
||||
|
||||
"Error: Improper object file format (5)" -- bytes five thru end-1 are data
|
||||
bytes
|
||||
|
||||
"Error: Improper object file format (6)" -- last byte is checksum
|
||||
|
||||
"Error: Bad checksum exp=0x%02X rcv=0x%02X" -- compare rcv'ed checksum vs
|
||||
exp'ed checksum
|
||||
|
||||
EXAMPLES
|
||||
Some examples of common usage:
|
||||
|
||||
obj2bin.pl --help
|
||||
|
||||
obj2bin.pl --verbose --boot --out 23-751A9.hex 23-751A9.obj
|
||||
|
||||
obj2bin.pl --verbose --binary --out memtest.bin memtest.obj
|
||||
|
||||
AUTHOR
|
||||
Don North - donorth <ak6dn _at_ mindspring _dot_ com>
|
||||
|
||||
HISTORY
|
||||
Modification history:
|
||||
|
||||
2005-05-05 v1.0 donorth - Initial version.
|
||||
2016-01-15 v1.1 donorth - Added RLD(IR) processing, moved sub's to end.
|
||||
2016-01-18 v1.2 donorth - Added GSD processing, improved debug output.
|
||||
2016-01-20 v1.3 donorth - Initial support for linking multiple PSECTs.
|
||||
2016-01-22 v1.4 donorth - Added objfile/outfile/logfile switches vs stdio.
|
||||
2016-01-28 v1.5 donorth - Added RLD processing, especially complex.
|
||||
2017-04-01 v2.0 donorth - Started to add capability to process multiple
|
||||
input object files ... still a work in progress.
|
||||
Renamed from obj2hex.pl to obj2bin.pl
|
||||
TBD ...
|
||||
```
|
||||
|
||||
@ -32,7 +32,7 @@ main.o: main.c $(Common)
|
||||
|
||||
install:
|
||||
make
|
||||
cp -v d8tape.exe ../../../tools/exe
|
||||
cp d8tape.exe ../../exe
|
||||
|
||||
release:
|
||||
make clean
|
||||
@ -44,8 +44,8 @@ test:
|
||||
d8tape test.bin | expand -4 > test.list
|
||||
cp test.list verify.pal
|
||||
macro8x -d -x -m -u verify.pal
|
||||
../dumpbin.pl test.bin > test.dump
|
||||
../dumpbin.pl verify.bin > verify.dump
|
||||
dumpbin8x.pl test.bin > test.dump
|
||||
dumpbin8x.pl verify.bin > verify.dump
|
||||
-diff -s test.dump verify.dump
|
||||
d8tape verify.bin | expand -4 > verify.list
|
||||
-diff -s test.list verify.list
|
||||
|
||||
@ -2,7 +2,7 @@ TITLE "AUTOMATIC DISASSEMBLY OF test.bin BY D8TAPE"
|
||||
////////////////////////////////////////////////////////////////////////////////
|
||||
/
|
||||
/ Automatic Disassembly of test.bin
|
||||
/ Generated 2015 10 28 23:46:07
|
||||
/ Generated 2018 02 20 17:34:40
|
||||
/ Generated by d8tape version 0.347
|
||||
/ Visit http://www.pdp12.org/pdp8/software/index.html for updates
|
||||
/
|
||||
|
||||
@ -2,7 +2,7 @@ TITLE "AUTOMATIC DISASSEMBLY OF verify.bin BY D8TAPE"
|
||||
////////////////////////////////////////////////////////////////////////////////
|
||||
/
|
||||
/ Automatic Disassembly of verify.bin
|
||||
/ Generated 2015 10 28 23:46:09
|
||||
/ Generated 2018 02 20 17:34:41
|
||||
/ Generated by d8tape version 0.347
|
||||
/ Visit http://www.pdp12.org/pdp8/software/index.html for updates
|
||||
/
|
||||
|
||||
@ -6,7 +6,7 @@
|
||||
2 ////////////////////////////////////////////////////////////////////////////////
|
||||
3 /
|
||||
4 / Automatic Disassembly of test.bin
|
||||
5 / Generated 2015 10 28 23:46:07
|
||||
5 / Generated 2018 02 20 17:34:40
|
||||
6 / Generated by d8tape version 0.347
|
||||
7 / Visit http://www.pdp12.org/pdp8/software/index.html for updates
|
||||
8 /
|
||||
|
||||
@ -2,7 +2,7 @@ TITLE "AUTOMATIC DISASSEMBLY OF test.bin BY D8TAPE"
|
||||
////////////////////////////////////////////////////////////////////////////////
|
||||
/
|
||||
/ Automatic Disassembly of test.bin
|
||||
/ Generated 2015 10 28 23:46:07
|
||||
/ Generated 2018 02 20 17:34:40
|
||||
/ Generated by d8tape version 0.347
|
||||
/ Visit http://www.pdp12.org/pdp8/software/index.html for updates
|
||||
/
|
||||
|
||||
@ -3,11 +3,11 @@
|
||||
# system dependencies
|
||||
ifeq ($(WINDIR),)
|
||||
# unix
|
||||
BINDIR=../../../tools/bin
|
||||
BINDIR=../../bin
|
||||
EXE=
|
||||
else
|
||||
# cygwin
|
||||
BINDIR=../../../tools/exe
|
||||
BINDIR=../../exe
|
||||
EXE=.exe
|
||||
endif
|
||||
|
||||
|
||||
@ -3,11 +3,11 @@
|
||||
# system dependencies
|
||||
ifeq ($(WINDIR),)
|
||||
# unix
|
||||
BINDIR=../../../tools/bin
|
||||
BINDIR=../../bin
|
||||
EXE=
|
||||
else
|
||||
# cygwin
|
||||
BINDIR=../../../tools/exe
|
||||
BINDIR=../../exe
|
||||
EXE=.exe
|
||||
endif
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user