NitroSwan DS

NitroSwan DS
General
Author	Fredrik Ahlström (FluBBa)
Type	Handheld
Version	0.5.0
License	Mixed
Last Updated	2023/03/01
Links
Download
Website
Source

This is a Bandai WonderSwan (Color/Crystal) & PocketChallenge V2 emulator for the Nintendo DS.

Installation

Create a folder named nitroswan in either the root of your flash card or in the data folder. This is where the settings and save files are stored.

Next put your games and bios files into a folder (stub version for the bootrom will be used if that is not found).

Depending on your flashcart you might have to DLDI patch the emulator.

The save files should be compatible with most other WonderSwan emulators.

User guide

Menu

File:

• Load Game - Select a game to load.
• Load State - Load a previously saved state of the currently running game.
• Save State - Save a state of the currently running game.
• Load NVRAM - Load non volatile ram (EEPROM/SRAM) for the currently game.
• Save NVRAM - Save non volatile ram (EEPROM/SRAM) for the currently game.
• Save Settings - Save the current settings (and internal EEPROM).
• Reset Game - Reset the currently running game.

Options

Controller:

• Autofire - Select if you want autofire.
• Controller - 2P start a 2 player game.
• Swap A/B - Swap which NDS button is mapped to which WS button.

Display:

• Mono Palette - Here you can select the palette for B & W games.
• Gamma - Lets you change the gamma ("brightness").

Machine Settings:

• Machine - Select the emulated machine.
• Select WS Bios - Load a real WS Bios.
• Select WS Color Bios - Load a real WS Color Bios.
• Select WS Crystal Bios - Load a real WS Crystal Bios.
• Import internal EEPROM - Load a special internal EEPROM.
• Clear internal EEPROM - Reset internal EEPROM.
• Cpu speed hacks - Allow speed hacks.
• Change Battery - Change to a new main battery (AA/LR6).
• Language - Japanese and English.

Settings:

• Speed - Switch between speed modes.
  • Normal - Game runs at it's normal speed.
  • 200% - Game runs at double speed.
  • Max - Games can run up to 4 times normal speed (might change).
  • 50% - Game runs at half speed.
• Autoload State - Toggle Savestate autoloading. Automagically load the savestate associated with the current game.
• Autoload NVRAM - Toggle EEPROM/SRAM autoloading. Automagically load the EEPROM/SRAM associated with the current game.
• Autosave Settings - This will save settings when leaving menu if any changes are made.
• Autopause Game - Toggle if the game should pause when opening the menu.
• Powersave 2nd Screen - If graphics/light should be turned off for the GUI screen when menu is not active.
• Emulator on Bottom - Select if top or bottom screen should be used for emulator, when menu is active emulator screen is allways on top.
• Autosleep - Doesn't work.

Debug:

• Debug Output - Show FPS and logged text.
• Disable Foreground - Turn on/off foreground rendering.
• Disable Background - Turn on/off background rendering.
• Disable Sprites - Turn on/off sprite rendering.
• Step Frame - Emulate one frame.

Controls

Start - WS Start

Select - WS Sound

In horizontal games:

D-Pad - WS X1-X4

A/B - WS A/B

Holding L+D-Pad - Maps the D-Pad to WS Y1-Y4

In vertical games:

D-Pad - WS Y1-Y4

A/B/X/Y - WS X1-X4

Media

NitroSwan (WonderSwan) | Nintendo DS | Games Showcase (Stranno)

Known issues

Chou Denki Card Game - You need to initialize NVRAM, this is the last item on the first page (初期化).

Kurupara - Crashes after intro.

Changelog

V0.5.0 2023/03/01

• Fixed reset of mapper registers.
• Fixed loading of roms that are not power of 2.
• Fixed timing of several opcodes.
• Fixed timing of interrupts.
• Fixed timing of address calculations.
• Fixed some cpu opcodes.
• Fixed interrupt handling.
• Fixed timers.
• Fixed sweep on sound channel 3.
• Fixed noise feedback selection.
• Fixed sound sample playback.
• Optimized cpu core a bit.
• Added support for serial port interrupts.
• Added support for battery low.
• Added new debug menu.
• Linked NDS battery to WS battery.
• Better menu traversing.

V0.4.1 2022/08/15

• Fixed background for PCV2 mode.
• WS refresh rate can control NDS refresh rate.

V0.4.0 2022/08/11

• Fixed flag calculation for most opcodes.
• Fixed emulation of undefined opcodes.
• Fixed settings to disable Bg,Fg & Spr.
• Fixed default sound volume on WSC/SC.
• Optimized the cpu core.
• Tweaked behaviour of timers.
• Mute Ch2 when playing samples.

V0.3.6 2022/04/20

• Fixed sound DMA a bit.
• Added savestates.
• Added sound button (Select).

V0.3.5 2022/03/09

• Added RTC emulation.
• Added a border to emu screen.
• Better mapping of input.
• Optimized graphic redraw.
• Optimized PC/IP handling in cpu core.

V0.3.0 2022/02/10

• Added banked SRAM emulation.
• Fixed zip decompression buffer size.
• Optimized cycle counting.
• Optimized Program Counter.
• Optimized memory access.
• Optimized opcodes.

V0.2.0 2022/01/20

• Completed the rewrite of the cpu core in ARM asm.

V0.1.3 2022/01/09

• Rewrote parts of the cpu core in asm.

V0.1.2 2021/12/18

• Backgrounds works.
• Sprites works.
• Mono mode works.
• Fixed Interrupts and Timers.
• Added EEPROM emulation.
• Added loading of bootrom for both WS & WSC.
• Added loading/saving of sram/eeprom.
• Added sound.
• Fixed interrupt routine in CPU.

V0.1.1 2021/10/17

• Started port to Nintendo DS & devkitPro.

V0.1.0 2006/07/28

• Initial release.

V0.0.0 2006/07/23

• Started Coding.

Credits

Huge thanks to Loopy for the incredible PocketNES.

Thanks to:

• Flavor & Koyote for WonderSwan info.
• Godzil for the boot rom stubs.
• lidnariq for RTC info.
• Dwedit for help and inspiration with a lot of things.

External links

• Author's Twitter - https://twitter.com/therealflubba
• GitHub - https://github.com/FluBBaOfWard/NitroSwan
• GBAtemp - https://gbatemp.net/threads/nitroswan-a-wonderswan-emulator-for-nds.604718