Commit | Line | Data |
---|---|---|
f2b550c0 AT |
1 | # Overview # |
2 | ||
3 | This is a simple program that converts raw binary data into a paper-tape image | |
f63b1e81 | 4 | compatible with SIMH's `load` command. |
f2b550c0 AT |
5 | |
6 | For example, I commonly use it when transfering compiled PDP-11 code into SIMH | |
7 | with the output of: | |
8 | ||
9 | pdp11-aout-objcopy --only-section=.text --output-target binary program.out program.bin | |
10 | ||
f2b550c0 AT |
11 | |
12 | # Status # | |
13 | ||
14 | Tested and working on Linux and FreeBSD. | |
15 | ||
16 | ||
17 | # Instructions # | |
18 | ||
19 | The `Makefile` provides targets for `all`, `install`, `uninstall`, and `clean`. | |
20 | Edit the `Makefile` to set `$PREFIX` for alternate installation paths. By | |
21 | default it installs to `$HOME/bin`. | |
22 | ||
23 | Once compiled and added to your `$PATH`, simply provide a raw binary blob as | |
f63b1e81 | 24 | `input` and receive a SIMH compatible paper tape image as `output`. |
f2b550c0 AT |
25 | |
26 | If provided via the `-a` flag, the paper tape will load at the provided address | |
27 | in memory. If not provided, this defaults to `01000` (`1000` octal). | |
28 | ||
29 | bin2load -i /path/to/input -o /path/to/output -a 01000 | |
30 |