kopia lustrzana https://github.com/Jean-MarcHarvengt/MCUME
c43b757006 | ||
---|---|---|
MCUME_esp32 | ||
MCUME_teensy | ||
i2ckeyboard | ||
images | ||
README.md | ||
sd.zip |
README.md
M.CU.M.E = Multi CompUter Machine Emulator
A collection of 80th game Console and Computer emulators ported to Teensy and ESP32 MCUs.
Have a look at the video: https://youtu.be/jlqoWH2X6gk
This project is a spin-off of the TeensyCEC project https://github.com/Jean-MarcHarvengt/TeensyCEC
Featuring
5 game consoles:
Atari2600 (espvcs), Philips Videopac/Odyssey (espo2em), Colecovision (espcolem), NES (espnofrendo) and Atari5200 (esp5200).
4 computer cores:
Zx80/Zx81 (esp81), Zx Spectrum (espspeccy), Atari800 (esp800)and C64 (esp64)
Minimal requirements:
- Teensy 3.6/Teensy4.0 or ESP32 Node32S/Wrover SDK chip
- ILI9341 or ST7789 SPI display
- SD card (Teensy uses built-in uSD, ESP32 uses external one connected over SPI, e.g. ILI9341 integrated one)
- Analog joypad (Arduino or PSP like)
- 3 buttons (FIRE, USER1 and USER2)
Optional requirements:
- I2C custom keyboard (for computers emulators)
- Sound (DAC for ESP and Teensy3.6, MQS for Teensy4.0)
- VGA output (Teensy 3.6 only)
Wiring
- see pinout.txt file in the respective project (ESP32 or Teensy)
- Some KICAD image also available for ESP32
I2C keyboard (best to have for computer emus)
- see i2ckeyboard sub-directory
- the I2C keyboard is using a separate atmega328p MCU handling the keys matrix
- with 10x4 or 10x5 keys
Installation
- Format the SD card as FAT32
- extract the content of SD.zip in the root directory
- there must be a sub-directorie for each emulator
- "2600" => for atarivcs, put your Atari 2600 roms here (.bin)
- "5200" => for atari5200, put your Atari 5200 roms here (.bin)
- "800" => for atari800, put your Atari 800 cartridges here (.rom)
- 'c64" => for c64, put your C64 programs here (.prg)
- "o2em" => for odyssey/videopac, put your Videopac/Odysssey roms here (.bin)
- "coleco" => for colem, put your Colecovision roms here (.rom, including coleco.rom)
- "nes" => for nes/nofrendo, put your .nes files here (e.g. galaga,xevious,mario1...)
- "spec" => for spectrum, put your ".z80" or ".sna" files here into sub-dirs or not ( max 48K )
- "z81" => for zx81, put your ".p", ".81"(, ".56") ".80" or ".o" files here, into sub-dirs or not ( max 56K )
- "st" => for AtariST, put your ".st" files here, into sub-dirs or not
- "pc" => for zx81, put your HDD image ".img"
- "vectrex" => for Vectrex, put your ".gam" files here, into sub-dirs or not
- insert the card into the SD slot
Compilation/flashing (Teensy)
- open the respective ino file with Arduino SDK
- compile and install from there.
Compilation/flashing (ESP32)
- go to espboot directory first:
- make, make flash => this will install custom partition table, bootloader and app selector
- go to any other directory (one by one!):
- Adapt ./flashapp.sh according your OS (I use OSX)
- make, ./flashapp.sh
Status and known issues
- 64:
- Full speed with sound
- I2C custom keyboard support!
- (only few games working)
- colem:
- Full speed with sound
- vcs:
- no sound yet
- limited cartridge size support (due to ram constraint)
- o2em:
- no sound
- only videopac G7000 games supported (due to ram constraint)
- nofrendo:
- Full speed with sound
- 32k roms only supported except on Teensy 4.0
- 5200:
- Full speed with sound
- 16 and 32k roms
- speccy:
- SNA support (Z80 to be fixed)
- YM and preliminary buzz sound support
- 48k games only supported
- kempston joystick supported but on screen keyboard may not answer in some games
- I2C custom keyboard support!
- 81:
- zx80 and zx81
- .P, .81 and .80 format support (rename .56 for Zx81 hires game that requires 48k or more)
- I2C custom keyboard support!
- HIRES support for zx81
- zx80 support
- YM sound support for zx81
- 800:
- .rom support (no floppy yet)
- I2C custom keyboard support!
- Full speed with sound
- AtariST:
- floppy support
- I2C custom keyboard support!
- with sound
- full speed on Teensy4.0 only!!
- PC:
- HDD image support
- I2C custom keyboard support!
- no sound
- full speed on Teensy4.0 only!!
- Vectrex:
- .gam roms support
- no sound
- full speed on Teensy4.0 only!!
Running
- ESP32 only: Select the emulator from the app selector screen and press FIRE (wait a bit that the SD get mounted)
- For the launched emulator you should see the roms of the SD card being listed
- you can select the rom with up/down
- you can start the game by pressing the FIRE key
- while the game is running, you might have to press USER1 or USER2 keys to start the game
- some emulators requires the I2Ckeyboard
- You can then play the game with the analog joystick and the FIRE/USER1 keys
- press the USER1+USER2 to reboot the emulator and load another ROM
- USER2 can be used to swap joystick 1/2 in some emulators
Credits
I mostly ported the emulators from existing projects, all the credit goes to the authors of colem, o2em , x2600, moarnes, mc-4u, sz81, atari800, Vice, Nofrendo, jun52, dcastaway, vectrexemu and 8086 Arduino projects! Thanks a lot also to Frank Boesing for his ILI DMA library from which I started from and his great Teensy64 project https://github.com/FrankBoesing/Teensy64