make
./msdos.sh
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).
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.
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.mkconfig-advtech.mkconfig-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.shmakeemrun --serve_after_close emu86.html
- 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
Other projects of interest: