History

Virgil Dupras 3198cd8d08 emul/8086/pcat: fix broken AT-XY		2020-10-25 18:42:48 -04:00
..
.gitignore
cpu.c	emul/8086: a little bit of cleanup in cpu.c	2020-10-25 14:25:12 -04:00
cpu.h
forth.c
Makefile
pcat.c	emul/8086/pcat: fix broken AT-XY	2020-10-25 18:42:48 -04:00
README.md
xcomp.fs

README.md

8086 emulator

This folder contains emulator for 8086 binaries of Collapse OS. The bulk of it is a fork of Fake86 by Mike Chambers.

forth is an imaginary hardware used for userspace development and testing. This machine has an imaginary interrupt API and does not conform to PC/AT.

pcat is a very simple PC/AT emulator. The BIOS interrupt hooks implemented in it only cover Collapse OS' own needs.

Requirements

You need ncurses to build the forth executable. In debian-based distros, it's libncurses5-dev.

Build

Run make and it builds the forth and pcat interpreters.

Usage

The ./forth executable here works like the one in /cvm, except that it runs under an emulated 8086 machine instead of running natively. Refer to /cvm/README.md for details.

pcat needs to be suppied a path to a floppy disk image with a proper MBR. disk.bin provided by the pcat recipe is sufficient.