Format:Virtual Boy ROM image
| Extensions | .vb, .vboy |
|---|---|
| Endianness | little |
| On this wiki | Facts · Code · Notes · Topics |
Raw cartridge dump of the Nintendo Virtual Boy (.vb, .vboy): a power-of-two sized ROM (256 bytes to 16 MiB) mapped at 0x07000000, with the game header in the last 544 bytes, the reset code at the very end and the NEC V810 reset vector at 0xFFFFFFF0.
Image and mapping
The file is the cartridge ROM only. Beetle VB (libretro.cpp, Load) accepts files whose size is a power of two, at least 256 bytes and at most 16 MiB (1 << 24); it maps the ROM into the 0x07000000 region (the CPU address space repeats every 128 MiB, A &= (1 << 27) - 1), and ROMs smaller than 64 KiB are mirrored up to 64 KiB. Because the last bytes of the 16 MiB window hold the reset vector (CPU reset address 0xFFFFFFF0 in v810_cpu.cpp) and the header, a ROM smaller than 16 MiB repeats so that its end appears at the end of the window.
Header
The header is at the end of the ROM, at CPU address 0xFFFFFDE0 (ROM offset size - 0x220). Unverified: layout from the Virtual Boy documentation (Sacred Tech Scroll), not read in code here.
| ROM offset from header | Size | Field |
|---|---|---|
| +0x00 | 20 | game title (ASCII or Shift-JIS) |
| +0x14 | 5 | reserved |
| +0x19 | 2 | maker code (ASCII) |
| +0x1B | 4 | game code |
| +0x1F | 1 | version |
Beetle VB declares the same field set in struct VB_HeaderInfo (title, game_code u32, manf_code u16, version u8) but the parsing is absent in the libretro port; Virtual Boy emulators otherwise do not check the header.
Vectors
Unverified: interrupt and exception vectors (game pad, timer, game pak, link, VIP, FPU, illegal opcode, address trap) live at fixed addresses 0xFFFFFE00-0xFFFFFFF0 inside the last 512 bytes of the ROM.
Related
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