Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Platform:Neo Geo Pocket

From ReverseEngineering.wiki
Platform
Developer SNK
Versions Neo Geo Pocket (1998), Neo Geo Pocket Color (1999)
Endianness little
On this wiki Facts · Code · Notes · Topics

SNK's 1998 handheld (Neo Geo Pocket, Pocket Color 1999): a Toshiba TLCS-900/H main CPU, a Zilog Z80 sound CPU with a T6W28 PSG, 12 KiB RAM, flash cartridges mapped at 0x200000 and a BIOS at 0xFF0000.

Overview

  • CPU: Toshiba TLCS-900/H 16/32-bit main CPU (Beetle NGP mednafen/ngp/TLCS-900h), little endian; a Z80 handles sound (Z80_interface.c) with the T6W28 sound chip (T6W28_Apu.cpp).
  • Cartridge: flash ROM, see Format:Neo Geo Pocket ROM image.

Memory map (TLCS-900 view)

From mednafen/ngp/mem.h and mem.c:

Range Contents
0x004000-0x006FFF work RAM; the BIOS-maintained system area is at 0x006F80-0x006FFF (battery, power-on state, language, colour mode copy at 0x6F91 and 0x6F95)
0x008000-0x00BFFF video registers and VRAM windows
0x200000-0x3FFFFF cartridge ROM (low chip)
0x800000-0x9FFFFF cartridge ROM (high chip)
0xFF0000-0xFFFFFF BIOS ROM

The Beetle core high-level-emulates BIOS calls (biosHLE.c) when no BIOS image is available, so the BIOS entry vector table at 0xFF0000 and up is what games call. The 0x8000-0xBFFF window is the K2GE video chip: mem.c forwards every access in that range to ngpgfx_read8/ngpgfx_write8, and gfx.c (commit a50d5ac288) decodes it as colour palette RAM at 0x8200-0x83FF, sprite VRAM at 0x8800-0x88FF, sprite palette indices at 0x8C00-0x8C3F, the two scroll planes' tile map (ScrollVRAM) at 0x9000-0x9FFF and character (tile pattern) RAM at 0xA000-0xBFFF; the registers (0x8000 interrupt control, 0x8006 frame rate, 0x8012, 0x8020 and up window and scroll, 0x8118 background colour and others) sit in between. Note that 0xA000 is character RAM, not a sprite or scroll plane.

Related

Platform:WonderSwan, Platform:Game Boy.

Code & repositories

  • https://github.com/libretro/beetle-ngp-libretro @ a50d5ac288a81f2104ddf43195a4efdd15c72227 · license: GPL-2.0 (declared by the contributor; GitHub's detector did not recognize COPYING)
    Mednafen Neo Geo Pocket core: RomHeader struct, memory map, BIOS HLE
    Tested on: source read, not run: read the source, not built · checked 2026-10-18