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:Virtual Boy

From ReverseEngineering.wiki
Platform
Developer Nintendo
Versions Virtual Boy (1995, JP/NA)
Endianness little
On this wiki Facts · Code · Notes · Topics

Nintendo's 1995 stereoscopic console: an NEC V810 32-bit RISC CPU at 20 MHz, the VIP video chip (two 384x224 red LED displays), the VSU 6-channel sound unit, 64 KiB of work RAM and a cartridge with ROM at 0x07000000 and optional RAM at 0x06000000.

Overview

  • CPU: NEC V810, 32-bit RISC, little endian, reset at PC 0xFFFFFFF0 (Beetle VB mednafen/hw_cpu/v810/v810_cpu.cpp). The clock is 20 MHz: VB_MASTER_CLOCK is 20000000.0 in mednafen/vb/vb.h, and the VSU is fed with the CPU timestamp shifted right by 2 (libretro.cpp, commit d5ae54c8e2).
  • Address bus: 27 bits are decoded; the 32-bit address is reduced with A &= (1 << 27) - 1 and the top 3 bits of those 27 (address bits 26-24) select the device.

Memory map

Beetle VB (libretro.cpp, MemRead8/MemWrite8, switch on A >> 24 after the mask):

Region Contents
0x00000000-0x00FFFFFF VIP: video RAM, registers
0x01000000-0x01FFFFFF VSU sound registers (the sound unit; MemWrite8 passes writes to VSU_Write, while MemRead8 returns 0 for this region)
0x02000000-0x02FFFFFF hardware control (game pad, timer, link: HWCTRL)
0x04000000-0x04FFFFFF expansion port, unused here
0x05000000-0x05FFFFFF work RAM, 64 KiB mirrored (A & 0xFFFF)
0x06000000-0x06FFFFFF cartridge RAM (save RAM)
0x07000000-0x07FFFFFF cartridge ROM

The cartridge ROM is documented on Format:Virtual Boy ROM image.

Related

Platform:Game Boy (Nintendo's other 1990s monochrome system), Platform:Super Nintendo Entertainment System.

Code & repositories

  • https://github.com/libretro/beetle-vb-libretro @ d5ae54c8e23b573a3b34e888b2d48a588027e92c · license: GPL-2.0 (declared by the contributor; GitHub's detector did not recognize COPYING)
    Mednafen Virtual Boy core: V810 CPU, bus decode, ROM/RAM mapping
    Tested on: source read, not run: read the source, not built · checked 2026-10-18