Magic Assembler v1.06 - Documentation
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Changes since version 1.051:
- LEA command added
- binary and decimal number recognation added
- example programs added
- remark bug fixed
- standard numbers added
- comma acception in DB and DW functions added
- EQU command improved
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Magic Assembler is a public domain assembly language compiler, which can
produce as well as COM files as boot sector programs. Compiling to COM files
can be done using the following command line:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ASM MYPROG.ASM ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
To put the program in the boot sector of a disk which is in drive A, the use 
this command line:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ASM MYPROG.ASM B:A ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
Note that if you want to make a boot program, you should include a code like
this:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³         mov     ax,07c0 ³
³         mov     ds,ax   ³
³         mov     es,ax   ³
³         mov     ss,ax   ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
This is because DOS isn't loaded, so DOS cannot do the correct memory settings
before running the program. All bootsector programs are loaded at 07c0:0000, so
that's why this code should be included.
If you want to compile a program and print the source with the right adresses,
use the 'P' parameter:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ASM MYPROG.ASM P ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
This can also be done with a boot sector program, then the command line could
be for example this:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ASM MYPROG.ASM B:AP ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
The commands included with this assembler are the standard assembly commands,
but there are some exeptions. There are three different JMP commands, and two
different CALL commands. Below the difference are discussed:

JMPS    jumps 128 bytes back to 127 bytes further, and uses 2 bytes of code.
JMP     jumps 32768 bytes back to 32767 bytes further, and uses 3 bytes of 
        code.
JMPF    jumps to every possible place in the low memory, and uses 5 bytes of 
        code.
CALL    see JMP, but with this the RET function can be used.
CALLF   see JMPF, but with this the RET function can be used.
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Variables can be declared with the following functions:

DB      byte(s)         declares a byte, but can also be used to declare 
                        multiple bytes.
DW      word(s)         declares a word, but can also be used to declare 
                        mutiple words.
DS      x bytes         declares a free array of x bytes.
DBE     filename.ext    this function puts a file in the compiled version, 
                        supposing that the file is build of bytes.
DWE     filename.ext    this function puts a file in the compiled version, 
                        supposing that the file is build of words.

With DB and DW you can also put a ? instead of a value.
If you want to declare data, for which only space in memory must be reserved,
but no space on disk, you should put them on the end of the source. Before you
declare that data you must put an empty line before them, containing only a '-'
at the first place. See the example programs for details.
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
You do not need to tell the assembler that a procedure is a procedure, so you
can declare a procedure like this:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ cls     mov     ax,0003 ³
³         int     10      ³
³         ret             ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
You can then in the program put the line
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³         call    cls ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Standard, all numbers must be in hexadecimal. But, it is possible to work with
binary and decimal numbers too: just put '%b' before the binary number or '%d'
before the decimal number. For example: these three commands have exactly the
same meaning:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³        mov     ax,4c00               ³
³        mov     ax,%d19456            ³
³        mov     ax,%b0100110000000000 ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
It is also possible to write the numbers in a standard form, which is used by 
most other assemblers. When you want so, you should add an 'n' as the parameter
to the compiler:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³ ASM MYPROG.ASM N ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
If you want to use this mode, you should put an 'h' behind an hexadecimal 
number, and a 'b' behind binary numbers. For example: these three commands have
exactly have the same meaning:
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
³        mov     ax,4c00h              ³
³        mov     ax,19456              ³
³        mov     ax,0100110000000000b  ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
I hope you'll enjoy the Magic Assembler. If you have any questions or remarks
about the assembler, the documenation or the sample programs, you can write me
on E-mail bert.greevenbosch@mmm.xs4all.nl
ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ
Magic Assembler was written by Bert Greevenbosch for Magic Software.
Program created in Rotterdam, the Netherlands.