mirror of
https://github.com/pfusik/xasm.git
synced 2024-12-21 09:29:39 +00:00
Update README.
This commit is contained in:
Piotr Fusik
parent
c357fba52c
commit
2d8b3cde17
86
README.md
86
README.md
@ -2,7 +2,89 @@ xasm
|
||||
====
|
||||
|
||||
xasm is a 6502 cross-assembler with original syntax extensions.
|
||||
By default it generates binaries
|
||||
for [Atari 8-bit computers](http://en.wikipedia.org/wiki/Atari_8-bit_family).
|
||||
|
||||
See [website](http://xasm.atari.org) for documentation and Windows download.
|
||||
Syntax
|
||||
------
|
||||
|
||||
This GitHub project contains source code updated to D version 2.
|
||||
6502 assembly language is full of LDA, STA, LDA, STA sequences.
|
||||
With xasm you can use MVA as a shortcut for an LDA/STA pair or even MWA for 16-bit transfers.
|
||||
You can avoid defining labels when you need short jumps,
|
||||
thanks to conditional skip and repeat pseudo-instructions.
|
||||
You can put two instructions that share their argument in one line.
|
||||
These are just some of the features that help you program in a more concise way.
|
||||
Let's look at typical 6502 code (which is also valid in xasm):
|
||||
|
||||
lda #<dest
|
||||
sta ptr
|
||||
lda #>dest
|
||||
sta ptr+1
|
||||
ldx #192
|
||||
do_line
|
||||
ldy #39
|
||||
do_byte
|
||||
lda pattern,y
|
||||
sta (ptr),y
|
||||
dey
|
||||
bpl do_byte
|
||||
lda #40
|
||||
clc
|
||||
adc ptr
|
||||
sta ptr
|
||||
bcc skip
|
||||
inc ptr+1
|
||||
skip
|
||||
dex
|
||||
bne do_line
|
||||
|
||||
Using xasm's features this code can be rewritten to:
|
||||
|
||||
mwa #dest ptr
|
||||
ldx #192
|
||||
do_line
|
||||
ldy #39
|
||||
mva:rpl pattern,y (ptr),y-
|
||||
lda #40
|
||||
add:sta ptr
|
||||
scc:inc ptr+1
|
||||
dex:bne do_line
|
||||
|
||||
xasm syntax is based on 1990's Quick Assembler.
|
||||
Write accumulator shifts as in `asl @`.
|
||||
Whitespace is important: it is required before the instruction
|
||||
and disallowed in the operands, because it separates a comment from the operand, e.g.
|
||||
|
||||
lda #0 this is a comment, no need for a semicolon
|
||||
|
||||
This may look weird at first, but it enables nice features such as instruction pairs
|
||||
and two-argument pseudo-instructions.
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
xasm is a command-line tool.
|
||||
Therefore you additionally need a programmer's text editor.
|
||||
|
||||
I use [SciTE](http://www.scintilla.org/SciTE.html).
|
||||
To install xasm syntax highlighting, copy `xasm.properties`
|
||||
to the SciTE directory.
|
||||
|
||||
I build my 8-bit programs with GNU Make,
|
||||
having configured SciTE to run "make" on Ctrl+1.
|
||||
See [my repositories](https://github.com/pfusik?tab=repositories) on GitHub.
|
||||
|
||||
Download
|
||||
--------
|
||||
|
||||
A release is coming soon.
|
||||
Meanwhile you can download Windows binaries from the [old website](http://xasm.atari.org/).
|
||||
|
||||
Links
|
||||
-----
|
||||
|
||||
* [Atari800](http://atari800.sourceforge.net/) - portable emulator of Atari 8-bit computers
|
||||
* [Atari XL/XE Source Archive](http://sources.pigwa.net/) - source code of Atari demos, utilities and games
|
||||
* [cc65](http://cc65.github.io/cc65/) - C cross-compiler targeting 6502-based systems
|
||||
* [MADS](http://mads.atari8.info/) - another 6502/65816 cross-assembler, partially supporting xasm's syntax
|
||||
* [WUDSN IDE](http://wudsn.com/) - Eclipse plugin, front-end to several 6502 cross-assemblers including xasm
|
||||
|
||||
112
www/index.txt
112
www/index.txt
@ -1,112 +0,0 @@
|
||||
xasm - 6502 cross-assembler
|
||||
===========================
|
||||
|
||||
xasm is a free tool for programming
|
||||
http://en.wikipedia.org/wiki/Atari_8-bit_family[Atari 8-bit family computers].
|
||||
|
||||
History
|
||||
-------
|
||||
|
||||
First version of xasm was written in 1998. I needed a cross-assembler
|
||||
that could understand the syntax of Quick Assembler
|
||||
which I used for 8-bit Atari programming before I got a PC.
|
||||
Initially xasm supported the syntax of QA and nothing more.
|
||||
I quickly realized that I could extend the syntax to make it more expressive.
|
||||
This led to xasm 2.0, still in 1998. I added some more features
|
||||
next year. In 2002 I released many versions which contained
|
||||
mostly bugfixes. In 2005 there were some minor enhancements and bug fixes,
|
||||
as well as the whole assembler was rewritten from the x86 assembly language
|
||||
it was initially written in to the http://www.digitalmars.com/d/[D programming language].
|
||||
Current version 3.0.2 was released 17th October 2009.
|
||||
|
||||
Syntax
|
||||
------
|
||||
|
||||
6502 assembler code is usually full of LDA, STA, LDA, STA sequences.
|
||||
With xasm you can use MVA as a shortcut for LDA/STA pair
|
||||
or even MWA for 16-bit transfers. You can avoid defining labels
|
||||
when you need short jumps, thanks to conditional skip
|
||||
and repeat pseudo-instructions. You can put two instructions
|
||||
that share their argument in one line.
|
||||
These are just some of the features that help you program
|
||||
in a more concise way. Let's look at typical 6502 code
|
||||
(which is also valid in xasm):
|
||||
|
||||
-----------------------------
|
||||
lda #<dest
|
||||
sta ptr
|
||||
lda #>dest
|
||||
sta ptr+1
|
||||
ldx #192
|
||||
do_line
|
||||
ldy #39
|
||||
do_byte
|
||||
lda pattern,y
|
||||
sta (ptr),y
|
||||
dey
|
||||
bpl do_byte
|
||||
lda #40
|
||||
clc
|
||||
adc ptr
|
||||
sta ptr
|
||||
bcc skip
|
||||
inc ptr+1
|
||||
skip
|
||||
dex
|
||||
bne do_line
|
||||
-----------------------------
|
||||
|
||||
Using xasm's features this code can be rewritten to:
|
||||
|
||||
-----------------------------
|
||||
mwa #dest ptr
|
||||
ldx #192
|
||||
do_line
|
||||
ldy #39
|
||||
mva:rpl pattern,y (ptr),y-
|
||||
lda #40
|
||||
add:sta ptr
|
||||
scc:inc ptr+1
|
||||
dex:bne do_line
|
||||
-----------------------------
|
||||
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
xasm is a command-line tool.
|
||||
Therefore you additionally need a programmer's text editor.
|
||||
|
||||
I use http://www.scintilla.org/SciTE.html[SciTE].
|
||||
Syntax highlighting definition for it is included with xasm.
|
||||
To install it, copy `xasm.properties` to the SciTE directory,
|
||||
select _Options / Open Global Options File_, type `import xasm`
|
||||
at the end and save the global configuration file.
|
||||
|
||||
image::scite.png[xasm code in SciTE]
|
||||
|
||||
Download
|
||||
--------
|
||||
|
||||
- link:xasm-3.0.2-windows.zip[xasm 3.0.2 for Windows]
|
||||
- link:xasm-3.0.2-src.zip[xasm 3.0.2 source code]
|
||||
- link:xasm261.zip[xasm 2.6.1 for DOS]
|
||||
|
||||
For other systems, such as GNU/Linux and MacOS X, install a D 1.x compiler
|
||||
and compile xasm from source code.
|
||||
|
||||
Inflate
|
||||
-------
|
||||
|
||||
Do you need a good decompression routine for 6502?
|
||||
See my link:inflate.html[inflate routine].
|
||||
|
||||
Links
|
||||
-----
|
||||
|
||||
- http://atari800.sourceforge.net/[Atari800 emulator] - portable emulator of Atari 8-bit computers
|
||||
- http://sources.pigwa.net/[Atari XL/XE Source Archive] - source code of Atari demos, utilities and games
|
||||
- http://www.cc65.org/[cc65] - C cross-compiler targeting 6502-based systems
|
||||
- http://epi.atari8.info/hcasm.php[HardCore Assembler] - 6502/65816 cross-assembler, partially supporting xasm's syntax
|
||||
- http://mads.atari8.info/[MADS] - another 6502/65816 cross-assembler, partially supporting xasm's syntax
|
||||
- http://wudsn.com/[WUDSN IDE] - Eclipse plugin, front-end to several 6502 cross-assemblers including xasm
|
||||
BIN
www/scite.png
BIN
www/scite.png
Binary file not shown.
|
Before Width: | Height: | Size: 24 KiB |
Loading…
Reference in New Issue
Block a user