An emulator for the RX82 fantasy retro computer system, including the R8 8-bit CPU.
ADRIC: What do these numbers and letters mean?
DOCTOR: It's an early version. Instructions have to be punched in by machine code.
ADRIC: Oh, how boring.
DOCTOR: Boring?
—Doctor Who, Logopolis
cargo install rx82This is an emulator for the RX82 architecture, an imagined home computer system similar to those of the early 1980s, such as the Sinclair ZX81 and Spectrum, the BBC Micro, or the Commodore 64.
The RX82's design is intended not only to evoke fond memories in those of a certain age, but also to help teach the fundamentals of computer systems architecture and computer engineering. It's simpler than historic systems such as the ZX81, because no cost or design compromises are required, but also realistic enough to be useful for learning purposes.
Its central processor is the R8, a fan-fiction CPU design comparable to the Zilog Z80 or the MOS 6502, but again, somewhat simplified for educational purposes.
This crate provides a reference implementation of the RX82 and R8 architectures, and an assembler / disassembler for use with R8 assembly language programs. However, it is intended to be modular, so that you can pick and choose components to build your own systems.
For example, you could use the R8 CPU as part of your own emulator that replaces the RX82 system with something else. Equally, you could use the RX82 system components but replace the CPU with a design of your own, or an emulated real machine such as a 6502.
Prepare your program in a text file (see R8 Assembly Language below), and run:
rx82 asm my_prog.asmIf the program assembles correctly, this will produce a my_prog.bin file you can run with the monitor.
To assemble with verbose debugging (probably only of interest to RX82 developers), use the --debug switch:
rx82 asm --debug my_prog.asmTo start the monitor in debug (single-step) mode:
rx82 monYou can also optionally load and run a binary file (such as one produced by the assembler, for example):
rx82 mon my_prog.binThe program will run until a halt instruction is reached.
To run the program in single-step mode, use the --debug switch:
rx82 mon --debug my_prog.binIn single-step mode, the monitor displays the current CPU registers and the next instruction in memory, then prompts for a command:
PC A B C D E F G H Z | NEXT
0000 00 00 00 00 00 00 00 00 0 | ld a, 0x01
>To execute the next CPU instruction, press Enter, or press Ctrl-C to exit.
Run:
rx82 dis my_prog.binThis will print the disassembled listing.
The RX82 is a single-board computer with one R8 CPU clocked at 4Mhz, 64KiB of static RAM, an 8-bit data bus, and a 16-bit address bus.
The R8 is an 8-bit CPU with some 16-bit features. It has eight 8-bit registers: A, B, C, D, E, F, G, and H. Similar to the Z80, these can also be addressed as four 16-bit register pairs: AB, CD, EF, and GH.
The 16-bit address bus allows the R8 to address up to 64KiB of memory, and the program counter register PC holds the 16-bit address of the next memory location to fetch from.
The processor status register PS contains the following flags:
- Zero: Set by any arithmetic operation affecting the user registers giving a zero result (for example, decrementing a register to zero). Cleared by any operation with a non-zero result.
The input format recognised by the R8 assembler is very similar to that of most Z80 or 6502 assemblers. Here's a simple example program:
ld a, 0xDE
inc a
ld b, 0xAD
ld cd, 0xBEEF
dec cd
ld ef, 0xCAFE
ld gh, 0xBABE
ld 0xFFFF, a
haltWhitespace is ignored, and only 0x-prefixed hexadecimal numbers are recognised as literals.
- 0.3.0 — all registers, load immediate and store direct instructions
- 0.2.0 — monitor improvements, add
haltinstruction, add assembler - 0.1.0 — first release