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:Atari Lynx

From ReverseEngineering.wiki
Platform
Developer Epyx, Atari
Versions Atari Lynx (1989), Lynx II (1991)
Endianness little
On this wiki Facts · Code · Notes · Topics

Atari's 1989 colour handheld (designed as Epyx Handy): a WDC 65C02 at 4 MHz with 64 KiB of RAM and two custom chips, Mikey (video, timers, UART, audio) and Suzy (sprite engine, math, cartridge access, input), and a 512-byte boot ROM.

Overview

  • CPU: 65C02 (Handy core mednafen/lynx/c65c02.cpp in Beetle Lynx). Clock 4 MHz: Beetle Lynx defines HANDY_SYSTEM_FREQ as 16000000 (mednafen/lynx/system.h) and runs the sound buffer at 16000000 / 4 with the audio timestamp shifted right by 2 (system.cpp), so the CPU-side clock is the 16 MHz system clock divided by 4 (commit fcdefcfb3c). The emulator charges 5 system ticks per CPU read/write cycle (CPU_RDWR_CYC in machine.h), so its effective bus rate is a little lower than 4 MHz.
  • Memory: the CPU sees 64 KiB, all of it RAM except overlays at the top (below).
  • Chips: Suzy (sprites, maths coprocessor, joypad, cartridge read registers) at 0xFC00; Mikey (display DMA, 4 timers, 4 audio channels, UART, palette) at 0xFD00.
  • Cartridge: read through Suzy, see Format:Atari Lynx LNX file.

Memory map

From Handy's memory-map class (memmap.cpp) and rom.h:

Range Contents
0x0000-0xFBFF RAM
0xFC00-0xFCFF Suzy registers (RAM when hidden)
0xFD00-0xFDFF Mikey registers (RAM when hidden)
0xFE00-0xFFF7 boot ROM, 0x200 bytes of which 8 are hidden at the top (BROM_SIZE 0x200)
0xFFF8 RAM (reserved)
0xFFF9 MAPCTL, the memory map control register
0xFFFA-0xFFFF vectors (ROM overlay, RAM when hidden)

MAPCTL (0xFFF9): bit 0 set hides Suzy, bit 1 set hides Mikey, bit 2 set hides the boot ROM, bit 3 set hides the vectors; hidden areas show RAM (CMemMap::Poke). Programs normally write MAPCTL early to switch the ROM out.

Related

Platform:Nintendo Entertainment System and Platform:Game Boy (contemporary 6502-family and Z80-family consoles).

Code & repositories

  • https://github.com/libretro/beetle-lynx-libretro @ fcdefcfb3c11d6d2e71be076a5d3df2e88ab73ed · license: GPL-2.0 (declared by the contributor; GitHub's detector did not recognize COPYING)
    Mednafen Lynx core (Handy-derived): LNX header decoding, memory map and MAPCTL
    Tested on: source read, not run: read the source, not built · checked 2026-10-18