NitroSwan DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 4: Line 4:
|description=WonderSwan emulator for Nintendo DS.
|description=WonderSwan emulator for Nintendo DS.
|author=Fredrik Ahlström (FluBBa)
|author=Fredrik Ahlström (FluBBa)
|lastupdated=2022/02/10
|lastupdated=2022/08/12
|type=Handheld
|type=Handheld
|version=0.3.0
|version=0.4.0
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/dshomebrew/nitroswan.7z
|download=https://dlhb.gamebrew.org/dshomebrew/nitroswan.7z
Line 42: Line 42:
'''Display:'''
'''Display:'''
* Mono Palette - Here you can select the palette for B & W games.
* Mono Palette - Here you can select the palette for B & W games.
* Gamma - Lets you change the gamma (""brightness"").
* Gamma - Lets you change the gamma ("brightness").
* Disable Foreground - Turn on/off foreground rendering.
* Disable Background - Turn on/off background rendering.
* Disable Sprites - Turn on/off sprite rendering.


'''Machine Settings:'''
'''Machine Settings:'''
Line 70: Line 67:
* Powersave 2nd Screen - If graphics/light should be turned off for the GUI screen when menu is not active.
* 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.
* Emulator on Bottom - Select if top or bottom screen should be used for emulator, when menu is active emulator screen is allways on top.
* Debug Output - Show an FPS meter for now.
* Autosleep - Doesn't work.
* 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==
==Controls==
L+R or Touchscreen - Open menu
Start - WS Start


Hold Start when starting a game - Enter boot rom settings (internal EEPROM is saved when saving settings)
Select - WS Sound


'''Menu:'''
'''In horizontal games:'''


D-Pad or Touchscreen - Navigate menu
D-Pad - WS X1-X4


A or Double tap - Select an option
A/B - WS A/B


B or Touchscreen - Go back a step
Holding L+D-Pad - Maps the D-Pad to WS Y1-Y4


L/R - Select between the tabs
'''In vertical games:'''
 
D-Pad - WS Y1-Y4
 
A/B/X/Y - WS X1-X4


==Media==
==Media==
Line 93: Line 100:


==Known issues==
==Known issues==
Savestates does not work yet.
Chou Denki Card Game - You need to initialize NVRAM, this is the last item on the first page (初期化).
 
Kurupara - Crashes after intro.


==Changelog==
==Changelog==
'''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'''
'''v0.3.0 2022/02/10'''
* Added banked SRAM emulation.
* Added banked SRAM emulation.
Line 136: Line 166:
* Flavor & Koyote for WonderSwan info.
* Flavor & Koyote for WonderSwan info.
* [https://github.com/Godzil/NewOswan Godzil] for the boot rom stubs.
* [https://github.com/Godzil/NewOswan Godzil] for the boot rom stubs.
* lidnariq for RTC info.
* Dwedit for help and inspiration with a lot of things.
* Dwedit for help and inspiration with a lot of things.



Revision as of 00:29, 14 August 2022

NitroSwan DS
Nitroswan2.png
General
AuthorFredrik Ahlström (FluBBa)
TypeHandheld
Version0.4.0
LicenseMixed
Last Updated2022/08/12
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.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

Advertising: