This is a port of https://github.com/zid/gameboy to the Espressif ESP32 chip. and this project based on Arduino, and the SPI LCD the low speed. This project is used for self educational purposes and there are a couple of better repos. For example:
- Espeon(https://github.com/Ryuzaki-MrL/Espeon) used for M5STACK.
- ODROID-GO(https://github.com/hardkernel/ODROID-GO) using ESP32-WROVER MCU
You will need:
- A board containg an ESP32 chip and at least 4MB (32Mbit) of SPI flash, plus the tools to program it.
- A backup of a GameBoy ROM game cartridge (optional)
- A 320x240 ILI9341 display, controllable by a 4-wire SPI interface. You can find modules with this LCD by looking for '2.2 inch SPI 320 240 ILI9341' on eBay or other shopping sites.
- 8 GPIO buttons and 8 pull resistors
- SD card module (optional)
| LCD Pin | GPIO |
|---|---|
| MISO | 19 |
| MOSI | 23 |
| CLK | 18 |
| CS | 5 |
| DC | 21 |
| RST | 25 |
| BCKL | 22 |
(BCKL = backlight enable, could be also marked as LED on module board)
(Make sure to also wire up the backlight and power pins.)
All buttons are attached to MCU board GPIO pins with pull-up registers. i.e. VCC(3.3 V) is connected to GPIO through resistor, switch is attached to GPIO and GND:
VCC(+3.3 V) GND
| |
| |
<10 k> / (switch)
| /
| |
+-----+----+
|
GPIO
| Button | GPIO |
|---|---|
| up | 17 |
| down | 27 |
| left | 4 |
| righ | 26 |
| start | 35 |
| select | 15 |
| A | 33 |
| B | 32 |
| SD Pin | GPIO |
|---|---|
| MISO | 12 |
| MOSI | 13 |
| CS | 16 |
| CLK | 14 |
- Download GB ROM you want (or leave everything as-is with example ROM and go to step 3)
- Run
python3 ./bin2h.py -b <path to your GD ROM you downloaded> -c gbrom.h -v gb_rom - Compile and upload esp32-gameboy.ino firmware
By default, installed game is minesweeper: https://danirod.itch.io/minesweeper-gb Source code: https://github.com/danirod-live/minesweeper-gb