Galagino V3.2 software can be uploaded on V2.0 hardware without any modification.

Video tutorial for build a new Galagino V3.0: https://youtu.be/Nz3LRrY3Ukw

To build a joystick follow Galagino V2.0 video: https://youtu.be/YmvyNwJLqJM

ported from speckholier platformio to Arduino IDE - with 8 additional games: https://github.com/speckhoiler/galagino This repo is a port of Till Harbaum's awesome Galaga emulator ported to platformio. This port is NOT by the original author, so please do not bother him with issues.

• Joystick 4 posizioni/4 way joystick type15: https://s.click.aliexpress.com/e/_c3Qgeoth
• PCF8574P: https://s.click.aliexpress.com/e/_oDPPZgo
• Modulo LVGL 2.4" ESP32-2432S024: https://s.click.aliexpress.com/e/_DECY96V
• Connettori JST 1.25MM, 10Cm, 2P/Connector 2P: https://s.click.aliexpress.com/e/_DBzkKsz
• Connettori JST 1.25MM, 10Cm, 4P/Connector 4P: https://s.click.aliexpress.com/e/_DF72N8Z
• Batteria al Litio 3.7V 2000mA/lythium battery: https://s.click.aliexpress.com/e/_c3S7Fg07 oppure https://amzn.to/4b0yBZs
• Altoparlante 3070/Speaker: https://s.click.aliexpress.com/e/_c4NQslWX oppure https://amzn.to/48bumpJ
• Display OLED SD1306 0.91" : https://s.click.aliexpress.com/e/_c4DUrL47
• Pulsanti 6x6x10 type 4 /PushButton: https://s.click.aliexpress.com/e/_c4eKUiJH
• Resistenze SMD 4.7K 0805/Resistors: https://s.click.aliexpress.com/e/_DdHzrWd
• Presa USB-C / Pmnt USB type C: https://s.click.aliexpress.com/e/_c4nfNYSV
• Mini controller BT: https://s.click.aliexpress.com/e/_c2JYkcQF

Like in the original from Till Harbaum's Galaga emulator, download these files:

• The Galagino specific code contained in this repository
• A Z80 software emulation by Marat Fayzullin
• The original ROM files
  • Galaga (Namco Rev. B ROM)
  • Pac-Man (Midway)
  • Donkey Kong (US set 1)
  • Frogger
  • Digdug
  • 1942
  • Lizard Wizard
  • Eyes
  • Mr. TNT
  • The Glob (Important: filename with "p")
  • Crush Roller
  • Anteater
  • BombJack
  • MrDo
  • Lady Bug
  • Gyrrus
  • Time Pilot
  • Galaxian
  • MsPacman
  • SpaceInvaders
  • Thuthankam

Due to memory limitations, not all games can be enabled. Edit the config.h file to select which games to enable. At least two must always be disabled; otherwise, they won’t fit in the ESP32’s memory. By default, Gyruss and Tutankham are disabled; they are still emulated but run too slowly to be playable.

Galagino uses code that is not freely available and thus not included in this repository. Preparing the firmware thus consists of a few additional steps:

• If you do not have Python installed, download it from here. Python 3.13.0
• The ROM ZIP files have to be placed in the romszip directory, together with the ZIP file containing the Z80 emulator.
• A set of python scripts is then being used to convert and patch the ROM data and emulator code and to include the resulting code into the galagino machines directory. For all games, just use conv__all.bat.

The ROM conversion create a whole bunch of additional files in the source directory. Please check the README in the romconv directory for further instructions. Please ensure that the stripts run without errors!

• Open src.INO with Arduino IDE
• Add this url in your arduino ide board source preferences: https://raw.githubusercontent.com/ricardoquesada/esp32-arduino-lib-builder/master/bluepad32_files/package_esp32_bluepad32_index.json
• then add a ESP32 bluepad board
• select board "ESP 32 DEV module" family:esp32_bluepad32
• Use huge partition
• Enable PSRAM

• Joystick UP/DOWN to select game
• Any key to enter in the selected game.
• COIN key to add coins
• START key to start game or flight loop in 1945 game
• FIRE key to of a fire in game the uses fire/action
• COIN + UP/DOWN to setup volume
• COIN pressed for 10 second to enable/disable BT
• START for 5 seconds to exit game and return to selection menu
• FIRE during boot to access configuration menu

In Attract mode, the machine cycles through all games if you do not touch the joystick. The games end after 5 minutes.

V3.0 1/2/2026

• Conversion from speckhoiler VsCode version to Arduino Ide by Paolo Sambinello
• Adding a Bluethoot Controller support, by Paolo Sambinello
• Adding a Bluethooot enabler/disabler and increase lives to 5 by Marco Prunca
• Adding a COIN animation by Marco Prunca

V3.1 11/3/2026

• Added Lady Bug by Paolo Sambinello and Davide Gatti
• Added Gyrruss by Paolo Sambinello and Marco Prunca (Playable but with reducete audio features AY3-8910 #3 emulated instead of #5)
• Added MsPacman by Marco Prunca (work 100%)
• Added Pengo by Spek Hoiler and Paolo Sambinello and Marco Prunca
• Added Time Pilot by Marco Prunca
• Added Bagman By Spek Hoiler
• Added SpaceInvaders by Marco Prunca
• Detect automaticallu PCF8574 / PCF8574A
• Added Name list at boot
• Fixed conditional compile to allow remove/add games without problems

V3.2 26/4/2026

• Added QR code by Paolo Sambinello
• Added Configuration Menu by Paolo Sambinello
• Fixed insert coin animation by Marco Prunca
• Added Galaxian game by Marco Prunca (minor audio problems)
• Fixed Time Pilot game by Marco Prunca (minor glitch on clouds graphichs)
• Added Tutankham game by Marco Prunca (not playable at full speed)