Version 0.1

jhhoward · Oct 29, 2019 · 3631a44 · 3631a44
1 parent 65a7349
commit 3631a44
Show file tree

Hide file tree

Showing 80 changed files with 113 additions and 36,966 deletions.
diff --git a/README.md b/README.md
@@ -0,0 +1,25 @@
+# Faux86: A portable, open-source 8086 PC emulator for bare metal Raspberry Pi
+Faux86 is designed to be run 'bare metal' on a Raspberry Pi. This means that the emulator runs directly on the hardware so no OS needs to booted on the Pi. 
+
+## Features
+- 8086 and 80186 instruction set emulation
+- CGA / EGA / VGA emulation is mostly complete
+- PC speaker, Adlib and Soundblaster sound emulation
+- Serial mouse emulation
+
+## Usage with Raspberry Pi
+By default Faux86 boots from a floppy image dosboot.img which in the emulator is mounted as drive A. The SD card will be mounted as drive C and any connected USB mass storage device will be mounted as D.
+Since MS-DOS is accessing the SD card directly, it does not work for large SD card types. I have found the best solution is to use a small capacity SD card and flash the image as a 32MB card.
+USB keyboard and mouse should be plugged in before booting - hot swapping of devices is not supported.
+
+## Credits
+Faux86 was originally based on the Fake86 emulator by Mike Chambers. 
+http://fake86.rubbermallet.org
+A lot of the code has been shuffled around or rewritten in C++ but the core CPU emulation remains mostly the same.
+
+Faux86 uses the Circle library to interface with the Raspberry Pi
+https://github.com/rsta2/circle
+
+
+
+
diff --git a/build/bootcode.bin b/build/bootcode.bin
diff --git a/build/config.txt b/build/config.txt
@@ -0,0 +1,5 @@
+# Disable rainbow splash screen
+disable_splash=1
+
+# Force aspect ratio to 4:3
+sdtv_aspect=1
diff --git a/build/faux86.img b/build/faux86.img
diff --git a/build/kernel.img b/build/kernel.img
diff --git a/build/kernel7.img b/build/kernel7.img
diff --git a/build/start.elf b/build/start.elf
diff --git a/data/dosboot.h b/data/dosboot.h
diff --git a/data/dosboot.img b/data/dosboot.img
diff --git a/data/videorom.bin b/data/videorom.bin
diff --git a/pi/CircleDeviceDisk.h b/pi/CircleDeviceDisk.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/CircleHostInterface.cpp b/pi/CircleHostInterface.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/CircleHostInterface.h b/pi/CircleHostInterface.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/FatFsDisk.h b/pi/FatFsDisk.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/PWMSound.cpp b/pi/PWMSound.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/PWMSound.h b/pi/PWMSound.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/VCHIQSound.cpp b/pi/VCHIQSound.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/VCHIQSound.h b/pi/VCHIQSound.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/pi/kernel.cpp b/pi/kernel.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or
@@ -28,9 +28,11 @@
 #if USE_EMBEDDED_BOOT_FLOPPY
 #include "../data/dosboot.h"
 #endif
+#if USE_EMBEDDED_ROM_IMAGES
 #include "../data/asciivga.h"
 #include "../data/pcxtbios.h"
 #include "../data/videorom.h"
+#endif
 
 #define REQUIRED_KERNEL_MEMORY (0x2000000)
 
@@ -46,6 +48,7 @@ using namespace Faux86;
 
 CKernel::CKernel (void) :
 //:	m_Screen (256, 256, true),//(m_Options.GetWidth (), m_Options.GetHeight (), true),
+	m_ActLED(false),
 #if !USE_BCM_FRAMEBUFFER
 	m_Screen (m_Options.GetWidth (), m_Options.GetHeight ()),
 #endif
