aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 550497c27a9581e1e6f99e0c5133348c90cc0473 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# 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 :)


The source code is provided under the GPLv3 license.


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 3DS can be used with no compatibility issues. DSi BIOS dumps should be usable too, provided they were dumped properly.

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:
 * mkdir -p build
 * cd build
 * cmake ..
 * make

Windows:
 * use CodeBlocks

Build system is not set in stone.


TODO LIST

 * better 3D engine
 * wifi
 * other non-core shit (debugger, graphics viewers, cheat crapo, etc)

 
TODO LIST FOR LATER

 * more 3D engine features
 * hardware renderer for 3D
 * 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