# esplay-retro-emulation
**Repository Path**: zhangzc/esplay-retro-emulation
## Basic Information
- **Project Name**: esplay-retro-emulation
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-07-27
- **Last Updated**: 2024-07-27
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ESPlay Retro Emulation
 [](https://GitHub.com/pebri86/esplay-retro-emulation/releases/)  
Description and Video Review
----------------------------
This projects is a set of firmware for playing second and third generation gaming platform and to be runs on [esplay-micro-hardware], an ESP32 Devices with WROVER Module (4MB PSRAM) which you could find the details on my [hackaday] page. This hardware also commercially available on the [Makerfabs] Online Store. Due to small Flash ROM (only 4MB) currently only 3 game emulator could be bundled altough this device support 7 emulator including Atari, PC Engine, ZX-Spectrum, MSX, etc.
The main feature of this projects is bundled as follow:
- Nofrendo NES Emulator for play Nintendo ROM
- GNUBoy for play GameBoy and GameBoy Color
- SMSPlusGX could play Sega Master System, Game Gear and Coleco Vision ROM
- In-Game menu on Emulator
- NEW! Built-in Audio Player for playing music, support WAV, MP3, OGG, and FLAC audio files.
- Esplay launcher, new code base using UGUI library
Place your Audio files that supported (mp3, flac, wav and ogg) to audio folder on the root of sdcard, if folder not exist just created one and place audio files on them.
Launcher Option
---------------
Now you have options to choose launcher, Retro-ESP32 launcher by [32teeth] or ESPlay launcher by me.
ESPlay Launcher has Wifi AP options so you can upload rom by using web interface via phone or your computer.
Here spoiler Retro-ESP32 launcher running on [esplay-micro-hardware]
Compiling
---------
This code is an esp-idf project. You will need esp-idf to compile it. Newer versions of esp-idf may introduce incompatibilities with this code;
for your reference, the code was tested against release/v3.3 branch of esp-idf.
edit mkrelease.sh with correct location for your mkfw.
Find mkfw tool in the base firmware in my repository.
Also to get compiling correctly you need ffmpeg installed on your system and included in the PATH Environment.
edit mkrelease.sh to match your setup path(to match your location installation of esp-idf and clone of this repo). and simply execute mkrelease.sh
then you'll find esplay-retro-emu.fw in the root of repo.
run mkrelease.sh to compile and make an .fw file that could be flashed by base firmware bootloader. Place .fw file in esplay/firmware folder on sdcard, power on esplay device while press B button until bootloader screen appear. select .fw then A -> Start to flash firmware.
Base firmware is a modified bootloader fork from odroid-go.
ROM
---
Extract skeleton.zip from docs, and copy to the root of sdcard. Please provide ROM by yourself and place them in the appropriate folder on sdcard.
DONATION
--------
The software are free to use but we also accept small donation to make the project lives and continue development
Source Author and Special Thanks
-------------------------
- Audio Player based on [ogo-shell] projects by [Passpartout], thank you very much for sharing awesome code.
- All emulator based on [Go-Play] for Odroid-go by [OtherCrashOverride].
All Contributors
------------
Thanks to contribute your work for this project.
- [32teeth]
[32teeth]:https://github.com/32teeth
[ogo-shell]:https://github.com/Paspartout/ogo-shell
[Paspartout]:https://github.com/Paspartout
[OtherCrashOverride]:https://github.com/OtherCrashOverride
[Go-Play]:https://github.com/OtherCrashOverride/go-play
[esplay-micro-hardware]: https://github.com/pebri86/esplay_micro_hardware
[Makerfabs]: https://www.makerfabs.com/esplay-micro.html
[hackaday]: https://hackaday.io/project/166707-esplay-micro