There are several possible approaches to development on the Aquarius. One is to use the built-in BASIC interpreter, or perhaps the Extended BASIC cartridge, to program for the Aquarius in BASIC. Personally, I much prefer to work in assembly language, or at least in another high-level language that compiles to machine language, such as C: the results are faster, more efficient, and more easily maintained and documented than old-fashioned line-numbered BASIC. Nevertheless, there are a great number of Aquarius programmers who still enjoy working in BASIC, and I'm sure that other topics will be created to serve their needs also.
This topic is intended as a place where Aquarius programmers working in machine language can post code snippets, tutorials, and other development resources of a more general nature. I'm sure that specific Aquarius development topics will be spun off into their own threads as circumstances warrant.
In the meantime, I'll get the ball rolling with a revised version of a post that I wrote in the "Aquarius Bitmap Graphics Tool" thread: a short tutorial for creating a simple Aquarius cartridge binary:
Here the source code for a simple program which fills the screen with character $C8 and color $31, creating a yellow-on-red "grid pattern":.org $E010 main ld hl,$3400 ld b,$31 call fill ld hl,$3000 ld b,$C8 call fill halt fill ld de,$03ff loop ld (hl),b inc hl dec de ld a,d or e jr nz,loop ret .endTo create a cartridge binary, just set the starting address to $E010 (as I've done here) and compile. You'll then need to add a valid sixteen-byte header to your binary before the Aquarius will load it as a cartridge image (it's a very weak form of "security").
First, compile the code (in this example, I will be using the Telemark Assembler):TASM -80 -B FILL.ASM FILL.BIN
Then, prepend the cartridge header to your binary:COPY /B CARTHEAD.BIN+FILL.BIN FILL2.BIN
Now you can load FILL2.BIN into Virtual Aquarius as a cartridge ("File | Load Game ROM ..."). I've attached copies of all four of these files in this archive:
carttest.zip 764bytes 452 downloads