Emma 02

The Emma 02 emulator is able to emulate multiple computers all based on the RCA 1802 microprocessor. Additional information about this emulator can be found on the Emma 02 site.

These help pages describe all computers and tools available in Emma 02. See following sub-chapters for an overview, also note the short FAQ and Common Features describing common functions for most computers.

Table of contents:

Common Features
Computers
Debugger
Direct Assembler
FAQ
Memory Dump
Profiler
Syntax

Computers

For a summary of available computers and explanation how to navigate the GUI to your favourite one please read Computers. When you have selected your computer a default configuration should be loaded, you can manually change settings as required and most computers have an option to load different pre-configured configuration as described in the Configurations chapter.

To start a computer emulation press 'Start' as shown in screenshot below (yellow ellipse)

After startup the 'Start' button will change to 'Reset' and the 'Stop' button will be enabled. To stop a running computer either press 'Stop' or close the main emulation window.

Debugger

The debugger will (among other things) allow you to trace code, set break points or check specific register values. Two debugger tabs are available one for the 1802 and one for pseudo code. See also the Debugger chapter.

Direct Assembler

A powerful assembler and disassembler is available in Emma 02, for details see Direct Assembler. Depending on the running computer the assembler handles any 180x related code (SYSTEM00, 1801, 1802, 1804 and 1805/1806) as well as multiple pseudo code variants (Chip-8, Super-chip, ST2, ST4 etc.). See also the Syntax chapter for specification of the accepted syntax.

The assembler can be used for writing anything from small pieces of software to larger projects. For example I designed and wrote the completer COMX Super Board FW in the Emma 02 assembler.

The assembler and disassembler are also especially powerful for debugging and patching existing code. See also the Debugging Existing Code - Example for a short 'how-to'.

Profiler

Main purpose of the Profiler to find hot code spots, dead code and analyse code & test coverage as well as analyse timing for the running computer and CPU.

Memory Dump

The Memory Dump shows an overview of one page (256 bytes) of memory, shown in hexadecimal format. Next to options to show regular and video memory it is also possible to show what type of memory (RAM, ROM, video etc) is connect or see an overview of the profile counters.