mirror of
https://github.com/A2osX/A2osX.git
synced 2026-11-22 16:21:12 +00:00
4.3 KiB
4.3 KiB
A2osX Macro Assembler (1.00)
Description
Multi-CPU macro assembler based on S-C MASM 3.0 dialect
Supported CPUs:
- 6502
- 65C02
- 65R02
- 65816
- Z80
- SWEET16
Table-driven, add your favorite CPU creating a new CPU asm.xxxx file.
Difference with S-C MASM 3.0
- Symbols are case sensitive
- No .AC support
- PC and global addresses are 32 bits
- Local / Private labels are 16 bits range and from .1 to .255
Directives
| Code | Description | Compatibility | Status | Syntax | Comment |
|---|---|---|---|---|---|
| .AC | Ascii Compressed string | S-C | NOT IMPL. | As strings are supposed to be printed with A2osX API, Printf cannot handle 'AC' compressed strings | |
| .AS | Ascii String | S-C, A2osX | Working | .AS dTEXTd where d is any delimiter .AS -"TEXT"produce ascii code with b7=1 |
|
| .AT | Ascii string Terminated | S-C, A2osX | Working | (same as above) | |
| .AZ | Ascii string Zero terminated | S-C, A2osX | Working | (same as above) | |
| .BS | Block (Byte) Storage | S-C, A2osX | Working | .BS count[,value] |
Reserves count bytes in output and sets them to value (or zero if omitted) |
| .CS | C-string | S-C 3.1, A2osX | Working | .CS "text\a\b\e\f\n\r\n\r\t\v" |
|
| .CZ | C-String Zero terminated | S-C 3.1, A2osX | Working | (same as above) | ZERO-terminated |
| .DA | DAta value | S-C, A2osX | Working | .DA value |
2-byte address: .DA $1234 only high byte: .DA /$1234 only low byte: .DA #$1234 |
| .DO | conditional start | S-C, A2osX | Working | ||
| .DU,.DUMMY | begin DUmmy section | S-C, A2osX | Working | ||
| .ED | End Dummy section | S-C, A2osX | Working | ||
| .ELSE | conditional ELSE | S-C, A2osX | Working | ||
| .EM | End Macro | S-C, A2osX | Working | ||
| .EN | ENd of source code | S-C, A2osX | IGNORED | ||
| .EP | End Phase | S-C, A2osX | Working | .EP |
Conclude temporary addressing range started with .PH and resume prior assembly addressing |
| .EQ | EQuate | S-C, A2osX | Working | ||
| .FIN | conditional end | S-C, A2osX | Working | ||
| .HS | Hex String storage | S-C, A2osX | Working | HS FE1A78 delimiter allowed : HS 00.11,22 |
|
| .HX | Hex Nibble storage | S-C, A2osX | Working | HX EFA187 delimiter allowed : HS 00.11,22 |
|
| .IN,.INB,.INBx | INline source | S-C, A2osX | Working | .INB MYFILE |
.IN inlines full text, .INB inlines 1 block at a time during assembly |
| .LI,.LIST | S-C, A2osX | Working | .LIST ON/OFF CON/COFF MON/MOFF XON/XOFF |
||
| .MA | MAcro deffinition | S-C, A2osX | Working | .MA >MYMACRO |
|
| .OP | OPCode | S-C, A2osX | Working | .OP cpu where cpu is one of 6502,65C02,65R02,65816,Z80,SW16 |
|
| .OR | ORigin | S-C, A2osX | Working | .OR address |
Set initial output address (only one allowed per assembly) |
| .PG | PaGe control | S-C, A2osX | IGNORED | ||
| .PH | PHase start | S-C, A2osX | Working | .PH address |
Start a temporary addressing range |
| .PS | Pascal-string | S-C 3.1, A2osX | Working | ||
| .SE | S-C, A2osX | Working | |||
| .TA | Target Address | S-C, A2osX | IGNORED | ||
| .TF | Target File | S-C, A2osX | Working | .TF TargetFile[,Txxx] |
only ,TSYS supported |
| .TI | TItle | S-C, A2osX | IGNORED | ||
| .US | USer defined | S-C, A2osX | IGNORED |
License
A2osX is licensed under the GNU General Pulic License.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
The full A2osX license can be found Here.
Copyright
Copyright 2015 - 2022, Remy Gibert and the A2osX contributors.