Apple-2-SW/merlin-utils
1
0
Fork 0
mirror of https://github.com/ksherlock/merlin-utils.git synced 2024-12-13 14:30:30 +00:00
Code Issues Projects Releases Wiki Activity
utilities for the Merlin 8/16+ assembler
43 Commits 2 Branches 0 Tags 132 KiB
C++ 98.3%
Makefile 0.9%
C 0.8%
38a61304a5
Go to file
Kelvin Sherlock 38a61304a5 update readme
2019-12-22 15:00:22 -05:00
afp@b440a35d29 WIP 2019-12-09 13:02:15 -05:00
.gitignore ignore 2019-12-08 13:55:49 -05:00
.gitmodules WIP 2019-12-09 13:02:15 -05:00
.travis.yml support for Merlin command files. 2019-12-14 19:01:12 -05:00
link.cpp merlin uses the same loadname for all segments. 2019-12-22 14:43:12 -05:00
link.h EXT support. 8/16+ added EXT as an operand to import an absolute linker value into the local symbol table. 2019-12-15 13:05:41 -05:00
main.cpp support for Merlin command files. 2019-12-14 19:01:12 -05:00
Makefile support for Merlin command files. 2019-12-14 19:01:12 -05:00
mapped_file.cpp initial WIP 2019-12-08 13:55:33 -05:00
mapped_file.h initial WIP 2019-12-08 13:55:33 -05:00
omf.cpp fix bug with SUPER skip page calculations. 2019-12-21 20:31:42 -05:00
omf.h ALI and DS support 2019-12-15 13:03:43 -05:00
ops.h support for Merlin command files. 2019-12-14 19:01:12 -05:00
README.md update readme 2019-12-22 15:00:22 -05:00
rel.h initial WIP 2019-12-08 13:55:33 -05:00
script.h support for Merlin command files. 2019-12-14 19:01:12 -05:00
script.re2c * is only a comment character if first character. 2019-12-16 23:12:53 -05:00
set_file_type.cpp it compiles... 2019-12-09 19:45:45 -05:00
unique_resource.h initial WIP 2019-12-08 13:55:33 -05:00

README.md

merlin-utils

utilities for the Merlin 8/16+ assembler

An OMF linker for Merlin 8/16+ REL files. Why? ummm....

merlin-link [-D key=value] [-X] [-C] [-o outfile] files....

  • -X: inhibit expressload segment
  • -C: inhibit super relocation records
  • -D: define an absolute label. value can use $, 0x, or % prefix.
  • -S: treat input file as a linker command file
  • -o: specify output file. default is omf.out
  • -v: be verbose

If there is one input file and it ends with .S (case insensitive), it is treated as a linker command file.

Linker Command File

The following opcodes are supported:

END,DAT, PFX, TYP, ADR, ORG, KND, ALI, DS, LKV, VER, LNK, IMP, SAV, KBD, POS, LEN, EQ, EQU, =, GEQ, EXT, DO, ELS, FIN

  • VER: only allows OMF version 2.
  • LKV: 0 (binary), 1 (single segment OMF), 2 (multi segment OMF)
  • IMP: (qasm) - import a binary file. Entry name is the file name with non alphanumerics converted to _
  • KBD: won't prompt if label was previously defined (via -D for example)

No operand math is allowed at this time.

Current Status

Usable, if you can find a use for it. Linking Marinetti (after assembling with Merlin 16+) generates an equivalent OMF file. The file is not identical due to differences in relocation records but OMF Analyzer COMPARE considers them identical.

Building

git submodule init
git submodule update
make

Requires a c++17 compiler. (ie, ubuntu bionic or OS X 10.13). Also assumes a little-endian environment :/