DS emulator, sorta
Go to file
Raphaël Zumer 22d11209b0 Split GBA Reset and Eject logic into two sets
This allows solving some crashes and provides more
flexibility in how GBA cartridges change state between
soft and hard resets. Since save states including GBA
data do not carry over the original save file path,
and the GBA cartridge is being reset along with the other
parts of the system, this is needed to avoid losing
the GBA state on reset following a state load, while
preserving the behavior where cartridges are ejected
when calling Stop().
2019-12-22 16:01:13 -05:00
.github Use the new GitHub sponsors feature to a link to the patreon 2019-08-13 12:41:16 -04:00
cmake build: add mingw64 cross-compiling 2017-12-09 18:06:40 +08:00
flatpak Add manifest for building as a flatpak 2018-11-04 23:38:14 +01:00
icon gtk: add icon 2017-12-16 05:43:34 +01:00
src Split GBA Reset and Eject logic into two sets 2019-12-22 16:01:13 -05:00
.gitignore add clion standatd dirs to .gitignore 2019-08-15 23:54:20 +02:00
CMakeLists.txt Fix build error on Fedora 2019-08-28 22:23:26 +09:00
LICENSE reorganize repo, move shit around 2017-03-16 23:01:22 +01:00
README.md update README 2019-09-04 17:03:51 +02:00
melon.ico windows: add icon 2017-12-16 04:10:32 +01:00
melon.rc BAHAHAHAHHHAHARKKZKFKKSLFS-*~+¤ 2019-09-01 20:40:55 +02:00
melonDS.cbp make it a bit less braindead 2019-09-14 01:38:46 +02:00
melon_grc.xml gtk: add icon 2017-12-16 05:43:34 +01:00
msys-dist.sh Add a script to easily grab the needed libraries when building with MSYS2 2019-05-01 06:05:48 +02:00
romlist.bin change save type for Spongebob Atlantis Squarepantis (EEPROM 4k). 2019-01-06 16:33:48 +01:00
xp.manifest start work on the input config dialog. nonfunctional and looks like shit. 2017-03-23 23:38:40 +01:00

README.md

melonDS

DS emulator, sorta

The goal is to do things right and fast, akin to blargSNES (but hopefully better). But also to, you know, have a fun challenge :)


How to use

melonDS requires BIOS/firmware copies from a DS. Files required:

  • bios7.bin, 16KB: ARM7 BIOS
  • bios9.bin, 4KB: ARM9 BIOS
  • firmware.bin, 128/256/512KB: firmware

Firmware boot requires a firmware dump from an original DS or DS Lite. DS firmwares dumped from a DSi or 3DS aren't bootable and only contain configuration data, thus they are only suitable when booting games directly.

Possible firmware sizes

  • 128KB: DSi/3DS DS-mode firmware (reduced size due to lacking bootcode)
  • 256KB: regular DS firmware
  • 512KB: iQue DS firmware

DS BIOS dumps from a DSi or 3DS can be used with no compatibility issues. DSi BIOS dumps (in DSi mode) are not compatible. Or maybe they are. I don't know.

As for the rest, the interface should be pretty straightforward. If you have a question, don't hesitate to ask, though!

How to build

Linux:

  • Install dependencies:
sudo apt-get install gtk+-3.0 libcurl4-gnutls-dev libpcap0.8-dev libsdl2-dev
  • Compile:
mkdir -p build
cd build
cmake ..
make -j$(nproc --all)

Windows:

  • use CodeBlocks

MSYS2 and CMake

  1. Install MSYS2
  2. Open the MSYS2 MinGW 64-bit terminal
  3. Update the packages using pacman -Syu and reopen the terminal if it asks you to
  4. Install dependencies: pacman -S git make mingw-w64-x86_64-{cmake,mesa,SDL2,toolchain}
  5. Run the following commands
    git clone https://github.com/Arisotura/melonDS.git
    cd melonDS
    mkdir build
    cd build
    cmake .. -G "MSYS Makefiles"
    make -j$(nproc --all)
    ../msys-dist.sh
    

If everything went well, melonDS and the libraries it needs should now be in the dist folder.

TODO LIST

  • DSi emulation
  • the impossible quest of pixel-perfect 3D graphics
  • improve libui and the emulator UI
  • support for rendering screens to separate windows
  • emulating some fancy addons
  • other non-core shit (debugger, graphics viewers, cheat crapo, etc)

TODO LIST FOR LATER

  • better wifi
  • maybe emulate flashcarts or other fancy hardware
  • big-endian compatibility (Wii, etc)
  • LCD refresh time (used by some games for blending effects)
  • any feature you can eventually ask for that isn't outright stupid

Credits

  • Martin for GBAtek, a good piece of documentation
  • Cydrak for the extra 3D GPU research
  • All of you comrades who have been testing melonDS, reporting issues, suggesting shit, etc

License

GNU GPLv3 Image

melonDS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.