# DSVita

[![Rust](https://github.com/Grarak/DSVita/actions/workflows/rust.yml/badge.svg)](https://github.com/Grarak/DSVita/actions/workflows/rust.yml)

Fast NDS Emulator for ARM32/PSVita

## Status

[![DSVita Pokemon Black](http://img.youtube.com/vi/T5SaVkuuhbM/0.jpg)](https://www.youtube.com/watch?v=T5SaVkuuhbM "DSVita Mario Kart DS")

This runs most games, however consider:

- 3D rendering
    - Mostly implemented
      - Z fighting can occur
      - Games using 3D on both screen will have bad framerates and stutters
      - Some effects like fog are unimplemented
- 2D rendering is mostly complete
- ARM7 HLE will not work with some games
    - Disable it if certain games don't boot further, get stuck, crash or have any other issues
    - There are other emulation modes like SoundHle. You can pick them if full HLE breaks anything
- Auto frameskip is always used
    - You will most likely hover around 20-30 fps, even if they run at full game speed
- No scanline rendering, thus games that update VRAM mid frame will not render correctly
    - Not many games do this, however games that do use it for scrolling texts

## Installation/Setup

- Grab the latest vpk from [releases](https://github.com/Grarak/DSVita/releases)
- Install `libshacccg.suprx`, follow
  this [guide](https://cimmerian.gitbook.io/vita-troubleshooting-guide/shader-compiler/extract-libshacccg.suprx) or just install and open VitaDB
- Install `kubridge.skprx` version >= 0.3.1 from https://github.com/bythos14/kubridge/releases
  - Make sure this plugin is in the `*KERNEL` section, otherwise the app might crash upon opening
  - If you have the wrong version installed, the app will either crash or will not be able to launch any games
- It's strongly recommend to overclock your vita to 500MHz
- Create the folder ux0:data/dsvita and put your roms there
    - They must have the file extensions `*.nds`
- Check out the [compatibility list](https://github.com/Grarak/DSVita/wiki/Compatibility-list) for popular games

## Bug reporting

Feel free to create an issue if you run into problems, however please make sure before reporting anything the game you
are
having issues with exhibits the same behavior with the `AccurateLle` setting enabled.

## Building

1. Install [Vitasdk](https://vitasdk.org/)
2. Install [cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html)
3. Install [cargo vita](https://github.com/vita-rust/cargo-vita)
4. `RUSTFLAGS="-Zlocation-detail=none -Zfmt-debug=none -Clto=fat -Zub-checks=no -Zsaturating-float-casts=no -Ztrap-unreachable=no -Zmir-opt-level=4" cargo vita build vpk -- --release`

## Credits

- [NooDS](https://github.com/Hydr8gon/NooDS) was used as reference. A lot of code was taken from there.
- [melonDS](https://github.com/melonDS-emu/melonDS) for ARM7 HLE implementation and jit optimizations.
- [DesmumePSPExperimental](https://github.com/Xiro28/DesmumePSPExperimental) for ARM7 HLE implementation.
- [pokediamond](https://github.com/pret/pokediamond) for ARM7 HLE implementation.
- [DSHBA](https://github.com/DenSinH/DSHBA) Copied some PPU hardware acceleration implementation (Thanks for xiro28
  linking me the repo)
- [vitaGL](https://github.com/Rinnegatamante/vitaGL) 2D/3D hardware acceleration wouldn't be possible without it
- [Tonc](https://www.coranac.com/tonc/text/toc.htm) GBA PPU documentation
- [GBATEK](http://problemkaputt.de/gbatek-index.htm) GBA/NDS documentation
- [kubridge](https://github.com/bythos14/kubridge) For fastmem implementation
- @TheIronUniverse for livearea assets
- [dolphin](https://github.com/dolphin-emu/dolphin) For audio stretching code