EMU86 - IA16 emulator

QUICKSTART

make
./msdos.sh

PURPOSE

EMU86 is yet another 8086 / 8088 / 80186 / 80188 emulator.

That old 16 bits processor architecture (‘IA16’) is still used today in some devices
(SBC, MCU, SoC, FPGA, etc.) that reuse the huge hardware and code base from
the legacy and popular PC/XT/AT platform to build embedded systems.

This emulator is intended to help the related embedded software development,
at the stage of testing / debugging the code on the development system before
burning it into the EEPROM / Flash on the device.

The goal is NOT to reinvent the wheel for PC / end-user emulation, as others
projects like QEMU, DOSEMU, Bochs, etc., already do that job very well.

Therefore some features like the 80286 protected mode and the 32 / 64 bits
modes are out of this project scope.

The emulator has a modular design with:

memory state
processor state
instruction decoding
instruction printing
instruction execution
memory & I/O access handler for peripheral stubbing
interrupt handler for firmware (BIOS) stubbing
some debugger features (see below)
several backends (see below)

Debugger features:

silent / trace / interactive modes
registers / stack dump
initial code / data breakpoints
unhandled INT3 breakpoint
step in / over

The emulator provides 3 backends for the console or the serial port devices:

direct standard input / output in the emulator console,
the most easy to use, but mixed with the debugger input / output,
a pseudo-terminal (/dev/pts), with a bidirectional cat utility (pcat)
that allows to redirect from / to a file and thus easing test automation,
an SDL2 window (for console only).

CURRENT STATUS

The emulator is now able to run ELKS,
also known as ‘Linux 8086’, in a minimal PC/XT/AT configuration.

It is also able to emulate the Advantech SNMP-1000, an SBC based on the R8810 MCU,
that is a 80188 clone but merges some XL & EB features (both DMA & serial).

And last but not least, it is able to boot MS-DOS 6.22, but this is rather
a test case for EMU86 than an intended use.

Any addition to support more embbeded systems based on IA16 is welcome.

CONFIGURE & BUILD

First configure EMU86 by editing config.mk:

TARGET: emulated target / system
HOST: emulation on native host or in web browser (experimental)
CONSOLE: console backend for PC target
SERIAL: serial backend
STYLE: disassembly style in debugger

The default configuration is for a minimal PC / XT / AT.

Three other default configurations are provided for convenience:

config-elks.mk
config-advtech.mk
config-or566.mk

Then run make clean and make as usual.

To build and run browser version (requires ELKS):

Goto https://emscripten.org/docs/getting_started/downloads.html to download and install Emscripten SDK.
Change HOST=emscripten in config.mk
source ~/emsdk/emsdk_env.sh
make
emrun --serve_after_close emu86.html

TO DO LIST

Some IA16 instructions are rarely used and so not implemented yet
More emulation of the 8018X and R8810 MCUs
Add EEPROM / Flash emulation for complete emulation before burning on real device
See also the list of GitHub issues