BasiliskII Macintosh 68k Emulator Ported to ESP32-P4 / M5Stack Tab5

Summary

BasiliskII ESP32 — Classic Macintosh Emulator for M5Stack Tab5 A full port of the BasiliskII Macintosh 68k emulator to the ESP32-P4 microcontroller, running on the M5Stack Tab5 hardware. This project brings classic Mac OS (System 7.x through Mac OS 8.1) to a portable embedded device with touchscreen input and USB peripheral support. Screenshots Overview This project runs a Motorola 68040 emulator that can boot real Macintosh ROMs and run genuine classic Mac OS software. The emulation includes: CPU : Motorola 68040 emulation with FPU (68881) : Motorola 68040 emulation with FPU (68881) RAM : Configurable from 4MB to 16MB (allocated from ESP32-P4's 32MB PSRAM) : Configurable from 4MB to 16MB (allocated from ESP32-P4's 32MB PSRAM) Display : 640×360 virtual display (2× scaled to 1280×720 physical display) : 640×360 virtual display (2× scaled to 1280×720 physical display) Storage : Hard disk and CD-ROM images loaded from SD card : Hard disk and CD-ROM images loaded from SD card Input: Capacitive touchscreen (as mouse) + USB keyboard/mouse support Hardware The Tab5 features a unique dual-chip architecture that makes it ideal for this project: Chip Role Key Features ESP32-P4 Main Application Processor 400MHz dual-core RISC-V, 32MB PSRAM, MIPI-DSI display ESP32-C6 Wireless Co-processor WiFi 6, Bluetooth LE 5.0 (not used by emulator) Key Specifications Component Details Display 5" IPS TFT, 1280×720 (720p), MIPI-DSI interface Touch Capacitive multi-touch (ST7123 controller) Memory 32MB PSRAM for emulated Mac RAM + frame buffers Storage microSD card slot for ROM, disk images, and settings USB Type-A host port for keyboard/mouse, Type-C for programming Battery NP-F550 Li-ion (2000mAh) for portable operation See boardConfig.md for detailed pin mappings and hardware documentation. Architecture Dual-Core Design The emulator leverages the ESP32-P4's dual-core RISC-V architecture for optimal performance: ┌─────────────────────────────────────────────────────────────────┐ │ ESP32-P4 (...