pir-8-as - Assembler for the pir-8
pir-8-as [OPTIONS] [ASMFILE...]
Assembler for the pir-8.
Specified input files (or "-" for stdin) are assembled sequentially into the output file.
The comment character is ";".
The assembly format is as follows:
And so, all of these are equivalent:
LOAD IMM BYTE A
0x69
LOAD IMM BYTE A
0b0110_1001
0x04
0o151
4
105
Start with a colon, not limited to ASCII:
:origin ADDRESS
The first instruction starts at ADDRESS, all previous bytes are zeroed
Using this more than once or after having already processed an instruction will yield an error
:label save NAME
Save the current output address to be recalled anywhere else in the program assembly
:label load full|high|low NAME
Substitute a fragment of the output address of previously saved label called NAME in this place
If the NAME label wasn't yet specified, output will be buffered until it's declared
Using this with "full" when the current instruction isn't expecting two data bytes will yield an error, and
using this with "high" or "low" when the current instruction isn't expecting one data byte will yield an error.
Having specified this with a NAME without a corresponding :label save directive will yield an error
:label load-offset full|high|low NAME OFFSET
Like :label load FRAGMENT NAME, but add (signed) OFFSET afterwards
The resulting address will wrap around both sides
:literal "STRING"
Insert STRING into the output
Using this when the current instruction is expecting data will yield an error
-o BINFILE
Name of the the binary-file output, or "-" for stdout
Parent directory must exist
Default: "a.p8b"
-r REGISTER_LETTERS
Use REGISTER_LETTERS as the letters for the registers
in the general-purpose bank instead of the defaults,
as specified in the ISA
Must be 8-ASCII-characters-long
1 - option parsing error
2 - output file creation failure
3 - input file opening failure
4 - output write failure
5 - input read failure
6 - instruction parse error
7 - instruction data parse error
8 - invalid directive or directive obey error
9 - unfound labels remain
Written by nabijaczleweli <nabijaczleweli@gmail.com>
To all who support further development, in particular:
<https://github.com/LoungeCPP/pir-8-emu/issues>
<https://github.com/LoungeCPP/pir-8-emu>