@@ -68,33 +71,6 @@ boolean CKernel::Initialize (void)
 {
 	boolean bOK = TRUE;
 
-	//m_pFrameBuffer = new CBcmFrameBuffer (OUTPUT_DISPLAY_WIDTH, OUTPUT_DISPLAY_HEIGHT, 8);
-	//	
-	//for(int n = 0; n < 16; n++)
-	//{
-	//	m_pFrameBuffer->SetPalette32 (n, palettecga[n]);  
-	//}
-	//m_pFrameBuffer->SetPalette (0, 0x0000);  // black
-	//m_pFrameBuffer->SetPalette (1, 0x0010);  // blue
-	//m_pFrameBuffer->SetPalette (2, 0x8000);  // red
-	//m_pFrameBuffer->SetPalette (3, 0x8010);  // magenta
-	//m_pFrameBuffer->SetPalette (4, 0x0400);  // green
-	//m_pFrameBuffer->SetPalette (5, 0x0410);  // cyan
-	//m_pFrameBuffer->SetPalette (6, 0x8400);  // yellow
-	//m_pFrameBuffer->SetPalette (7, 0x8410);  // white
-	//m_pFrameBuffer->SetPalette (8, 0x0000);  // black
-	//m_pFrameBuffer->SetPalette (9, 0x001F);  // bright blue
-	//m_pFrameBuffer->SetPalette (10, 0xF800); // bright red
-	//m_pFrameBuffer->SetPalette (11, 0xF81F); // bright magenta
-	//m_pFrameBuffer->SetPalette (12, 0x07E0); // bright green
-	//m_pFrameBuffer->SetPalette (13, 0x07FF); // bright cyan
-	//m_pFrameBuffer->SetPalette (14, 0xFFE0); // bright yellow
-	//m_pFrameBuffer->SetPalette (15, 0xFFFF); // bright white
-
-	//if (!m_pFrameBuffer->Initialize()) {
-	//	return FALSE;
-	//}
-
 #if !USE_BCM_FRAMEBUFFER
 	if (bOK)
 	{
@@ -170,12 +146,14 @@ boolean CKernel::Initialize (void)
 		vmConfig->asciiFile = HostInterface->openFile("SD:/asciivga.dat");
 		vmConfig->diskDriveA = HostInterface->openFile("SD:/dosboot.img");
 
+#if USE_EMBEDDED_ROM_IMAGES
 		if(!vmConfig->biosFile)
 			vmConfig->biosFile = new EmbeddedDisk(pcxtbios, sizeof(pcxtbios));
 		if(!vmConfig->videoRomFile)
 			vmConfig->videoRomFile = new EmbeddedDisk(videorom, sizeof(videorom));
 		if(!vmConfig->asciiFile)
 			vmConfig->asciiFile = new EmbeddedDisk(asciivga, sizeof(asciivga));
+#endif
 #if USE_EMBEDDED_BOOT_FLOPPY
 		if(!vmConfig->diskDriveA)
 			vmConfig->diskDriveA = new EmbeddedDisk(dosboot, sizeof(dosboot));

diff --git a/pi/kernel.h b/pi/kernel.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or
@@ -41,7 +41,8 @@
 
 
 #define USE_BCM_FRAMEBUFFER 1
-#define USE_EMBEDDED_BOOT_FLOPPY 1
+#define USE_EMBEDDED_BOOT_FLOPPY 0
+#define USE_EMBEDDED_ROM_IMAGES 0
 #define USE_MMC_MOUNTING 1
 #define USE_SERIAL_LOGGING 0
 #define USE_VCHIQ_SOUND 1

diff --git a/pi/main.cpp b/pi/main.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Adlib.cpp b/src/faux86/Adlib.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Adlib.h b/src/faux86/Adlib.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Audio.cpp b/src/faux86/Audio.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Audio.h b/src/faux86/Audio.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/CPU.cpp b/src/faux86/CPU.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/CPU.h b/src/faux86/CPU.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/CPUMacros.h b/src/faux86/CPUMacros.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Config.cpp b/src/faux86/Config.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Config.h b/src/faux86/Config.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/DMA.cpp b/src/faux86/DMA.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/DMA.h b/src/faux86/DMA.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/DisneySoundSource.cpp b/src/faux86/DisneySoundSource.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/DisneySoundSource.h b/src/faux86/DisneySoundSource.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/DriveManager.cpp b/src/faux86/DriveManager.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/DriveManager.h b/src/faux86/DriveManager.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/HostSystemInterface.h b/src/faux86/HostSystemInterface.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/InputManager.cpp b/src/faux86/InputManager.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/InputManager.h b/src/faux86/InputManager.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/Log.h b/src/faux86/Log.h
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or

diff --git a/src/faux86/MemUtils.cpp b/src/faux86/MemUtils.cpp
@@ -1,7 +1,7 @@
 /*
   Faux86: A portable, open-source 8086 PC emulator.
   Copyright (C)2018 James Howard
-  Base on Fake86
+  Based on Fake86
   Copyright (C)2010-2013 Mike Chambers
 
   This program is free software; you can redistribute it and/or