Repository navigation
Releases
Nintendo DS 0.5.3
Fourth release of the Nintendo DS core for Analogue Pocket: a data-cache bug that could make 3D disappear is fixed, the ARM9 runs code faster, and DMA timing is closer to the DS's.
Fixed
- 3D models or a whole playfield could disappear after the game updated them in memory. The ARM9's data cache wrote a full cache line back to memory and could overwrite data the game had just changed there. It now writes back half a line at a time, as measured on a real DS.
- 3D lines that were already drawn are no longer shown late. The display now reads the 3D line buffer before the 3D engine writes its next line, as on the DS.
- Code-heavy scenes run faster. The ARM9 now caches the BIOS's code, which games call often, and its instruction cache is 4-way, as on the DS. Scenes that slowed down because the CPU kept refetching code now keep full speed.
- Games that send 3D geometry to the 3D engine by DMA no longer flicker or stutter. While the ARM9 waited on the geometry engine, it held the bus and the DMA stalled; it now lets the DMA through.
- Screens that change their scroll or layout per line with HBlank DMA no longer jump. The HBlank DMA now starts after the line's background reads, as on the DS, so each line uses the values meant for it.
- Sound gets its memory reads ahead of DMA and the CPUs, as on the DS, so a long DMA copy can no longer starve it.
- DMA copies out of video memory read ahead, so effects that copy the screen keep pace.
- DMA copies within main memory and DMA writes to I/O registers take the time a DS takes.
- Touch-mode swipe gestures are twice as fast: a swipe now covers its 96 pixels in 6 frames instead of 12.
- Square roots of very large 64-bit numbers are exact, as on a real DS. The core used to round some of them up. (Jello)
- Cartridge memory requests are held until they are acknowledged. (Jello)
- The clock handles 12-hour mode and invalid dates and times as a real DS does, measured on one. (after Jello's fix)
Known issues
- Some 3D effects are still switched off to fit the chip: shadow polygons, toon and highlight shading, fog, edge marking, anti-aliasing and the 2D mosaic.
- Line glitches: the busiest 3D scenes can draw too slowly, which shows as grey, black or missing lines.
- The heaviest 3D scenes can run below full speed.
- A short stutter can remain when a game loads a lot of new data at once.
Thanks to Jello for the square-root, cartridge and clock fixes, a test fix, and the math and clock test programs, which were run on a real DS for this release.
Install: unzip the zip to the root of your SD card. Add your own bios9.bin, bios7.bin and firmware.bin to Assets/nds/common/, with your .nds games. Quit through the Pocket menu before turning it off, or the save made since the game started is lost. Setup steps are in the README.
GuardianSoul.NintendoDS_0.5.3_2026-11-14_source.tar.gz is the complete source this bitstream was built from, with the build command in BUILD-INFO.txt. The core is GPL-3.0-or-later; see LICENSE and THIRD_PARTY_NOTICES.md.
Nintendo DS 0.5.2
Third release of the Nintendo DS core for Analogue Pocket: 3D accuracy fixes, correct textures on tall 3D shapes, and exact screen-swap timing.
Fixed
- Textures on tall 3D shapes are now drawn with the DS's exact perspective rule, measured on a real DS. This removes stretched or misplaced texture corners.
- When many polygons covered the same line, the core could stall and show only the background; it now draws the scene as the DS does. Although this doesn't fix the line issues.
- Swapping the screens mid-frame now takes effect on the exact line, as on the DS, so games that switch screens during a frame no longer flicker or show the wrong picture.
- DMA copies from video memory to main memory are faster, and palette and OAM writes finish sooner.
- 4x4-compressed textures use the DS's palette address.
- The 3D geometry commands take the time a DS takes, as measured on a real DS.
Known issues
- Some 3D effects are still switched off to fit the chip: shadow polygons, toon and highlight shading, fog, edge marking, anti-aliasing and the 2D mosaic.
- The busiest 3D scenes can draw too slowly, which shows as missing lines or flickering.
- The heaviest 3D scenes can run below full speed.
- A short stutter can remain when a game loads a lot of new data at once.
Install: unzip the zip to the root of your SD card. Add your own bios9.bin, bios7.bin and firmware.bin to Assets/nds/common/, with your .nds games. Quit through the Pocket menu before turning it off, or the save made since the game started is lost. Setup steps are in the README.
GuardianSoul.NintendoDS_0.5.2_2026-11-08_source.tar.gz is the complete source this bitstream was built from, with the build command in BUILD-INFO.txt. The core is GPL-3.0-or-later; see LICENSE and THIRD_PARTY_NOTICES.md.
Nintendo DS 0.5.1
Second release of the Nintendo DS core for Analogue Pocket: faster heavy 3D scenes, smoother streaming from the SD card, save fixes and touch gestures.
New
- Touch gestures: in touch mode, each of A, B, X and Y can be set in Core Settings ("Touch: A Button" and so on) to a normal touch, a circle, a big circle, or a swipe up, down, left or right from the cursor. The cursor shows each gesture as it runs.
- The touch settings are grouped under "Touch:" in Core Settings, including "Touch: Cursor Speed".
Fixed
- Saves: the core now knows the save chip type of every game, not only a short list, so games that showed write errors or lost their save now keep it (issues #1 and #2).
- Streaming from the SD card: the core now reads ahead while a game streams data, which removes most slowdowns and crackling music when a game loads new areas or plays streamed audio.
- Heavy 3D scenes run faster.
- 3D no longer shows on the wrong screen when a 3D frame comes in late, and stray lines in busy 3D scenes are reduced.
- Missing lines on the bottom screen in some 2D scenes, caused by memory timing on the Pocket.
- Games that check the cartridge chip ID for DSi-enhanced carts now boot.
- Timer interrupts follow the DS's exact timing.
Known issues
- Some 3D effects are still switched off to fit the chip: shadow polygons, toon and highlight shading, fog, edge marking, anti-aliasing and the 2D mosaic.
- The heaviest 3D scenes can still run a little below full speed.
- Some busy 3D scenes show black lines, and some models show glitching vertices.
- A short stutter can remain when a game loads a lot of new data at once.
Install: unzip the zip to the root of your SD card. Add your own bios9.bin, bios7.bin and firmware.bin to Assets/nds/common/, with your .nds games. Quit through the Pocket menu before turning it off, or the save made since the game started is lost. Setup steps are in the README.
GuardianSoul.NintendoDS_0.5.1_2026-11-06_source.tar.gz is the complete source this bitstream was built from, with the build command in BUILD-INFO.txt. The core is GPL-3.0-or-later; see LICENSE and THIRD_PARTY_NOTICES.md.
Nintendo DS 0.5.0
First public release of the Nintendo DS core for Analogue Pocket: an experimental core, written from scratch against measurements of a real DS.
What works
- Super Mario 64 DS, Mario Kart DS, New Super Mario Bros., Pokémon HeartGold / SoulSilver, Animal Crossing: Wild World and Kingdom Hearts 358/2 Days play on a Pocket, with 3D, sound and saves.
- Saves (EEPROM and FLASH) are kept per game in
Saves/nds/common/as raw.savfiles, compatible with melonDS and flashcarts. - Screen layouts (both screens, top only, bottom only) and screen rotation for games held like a book.
- Touch through a cursor: Select + A/B/X/Y turns touch mode on, the D-Pad moves the cursor and A touches. In the Dock, an analog controller's right stick moves the cursor.
Known issues
- Some 3D effects are switched off to fit the chip: shadow polygons, toon and highlight shading, fog, edge marking, anti-aliasing and the 2D mosaic.
- Heavy 3D scenes can run below full speed: Kingdom Hearts 358/2 Days heavy scenes with several enemies run at about 50–60%, and Pokémon Black 2 / White 2 slow down walking through cities.
- Pokémon Black 2 / White 2: the title screen runs slow, sound included, and part of its bottom screen isn't shown; in cities, tree vertices glitch while you walk.
- Golden Sun: Dark Dawn's title screen bounces up and down; Mario & Luigi: Partners in Time's title logo line flickers.
- Busy 3D scenes can show missing or wrong lines.
Install: unzip the zip to the root of your SD card. Add your own bios9.bin, bios7.bin and firmware.bin to Assets/nds/common/, with your .nds games. Quit through the Pocket menu before turning it off, or the save made since the game started is lost. Setup steps are in the README.
GuardianSoul.NintendoDS_0.5.0_2026-11-06_source.tar.gz is the complete source this bitstream was built from, with the build command in BUILD-INFO.txt. The core is GPL-3.0-or-later; see LICENSE and THIRD_PARTY_NOTICES.md.