Repository navigation
Games and Hardware Details
Retail games that break, sometimes in subtle ways, when one specific hardware detail is off. These make good test cases for emulators. Details of each behavior are on the DS, DSi and CPU pages.
| Game | What goes wrong | What it depends on |
|---|---|---|
| Tokyo Beat Down | Cutscene backgrounds flash black now and then | The ARM9's code cache cost, in DS mode (fa8b161) |
| KORG M01 | Song screen's step numbers, cursor and LOOP light blink every other frame | ITCM code at full speed (9faa6d2) |
| DSi Sound | White screen at startup | ARM9 code cache cost and ARM7 at full speed outside main RAM (b063825) |
| Flipnote Studio | White screen when exiting | ARM7 BIOS at full speed (4dabf21) |
| Spirit Tracks | Title shows 40 frames late | Geometry commands starting as soon as they're complete (3700ca5) |
Tokyo Beat Down draws each 30 fps 3D frame in two halves: the backdrop, then the rest with SWAP_BUFFERS (from
0x02070A80). Code at 0x02036950 switches halves only when the SDK's V-blank count at 0x027FFC3C, modulo 12, has changed.
The ARM7 bumps that count in its V-blank IRQ (0x037FB768). When the ARM7's Timer 1 alarm IRQ runs over V-blank (about
3,000 cycles), the bump comes late. An ARM9 that fetches code for free reads the count about 1,580 cycles after V-blank,
sees the old value, skips the backdrop and swaps a frame early. With the code cache cost, that path takes about 6,500
cycles and the race goes away. A real DSi showed no flashing.
KORG M01 hides all of OAM and then refills it every frame. Its synth thread runs from ITCM and preempts the refill. If ITCM code is counted at half speed, as the rest of the ARM9 is in an emulator that doesn't charge load waits, the refill doesn't finish before the bottom screen's first line is drawn.
| Game | What goes wrong | What it depends on |
|---|---|---|
| Dragon Ball Kai Ultimate Butouden, Dragon Ball Origins 2 | Bands at the top of both screens | GXSTAT bit 27 busy until the swap (8b7f79d) |
| Mario Kart DS | Freezes at its first 3D screen, polling 0x02173208 | GXFIFO IRQ as a level (adc8678) |
| Dragon Ball Origins 2 | Title screen reads GXSTAT about 40,000 times a frame | Not a bug, but a cost: an emulator that reads I/O slowly loses frames here (0b4d2e7) |
For split-screen and flicker bugs like the Dragon Ball ones, it helps to log display register writes with VCOUNT. Buffer swaps should land at line 192. Then look at what the game polls just before. Our first guess, ARM9 speed, was wrong: it was a wait that ended too early.
| Game | What goes wrong | What it depends on |
|---|---|---|
| Plants vs. Zombies | Tombstone text, "Tap here to change save block" and "Achievements" missing |
CLEAR_DEPTH starting at 0x7FFF (882a49e) |
| Mario Kart DS, Rainbow Road | Road disappears into the fog | Translucent polygons that write depth set the fog depth (c06853e) |
| Mario Kart DS | Name tags fogged over the sky | Fog flag ANDed for translucent pixels (5889e00) |
| Mario Kart DS | Darker rectangle inside kart shadows | Each shadow pixel drawn once per ID (d60e811) |
| Phantom Hourglass | Link's shadow cut and blinking | Equal depth test margin (a4ed320) |
| Phantom Hourglass, boat intro | Water blinks on a TV | Real: captured frames are one 6-bit step darker than live 3D |
| Spirit Tracks, first tunnel | Line along the ground | Real, but dim: the T-junction slit with anti-aliasing (7fbda5b) |
| Pokémon Pearl | Dotted stripes on the ground | Edge pixels drawn fully with AA or edge marking on (cba0f94) |
| Pokémon Black 2, intro | Black slits in Professor Juniper's coat | Whole-pixel span ends (eeb7a93) |
| Ultimate Mortal Kombat, at high res | Lines in fight backgrounds | Native pixel-corner sampling against texture atlases (a480645) |
Some games also have patterns that are hard on an emulator's texture cache:
- Castlevania: Dawn of Sorrow's forest maps texture palette bank G to LCDC and back every V-blank (VRAMCNT_G 83 -> 80 -> 83, lines 192-198), and really changes palettes at 0x2000, 0x2020, 0x2040 and 0x2240 each time.
- Ultimate Mortal Kombat's character select swaps banks A and B every frame. Its grid is 60 quads from one 512x512 8-bit texture with about 25 palettes, whose texels never change.
- Order of Ecclesia re-maps about 20 textures a frame.
- Mario Kart DS changes texture mappings in only 12 of 3,000 race frames.
| Game | What goes wrong | What it depends on |
|---|---|---|
| Spirit Tracks | "Could not be written" error | 1 MB FLASH, marker at 0xF4E00 (93cf79a) |
| The Simpsons Game | Can't access its save | EEPROM 0.5 KB detected from a 1-byte-address read (e784480) |
| WarioWare: D.I.Y., Jam with the Band | No saves | NAND saves on the ROM chip (73ce9c1) |
| Pokémon Black, Black 2 | Not shown in the DSi menu | Chip ID matching the ROM size (a4b47f3) |
| Mario Kart DS, Phantom Hourglass, Chinatown Wars | Blank screens in DSi mode | 4 MB main RAM for DS titles (e16659e) |
- Metal Slug 7 runs its game logic at 30 updates a second. During the soldiers' drop-in, the ARM9 is idle only about 10% of scanlines, with the work spread over many functions, so the game drops to about 15 updates a second while the frame rate stays at 60. This is likely the same on hardware (Unverified).
- Pokémon Black 2 in DSi mode spends a large share of its Press Start screen in BIOS HMAC-SHA1. Its town flyby wakes the idle thread about 3 times as often at 133 MHz as at 67 MHz.
- New Super Mario Bros.' intro draws BG2 and BG3 as extended affine backgrounds with the identity matrix on engine A the whole time, and Mario, Peach and the rest as 3D models of mostly compressed textures, 700-1,900 polygons a frame.