-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit ef27aaf
Showing
1 changed file
with
93 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,93 @@ | ||
<p align="center"><img src="https://live.staticflickr.com/65535/46955701834_ccde673d08_o.png"></p> | ||
<h2 align="center"><b>melonDS</b></h2> | ||
<p align="center"> | ||
<a href="http://melonds.kuribo64.net/" alt="melonDS website"><img src="https://img.shields.io/badge/website-melonds.kuribo64.net-%2331352e.svg"></a> | ||
<a href="http://melonds.kuribo64.net/downloads.php" alt="Release: 0.7.4"><img src="https://img.shields.io/badge/release-0.7.4-%235c913b.svg"></a> | ||
<a href="https://www.gnu.org/licenses/gpl-3.0" alt="License: GPLv3"><img src="https://img.shields.io/badge/License-GPL%20v3-%23ff554d.svg"></a> | ||
<a href="https://kiwiirc.com/client/irc.badnik.net/?nick=IRC-Source_?#melonds" alt="IRC channel: #melonds"><img src="https://img.shields.io/badge/IRC%20chat-%23melonds-%23dd2e44.svg"></a> | ||
</p> | ||
|
||
## SAME MELONDS, JUST TURKISH... | ||
|
||
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 :) | ||
<hr> | ||
|
||
## 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: | ||
|
||
```sh | ||
sudo apt-get install libpcap0.8-dev libcurl4-gnutls-dev libsdl2-dev gtk+-3.0 | ||
``` | ||
|
||
* Compile: | ||
|
||
```sh | ||
mkdir -p build | ||
cd build | ||
cmake .. | ||
make | ||
``` | ||
|
||
|
||
|
||
### Windows: | ||
|
||
* use CodeBlocks | ||
* or receive golden cookies if you get Cmake to work | ||
|
||
Build system is not set in stone. | ||
|
||
## TODO LIST | ||
|
||
* improve libui and the emulator UI | ||
* hardware renderer for 3D (w/ upscaling and fancy shit) | ||
* 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 | ||
[](http://www.gnu.org/licenses/gpl-3.0.en.html) | ||
|
||
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. |