Repository files navigation

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 fromthe 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 beforeburning it into the EEPROM / Flash on the device.

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

Therefore some features like the 80286 protected mode and the 32 / 64 bitsmodes 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 runELKS,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 rathera test case for EMU86 than an intended use.

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

First configure EMU86 by editingconfig.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 runmake clean andmake as usual.

To build and run browser version (requires ELKS):

• Gotohttps://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

• 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:

• 8086tiny: a very compact PC emulator
• s80x86: FPGA implementation of 80186