An emulator for the Koei PasoGo (1996), the handheld Go machine: a Vadem VG230 "PC on a chip" with a 320x240 LCD, a d-pad, two buttons, and cartridges that carry their own BIOS, a small DOS and a FAT disk.
pasogo-emu is not affiliated with Koei. The name is used only to say which console this emulates.
First session (2026-11-06):
- The console worked out from its cartridges and from Vadem's register manual: the BIOS lives on each cartridge, the rest of the ROM is a FAT12 disk KOEI-OS runs a DOS program from. See docs/HARDWARE.md.
- The NEC V30 (with NEC's own instructions) and the VG230 (memory mapping, 8259, 8254, the keypad scanner, the LCD controller, the RTC and its CMOS RAM, the power manager's registers, the buzzer) are written for this project, in C.
- The three cartridges dumped so far reach their menus and play: Tsuyoku Naru Tesuji's problems (a right answer is taken, a wrong one turned down), Igo Meikyokushuu's game records, Denshi Goban's board (its records kept in the SRAM across runs).
- A window with the buzzer, the keyboard and game controllers; the SRAM kept beside the cartridge, the console's clock across runs. The buzzer's pitch is matched by ear to a recording of a real console.
This repository contains no cartridge data and never will. A PasoGo dump is the mask ROM as it
is (512 KB or 1 MB, the ks-10xx.ic4 of the MAME software list), alone or in a zip. No BIOS is
needed: the cartridge has it.
Windows builds are on the Releases page.
tools/package_release.sh makes them: dist/pasogo-emu-<version>-win64.zip (a clean Release
build, pasogo-emu.exe, pasogo-cli.exe, SDL2.dll, the README and the licences).
MSYS2 MinGW 64-bit with mingw-w64-x86_64-gcc, mingw-w64-x86_64-cmake,
mingw-w64-x86_64-ninja and mingw-w64-x86_64-SDL2:
cmake -S . -B build -G Ninja
cmake --build build
Without SDL2 only the headless runner, pasogo-cli, is built.
build/pasogo-emu CART.ic4, or drop a cartridge on its window. A zip of cartridges works too:
the first is loaded, PageUp and PageDown go through the others. --scale N sets the window size.
On the cartridges that have it, the SRAM is kept as NAME.sav beside the cartridge, NAME being
the cartridge file's name (for one in a zip: the file's inside the zip, as ks-1009.sav, beside
the zip). The console's clock and its CMOS RAM are kept as pasogo.rtc beside the program.
| PasoGo | Keyboard | Controller |
|---|---|---|
| Pad | arrows | d-pad, left stick |
| A (○, confirm) | Z, Enter | A |
| B (×, cancel) | X, Backspace, Esc | B |
F2 resets (power off and on), P pauses, F11 is full screen, F12 saves a screenshot. F5 and F6 move
the buzzer a semitone down or up (--buzzer HZ sets it; A#7, 3729 Hz, is the default, matched
by ear to a real console), F7 plays a beep to compare.
pasogo-cli CART [--frames N] [--png OUT.png] [--shots EVERY PREFIX] [--keys FRAME:MASK ...]
[--log FILE] [--io] [--trace FILE] [--trace-from FRAME] [--ram FILE] [--sram on|off]
[--wav FILE]
It runs a cartridge for N frames with scripted buttons (tools/script.py writes the --keys),
and keeps pictures, a log of anything the emulator does not know (--io: every port access), an
instruction trace, the RAM or the sound. tools/vram.py draws the display memory from a RAM dump.
MIT (LICENSE). See THIRD_PARTY_NOTICES.md for the sources.