DS emulator, sorta
Go to file
Pedro f74387a8c1
Implement NO$GBA debug registers. (#1110)
* Implement NO$GBA debug registers.

NO$GBA comes with 4 debug registers that allow a ROM to print text to
the emulator terminal and 2 other status registers, one with the name of the
emulator and the other with the clock cycles count. This commit
implements them for the ARMv5 processor.

Some small things to note:
 - `NocashPrint` was changed and now it takes an address to _the string_ instead of the flags before it (those
don't do anything anyways).
 - The "Emulation ID" register contains the string "melonDS " followed by version, _not_ "NO$GBA"

* Fix styling issue and improve comment regarding NO$GBA message flags
2021-05-27 12:15:16 +02:00
.github add paypal and shit 2021-04-26 15:53:02 +02:00
cmake build: add mingw64 cross-compiling 2017-12-09 18:06:40 +08:00
icon gtk: add icon 2017-12-16 05:43:34 +01:00
src Implement NO$GBA debug registers. (#1110) 2021-05-27 12:15:16 +02:00
tools mac-libs.rb: codesign the app + minor fixes 2021-04-27 01:06:57 +02:00
.gitignore Define melonDS version in CMake 2021-01-19 11:39:25 +00:00
CMakeLists.txt macOS-related CMake cleanups 2021-05-02 16:32:27 +02:00
LICENSE reorganize repo, move shit around 2017-03-16 23:01:22 +01:00
README.md Add -DUSE_QT6=ON to README 2021-05-02 13:13:43 +00:00
azure-pipelines.yml azure-pipelines: use Qt6 for macOS 2021-04-25 03:13:32 +02:00
melon.icns Define melonDS version in CMake 2021-01-19 11:39:25 +00:00
melon.ico windows: add icon 2017-12-16 04:10:32 +01:00
melon.plist.in Request microphone permissions on macOS 2021-02-25 09:12:22 +00:00
melon.qrc Use 256x256 instead of 32x32 as window icon size (#1115) 2021-05-27 12:12:55 +02:00
melon.rc.in update copyright year and add missing GPL headers 2021-03-12 20:07:40 +01:00
melon_grc.xml gtk: add icon 2017-12-16 05:43:34 +01:00
net.kuribo64.melonDS.desktop Remove redundant desktop file and change desktop/icon file name to net.kuribo64.melonDS, also change melonds to melonDS. 2019-12-19 02:48:11 +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:

  1. Install dependencies: sudo apt install cmake libcurl4-gnutls-dev libpcap0.8-dev libsdl2-dev qt5-default libslirp-dev libarchive-dev libepoxy-dev
  2. Download the melonDS repository and prepare:
git clone https://github.com/Arisotura/melonDS
cd melonDS
mkdir build && cd build
  1. Compile:
mkdir -p build
cd build
cmake ..
make -j$(nproc --all)

Windows:

  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. Download the melonDS repository and prepare:
git clone https://github.com/Arisotura/melonDS
cd melonDS
mkdir build && cd build

Dynamic builds (with DLLs)

  1. Install dependencies: pacman -S git make mingw-w64-x86_64-{cmake,mesa,SDL2,toolchain,qt5,libslirp,libarchive,libepoxy}
  2. Compile:
    cmake .. -G "MSYS Makefiles"
    make -j$(nproc --all)
    ../tools/msys-dist.sh
    

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

Static builds (without DLLs, standalone executable)

  1. Install dependencies: pacman -S git make mingw-w64-x86_64-{cmake,mesa,SDL2,toolchain,qt5-static,libslirp,libarchive,libepoxy}
  2. Compile:
    cmake .. -G 'MSYS Makefiles' -DBUILD_STATIC=ON -DQT5_STATIC_DIR=/mingw64/qt5-static
    make -j$(nproc --all)
    mkdir dist && cp melonDS.exe dist
    

If everything went well, melonDS should now be in the dist folder.

macOS:

  1. Install the Homebrew Package Manager
  2. Install dependencies: brew install git pkg-config cmake sdl2 qt@6 libslirp libarchive libepoxy
  3. Download the melonDS repository and prepare:
git clone https://github.com/Arisotura/melonDS
cd melonDS
mkdir build && cd build
  1. Compile:
    cmake .. -DCMAKE_PREFIX_PATH="$(brew --prefix qt@6);$(brew --prefix libarchive)" -DUSE_QT6=ON -DMACOS_BUNDLE_LIBS=ON
    make -j$(sysctl -n hw.logicalcpu)
    

If everything went well, melonDS.app should now be in the curent directory.

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
  • limittox for the icon
  • 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.