Logo  

Home - Old Man Programmer

Index of projects/Aq
Aq.h January 19 2025 Download / View source
CMakeLists.txt September 01 2025 Download / View source
LICENSE June 11 2023 Download / View source
Makefile June 01 2025 Download / View source
README.md January 19 2025 Download / View source
aqjoy.c January 19 2025 Download / View source
aqsnd.c January 19 2025 Download / View source
aqsnd.h January 19 2025 Download / View source
asm/
bas/
cassette/
config.c January 19 2025 Download / View source
config.h.in June 08 2023 Download / View source
dimgui.cpp January 19 2025 Download / View source
doc/
external/
gp.esp32/
gui_common.cpp September 01 2025 Download / View source
gui_common.h January 19 2025 Download / View source
instr.h January 19 2025 Download / View source
io.c January 19 2025 Download / View source
libjson/
main.c January 19 2025 Download / View source
mem.c January 19 2025 Download / View source
mk November 11 2026 Download / View source
qtgui.cpp January 19 2025 Download / View source
quicktyp/
roms/
screen.c January 19 2025 Download / View source
sdlevent.cpp September 01 2025 Download / View source
sdlevent.h January 19 2025 Download / View source
utils/
xdg.c January 19 2025 Download / View source
xdg.h January 19 2025 Download / View source
z80.c September 01 2025 Download / View source
Repos
Version: 0.6
License: GPLv2
Git repos:
Download tarball:

README.md

Aq: The Mattel/Radofin Aquarius Emulator

Aq is an open source Mattel Aquarius emulator. It provides a graphical interface via SDL2 (see v0.1 for a curses-based interface, instead). It features a fairly complete cycle-exact Z80 emulator, which can also be run in unlimited (turbo) mode. It supports both built-in and expansion module sound (including higher-level tape drive support) and expansion module game controllers. Turbo mode is both manually selectable and automatic for initial BASIC file loads and tape operations. It also comes with a few extras; BASIC files are installed in Aq/share/Aq/bas, tapes in Aq/share/Aq/tapes, and ROMS in Aq/share/roms:

  • All examples from the users' manual as BASIC text files and combined into a single tape file (basic.tape).
  • A number of expansion cartridge sound samples, in the form of BASIC files and combined into a single tape file (sndtest.tape).
  • An Extended BASIC ROM (ebasic.bin) which loads into the low Extended BASIC ROM slot. Other cartridges can be loaded at the same time. It has been verified to work with the QuickDisk ROM's Extended BASIC support. It was generated by automatically disassembling the standard (high-loading) version combined with some hand-editing and re-assembly.
  • A sample ROM: CamelForth/80-1.2 ported from CP/M to the Aquarius. It is available both as a ROM (cam80-12.bin) and a tape file (cam80-12.tape).
  • A sample ROM: ZexAll ported from CP/M to the Aquarius. Unfortunately, this requires write access to the BASIC ROM area, which Aq secretly supports just for this ROM. This is available both as a ROM (zexall.bin) and a tape file (zexall.tape).
  • Support for assembly language development for the Aquarius based around the Small Device C compiler toolkit, which may already be provided by your distribution. This includes the tools ihx2bin and asm2bas as well as macros and symbols in aquarius.mac (in particular, a macro to easily create the magic ROM header). This was used to build the provided ROMs and sound samples.
  • The HALT instruction stops the emulator.

There is also an optional GUI, based on either Qt or Dear ImGui. The GUI adds a menu, and allows run-time changes of tape and ROM files, and immediate pasting of BASIC files.

While it might be possible for it to run on Windows or MacOS, it was developed and tested only on Linux. See CHANGES for a list of major changes.

See INSTALL.md for how to build and install Aq.

See the man pages for usage and configuration instructions.

See TODO.md for future plans.

Credits and License

Original work, core emulator, and motivated self-interest (original Aquarius owner): Steve Baker steve.baker.llc@gmail.com. Sound, tape, game controller, assembly language extras, cmake support, original Qt and Dear ImGui work, minor fixes: Thomas J. Moore darktjm@gmail.com.

I have no idea what the license is. While all code written by Thomas J. Moore is in the Public Domain, as part of this project, it falls under the same license as the rest of the code.