FabGL
ESP32 VGA Controller and Graphics Library
Altair8800/Altair8800.ino

Altair 8800 Emulator - with ADM-31, ADM-3A, Kaypro, Hazeltine 1500 and Osborne I terminal emulation

/*
Created by Fabrizio Di Vittorio (fdivitto2013@gmail.com) - www.fabgl.com
Copyright (c) 2019 Fabrizio Di Vittorio.
All rights reserved.
This file is part of FabGL Library.
FabGL is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
FabGL is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with FabGL. If not, see <http://www.gnu.org/licenses/>.
*/
#include <Preferences.h>
#include "esp_spiffs.h"
#include "fabgl.h"
#include "fabutils.h"
#include "src/machine.h"
// 8'' disk images (338K)
// CP/M 2.2
#include "disks/CPM22/cpm22_dsk.h"
#include "disks/CPM22/games_dsk.h"
#include "disks/CPM22/turbopascal3_dsk.h"
#include "disks/CPM22/wordstar3_dsk.h"
#include "disks/CPM22/wordstar4_dsk.h"
#include "disks/CPM22/multiplan_dsk.h"
#include "disks/CPM22/dbaseii_dsk.h"
#include "disks/CPM22/BDSC_dsk.h"
#include "disks/CPM22/langs_dsk.h"
// CP/M 1.4
#include "disks/CPM14/cpm141_dsk.h"
// CP/M 3
#include "disks/CPM3/cpm3_disk1_dsk.h"
#include "disks/CPM3/cpm3_disk2_dsk.h"
#include "disks/CPM3/cpm3_build_dsk.h"
// Altair DOS
// MEMORY SIZE? [insert "64"]
// INTERRUPTS? [press ENTER]
// HIGHEST DISK NUMBER? [insert "1"]
// HOW MANY DISK FILES? [insert "4"]
// HOW MANY RANDOM FILES? [insert "4"]
#include "disks/AltairDOS/DOS_1_dsk.h"
#include "disks/AltairDOS/DOS_2_dsk.h"
// Basic
// MEMORY SIZE? [press ENTER]
// LINEPRINTER? [insert "C"]
// HIGHEST DISK NUMBER? [press ENTER]
// HOW MANY FILES? [press ENTER]
// HOW MANY RANDOM FILES? [press ENTER]
#include "disks/basic/basic5_dsk.h"
// Mini disk images (76K)
// CP/M 2.2
#include "minidisks/CPM22/cpm22_disk1_minidsk.h"
#include "minidisks/CPM22/cpm22_disk2_minidsk.h"
// Basic (need i8080 CPU)
// MEMORY SIZE? [press ENTER]
// LINEPRINTER? [insert "C"]
// HIGHEST DISK NUMBER? [insert "0"]
// HOW MANY FILES? [insert "3"]
// HOW MANY RANDOM FILES? [insert "2"]
#include "minidisks/basic/basic300_5F_minidisk.h"
// Disks configuration
// Enable this when using 8'' disk images ("disks" folder)
#define DISKFORMAT Disk_338K
// Enable this when using minidisk images ("minidisk" folder)
//#define DISKFORMAT MiniDisk_76K
// Specify which disk image assign to drives
#define DRIVE_A cpm22_dsk // A: read only
#define DRIVE_B langs_dsk // B: read only
#define DRIVE_C "/spiffs/diskC.dsk" // C: read/write
#define DRIVE_D "/spiffs/diskD.dsk" // D: read/write
// consts
constexpr int DefaultCPU = 1; // 0 = i8080, 1 = Z80
const char * TermStr[] = { "ANSI/VT", "Lear Siegler ADM-3A", "Lear Siegler ADM-31", "Hazeltine 1500", "Osborne I", "Kaypro" };
constexpr int DefaultTermIndex = 2; // Default: "ADM-31"
constexpr int MaxTermIndex = 5; // Max: "Kaypro"
const char * KbdLayStr[] = { "US", "UK", "DE", "IT" };
const fabgl::KeyboardLayout * KdbLay[] = { &fabgl::USLayout, &fabgl::UKLayout, &fabgl::GermanLayout, &fabgl::ItalianLayout };
constexpr int DefaultKbdLayIndex = 1; // Default: "UK"
constexpr int MaxKbdLayIndex = 3; // Max: "IT"
const char * ColorsStr[] = { "Green/Black", "Yellow/Black", "White/Black", "Black/White", "Yellow/Blue", "Black/Yellow" };
constexpr int DefaultColorsIndex = 0; // Default: Green/Black
constexpr int MaxColorsIndex = 5;
// globals
TerminalClass Terminal;
Machine altair;
Mits88Disk diskDrive(&altair, DISKFORMAT);
Preferences preferences;
void setTerminalColors()
{
int colorsIndex = preferences.getInt("colors", DefaultColorsIndex);
Terminal.setForegroundColor(TextColors[colorsIndex]);
Terminal.setBackgroundColor(BackColors[colorsIndex]);
}
void setup()
{
preferences.begin("altair8800", false);
Serial.begin(115200);
// setup Keyboard (default configuration)
PS2Controller.begin(PS2Preset::KeyboardPort0);
// setup VGA (default configuration with 64 colors)
VGAController.begin();
if (preferences.getBool("emuCRT", false))
else
//VGAController.shrinkScreen(5, 0);
//VGAController.moveScreen(-1, 0);
// this speed-up display but may generate flickering
VGAController.enableBackgroundPrimitiveExecution(false);
Terminal.begin();
Terminal.connectLocally(); // to use Terminal.read(), available(), etc..
Terminal.setBackgroundColor(Color::Black);
Terminal.setForegroundColor(Color::BrightGreen);
Terminal.clear();
Terminal.enableCursor(true);
}
// shown pressing PAUSE
void emulator_menu()
{
bool resetRequired = false;
for (bool loop = true; loop; ) {
diskDrive.flush();
Terminal.write("\r\n\n\e[97m\e[40m ** Emulator Menu **\e[K\r\n\e[K\n");
Terminal.write( "\e[93m Z \e[37m Reset\e[K\n\r");
Terminal.write( "\e[93m S \e[37m Send Disk to Serial\e[K\n\r");
Terminal.write( "\e[93m R \e[37m Get Disk from Serial\e[K\n\r");
Terminal.write( "\e[93m F \e[37m Format SPIFFS\e[K\n\r");
Terminal.printf("\e[93m U \e[37m CPU: \e[33m%s\e[K\n\r", preferences.getInt("CPU", DefaultCPU) == 1 ? "Z80" : "i8080");
Terminal.printf("\e[93m P \e[37m Real CPU Speed: \e[33m%s\e[K\n\r", preferences.getBool("realSpeed", false) ? "YES" : "NO");
Terminal.write("\e[6A"); // cursor UP
Terminal.printf("\t\t\t\t\t\e[93m T \e[37m Terminal: \e[33m%s\e[K\n\r", TermStr[preferences.getInt("termEmu", DefaultTermIndex)] );
Terminal.printf("\t\t\t\t\t\e[93m K \e[37m Keyboard Layout: \e[33m%s\e[K\n\r", KbdLayStr[preferences.getInt("kbdLay", DefaultKbdLayIndex)] );
Terminal.printf("\t\t\t\t\t\e[93m G \e[37m CRT Mode: \e[33m%s\e[K\n\r", preferences.getBool("emuCRT", false) ? "YES" : "NO");
Terminal.printf("\t\t\t\t\t\e[93m C \e[37m Colors: \e[33m%s\e[K\n\r", ColorsStr[preferences.getInt("colors", DefaultColorsIndex)] );
Terminal.write( "\t\t\t\t\t\e[93m O \e[37m Reset Configuration\e[K\n\r");
Terminal.write("\n\n\e[97mPlease select an option (ENTER to exit): \e[K\e[92m");
int ch = toupper(Terminal.read());
Terminal.write(ch);
Terminal.write("\n\r");
switch (ch) {
// 1. Send a disk image to Serial Port
// 2. Receive a disk image from Serial Port
case 'S':
case 'R':
{
Terminal.write("Select a drive (A, B, C, D...): ");
char drive = toupper(Terminal.read());
if (ch == 'S') {
Terminal.printf("\n\rSending drive %c...\n\r", drive);
diskDrive.sendDiskImageToStream(drive - 'A', &Serial);
} else if (ch == 'R') {
Terminal.printf("\n\rReceiving drive %c...\n\r", drive);
diskDrive.receiveDiskImageFromStream(drive - 'A', &Serial);
}
break;
}
// Format SPIFFS
case 'F':
Terminal.write("Formatting SPIFFS removes RW disks and resets the Altair. Are you sure? (Y/N)");
if (toupper(Terminal.read()) == 'Y') {
Terminal.write("\n\rFormatting SPIFFS...");
fabgl::suspendInterrupts();
esp_spiffs_format(nullptr);
fabgl::resumeInterrupts();
resetRequired = true;
}
break;
// Reset
case 'Z':
Terminal.write("Resetting the Altair. Are you sure? (Y/N)");
if (toupper(Terminal.read()) == 'Y')
ESP.restart();
break;
// Real CPU speed
case 'P':
preferences.putBool("realSpeed", !preferences.getBool("realSpeed", false));
altair.setRealSpeed(preferences.getBool("realSpeed", false));
break;
// Emulate CRT
case 'G':
preferences.putBool("emuCRT", !preferences.getBool("emuCRT", false));
resetRequired = true;
break;
// CPU
case 'U':
preferences.putInt("CPU", preferences.getInt("CPU", DefaultCPU) ^ 1);
resetRequired = true;
break;
// Terminal emulation
case 'T':
{
int termIndex = preferences.getInt("termEmu", DefaultTermIndex) + 1;
if (termIndex > MaxTermIndex)
termIndex = 0;
preferences.putInt("termEmu", termIndex);
Terminal.setTerminalType((TermType)termIndex);
break;
}
// Keyboard layout
case 'K':
{
int kbdLayIndex = preferences.getInt("kbdLay", DefaultKbdLayIndex) + 1;
if (kbdLayIndex > MaxKbdLayIndex)
kbdLayIndex = 0;
preferences.putInt("kbdLay", kbdLayIndex);
Keyboard.setLayout(KdbLay[kbdLayIndex]);
break;
}
// Colors
case 'C':
{
int colorsIndex = preferences.getInt("colors", DefaultColorsIndex) + 1;
if (colorsIndex > MaxColorsIndex)
colorsIndex = 0;
preferences.putInt("colors", colorsIndex);
break;
}
// Reset configuration
case 'O':
preferences.clear();
resetRequired = true;
break;
default:
loop = false;
break;
}
}
if (resetRequired) {
Terminal.write("Reset required. Reset now? (Y/N)");
if (toupper(Terminal.read()) == 'Y') {
diskDrive.detachAll();
ESP.restart();
}
}
Terminal.localWrite("\n");
setTerminalColors();
}
void loop()
{
Terminal.write("Formatting SPIFFS...\r");
// setup SPIFFS
esp_vfs_spiffs_conf_t conf = {
.base_path = "/spiffs",
.partition_label = NULL,
.max_files = 4,
.format_if_mount_failed = true
};
fabgl::suspendInterrupts();
esp_vfs_spiffs_register(&conf);
fabgl::resumeInterrupts();
// setup disk drives
diskDrive.attachReadOnlyBuffer(0, DRIVE_A);
diskDrive.attachReadOnlyBuffer(1, DRIVE_B);
Terminal.write("Creating Disk C... \r");
diskDrive.attachFile(2, DRIVE_C);
Terminal.write("Creating Disk D... \r");
diskDrive.attachFile(3, DRIVE_D);
// setup SIOs (Serial I/O)
// TTY
SIO SIO0(&altair, 0x00);
SIO0.attachStream(&Terminal);
// CRT/Keyboard
SIO SIO1(&altair, 0x10);
SIO1.attachStream(&Terminal);
// Serial
SIO SIO2(&altair, 0x12);
SIO2.attachStream(&Serial);
// RAM
altair.attachRAM(65536);
// boot ROM
altair.load(Altair88DiskBootROMAddr, Altair88DiskBootROM, sizeof(Altair88DiskBootROM));
// menu callback (pressing PAUSE)
altair.setMenuCallback(emulator_menu);
setTerminalColors();
Terminal.clear();
// scrolling region (24 rows)
Terminal.write("\e[1;24r");
Terminal.write("\e[97m\e[44m");
Terminal.write(" /* * * * * * * * * * * * * * * * * * * *\e[K\r\n");
Terminal.write("\e#6");
Terminal.write("\e#3 ALTAIR 8800\e[K\r\n");
Terminal.write("\e#4 ALTAIR 8800\e[K\r\n");
Terminal.write("\e#5");
Terminal.write("\e[K\r\n");
Terminal.write(" \e[37mby Fabrizio Di Vittorio - www.fabgl.com\e[97m\e[K\r\n");
Terminal.write(" * * * * * * * * * * * * * * * * * * * */\e[K\r\n\e[K\n");
Terminal.printf("\e[33mFree DMA Memory :\e[32m %d bytes\e[K\r\n", heap_caps_get_free_size(MALLOC_CAP_DMA));
Terminal.printf("\e[33mFree 32 bit Memory :\e[32m %d bytes\e[K\r\n", heap_caps_get_free_size(MALLOC_CAP_32BIT));
size_t total = 0, used = 0;
esp_spiffs_info(NULL, &total, &used);
Terminal.printf("\e[33mSPI Flash File System :\e[32m %d bytes used, %d bytes free\e[92m\e[K\r\n\e[K\n", used, total - used);
Terminal.printf("Press \e[93mPAUSE\e[92m to display emulator menu\e[K\r\n");
setTerminalColors();
// setup keyboard layout
int kbdLayIndex = preferences.getInt("kbdLay", DefaultKbdLayIndex);
Keyboard.setLayout(KdbLay[kbdLayIndex]);
// setup terminal emulation
int termIndex = preferences.getInt("termEmu", DefaultTermIndex);
Terminal.setTerminalType((TermType)termIndex);
// CPU speed
altair.setRealSpeed(preferences.getBool("realSpeed", false));
CPU cpu = (preferences.getInt("CPU", DefaultCPU) == 1 ? Z80 : i8080);
altair.run(cpu, Altair88DiskBootROMRun);
}