Emulator for the MicroBeast Z80 computer kit. Features include:

• 512K RAM, 512K ROM (4x16K paging)
• Z80 PIO with software I2C bus
• 24 Character, 14 segment LED display
• RTC
• 16C550 UART
• I/O mapped keyboard
• 1 bit audio

The emulator is cycle stepped, running under Windows and Linux with the SDL2 library. Win64 binaries are available under the release directory.

It includes a simple debugger and disassembler, serial out to console, audio dump and integration with assembly listing files. Assembly files are pinned to memory pages, allowing the correct view for resident programs running at the same physical memory address.

All of the main features of MicroBeast are emulated, allowing software to be developed for the machine and similar Z80 architectures.

Precompiled binaries are available for Windows-64 in the Release section on GitHub.

BeastEm requires a number of libraries and files to run. For Windows, these files are all supplied in the release/win64 directory, which also contains a batch file to configure the library path and start the program.

Linux users should copy the exectutable to a directory along with the files in the assets folder in order to run BeastEm.

Windows users can run beast.bat in the release/win64 directory.

Linux users can run BeastEm with the executable name beastem on the command line.

If no parameters are supplied, BeastEm will start the emulator up with an (incomplete) monitor ROM that exercises some of the features of MicroBeast. This is equivalent to running with the command line:

beastem -f flash_v1.5.bin -l 0 firmware.lst -l 23 bios.lst

The following command line options may be used:

BeastEm will synchronise debug with listing files in the TASM format (each line consisting of a line number, one or more spaces and then the assembly address in hex). Other formats may be supported in future.

A listing file is pinned to the memory page it is loaded into, as well as the physical address in the listing itself. This allows code paged in to memory to be correctly identified.

Note that no checks are made that the memory contents match the provided listing, so the assembly shown may not be accurate.

The Emulator starts in the debug view, showing the state of the CPU, PIO and a disassembly or listing of the current execution address. When the emulator is running, the debug view is hidden and keyboard input goes directly to MicroBeast. At any time, hitting ESCAPE will return to the debug view.

In the debug view, most commands take a single keypress. The currently implemented commands are:

When a value is selected, hitting Enter will allow a new value to be set, or toggle a binary On|Off value.

Besides showing the address pointed to by register pairs, the memory views also allow memory to be directly inspected. The Z80 option views the CPU's memory map (0-64K), whereas the PAGE option allows any page in the 1Mb paged memory (512K ROM, 512K RAM) to be examined.

A terminal can be connected to the emulated MicroBeast UART over a network socket. Data sent to and from the terminal will be handled as though sent to the UART at whatever Baud rate it is configured for.

To connect a terminal, ensure the debug screen is visible and check the port number displayed next to the TTY menu option (default 8456). Open your preferred terminal program and connect to localhost:8456. The debug window will indicate when a connection is made, and the D key will disconnect and await a new connection.

The UART simulates hardware handshake (no data is discarded or overrun), and the 16C550 RX/TX FIFO, but does not currently implement interrupts, so software must poll the UART directly for its state.

BeastEm uses SDL2, and is compiled with g++.

Windows users can install g++ with MySys64, following this guide. The project can then be build in VisualCode, producing an executable with all supporting files in release\win64.

Linux users will need to install the SDL2 development libraries, specifically libsdl2-dev, libsdl2-gfx-dev, libsdl2-net-dev and libsdl2-ttf-dev. Build the executable with:

make clean all

which should find the appropriate includes and libraries for you. Alternatively, you can build manually with e.g:

g++ -w -O2 -o beastem beastem.cpp src/*.cpp -I/usr/include/SDL2 -D_REENTRANT -lSDL2 -lSDL2_ttf -lSDL2_gfx -lSDL2_net

(This assumes all SDL2 include files have been installed to /usr/include/SDL2).

Once the executable is built, copy it and the files in the assets folder to the desired location to run BeastEm.

Install the required SDL libraries, for example using homebrew:

brew install sdl2 sdl_2gfx sdl2_image sdl2_net sdl2_ttf

And build with:

make clean all

This should find the appropriate includes and libraries for you, and should work on both Intel and Apple Silicon.

Alternatively, you can build manually with e.g:

g++ -w -O2 -o beastem beastem.cpp src/*.cpp -I/usr/include/SDL2 -D_REENTRANT -lSDL2 -lSDL2_ttf -lSDL2_gfx -lSDL2_net

Assuming a homebrew installation on Apple Silicon, the libraries and include files will be in /opt/homebrew. To compile, install the Xcode command line tools, and then run:

clang++ -w --std=c++20 -O2 -o beastem beastem.cpp src/*.cpp -I /opt/homebrew/include/SDL2 -D_REENTRANT -lSDL2 -lSDL2_ttf -lSDL2_gfx -lSDL2_net

If all goes well this will create the beastem binary which can be copied with the files from the assets folder and run alongside them.

The emulator is a work in progress, and assumes relatively well behaved code. Particularly, the exact timings of some of the perphierals has not been implemented. Overall performance is not a priority, so it may require a relatively powerful PC to run.

BeastEm is one part of a much bigger project to build a unique new computer, so other parts of that larger project may take precedence.

Some features are not yet implemented:

• RTC Alarms, battery monitoring
• PIO inputs
• Flash ROM erase and write

The Debugger is also on early release, currently missing:

• Memory editing
• Read / write binary files during emulation
• Navigating through listings/disassembly.

The included monitor ROM is also early code, demonstrating some simple concepts on MicroBeast. It is included only for test purposes.

Further information on MicroBeast can be found at the Wiki, or the Feersum Technology Website

If you find this tool useful, please let me know. Positive reinforcement really helps!

If there are omissions, bugs or you have suggestions or code to contribute - you are very welcome. Please get in contact.

This tool depends on some fantastic libraries, including SDL2, SDL GFX, SDL TTF, and the excellent Z80 core emulators by Andre Weissflog. Accordingly, BeastEm is released under the Zlib license -