Introduction
Sjasm 0.4 is still not quite finished yet, and neither is this manual. Although Sjasm can do more than described here, everything that is in here should work as advertised.
New in Sjasm 0.4 BETA 7
- Fixed XOR HL,HL. This should generate an error message.
- Hacked EX AF,AF'.
- Added DEFB, DEFW and friends.
New in Sjasm 0.4 BETA 6
- Fixed 'unexpected' ascmap error.
- Fixed error reports without list file.
- Fixed more small bugs.
- Added page range to PAGE command.
- Added incbin.list, jr., djnz. and jp.
New in Sjasm 0.4 BETA 5
- Fixed Sjasm endless loop.
- Changed :: operator.
- Added ## code part align option.
- Added more text to this manual.
New in Sjasm 0.4 BETA 4
- Fixed Sjasm crash while using structures.
- Added more flexible code part page specification.
New in Sjasm 0.4 BETA 3
- Fixed WHILE loops.
- Improved code part sort.
- Added check on negative page numbers.
New in Sjasm 0.4 BETA 2
- Fixed UPDATE command.
- Fixed jumps to numbered labels.
- Fixed INCBIN file length check.
- Added ERROR command.
- Added CODE! overlay code parts.
- Added more text to this manual.
New in Sjasm 0.4 BETA 1
Differences with SjASM version 0.3
Sjasm version 0.4 is largely rewritten, and in some places the syntax and meaning of commands and operators has changed compared to previous versions of Sjasm. Some differences:
- New name: Sjasm instead of SjASM.
- DC, DZ, ABYTEC and so on only accept strings.
- Character constants are 8 bit. No LD HL,'ab' anymore.
- Structures cannot be nested.
- The "16 bit fake instructions" like LD HL,DE or LDI A,(HL) have been replaced or removed.
- PUSH and POP can have only one operand.
- The way to update files has changed.
- Commands cannot start with a dot.
- Command line options have changed.
You can work your way around some of the differences by writing some macros.
Known bugs
Sjasm is still prototype-experimental-beta-like, so there may be some bugs.
If you encounter a bug, we would like to hear it. Please make sure it is a bug (in Sjasm or in this manual), and give a (small) source example if possible. Use info@xl2s.tk to contact us. Even if the bug you found is listed above, your report may be useful by giving some more information on solving the issue.
To do
In random order:
- Fix the known bugs :)
- Make the error system look more intelligent
- Make the code part placement more intelligent
- Add command line options
- Maybe add some predefined functions like random, sine and such
- Improve this manual
- Make Sjasm more SjASM compatible
- Add timing information to the listing?
The assembling process
Sjasm will process your code a couple of times. Conceptually you could say Sjasm uses four passes:
- Pass 1
- Pass 2
- Pass 3
- Pass 4
The first pass is the pre-processor pass. The pre-processor does the following in this order:
- Remove all comments
- Concatenate lines you split up
- Process define commands
- Replace text macros and macro functions
- Process the white space killer
- Process other pre-processor commands like if, macro, while and struct
- Cut multiple statement lines in pieces
- Expand procedure macros
In the first pass you can only use (or reference) labels that are defined before you use them.
In the second pass Sjasm tries to figure out what values all labels should get, and in which order it should place all the code parts. It is not that difficult to make it impossible for Sjasm to do this, and make Sjasm take literally forever to complete this pass.
When all labels have the right values Sjasm generates the output in the third pass. After that, Sjasm goes over the whole code again to generate the listing file, and to see if it can generate some more error messages.