forked from nakijun/NesDS
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.TXT
451 lines (354 loc) · 15.5 KB
/
README.TXT
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
nesDS1.3c [NTR], using toolchain devkitARM r43 (/release folder NesDS.nds binary was compiled with it).
master branch is the one and only branch that uses fully libnds sources. (for TGDS support I won't add support as of now, too busy right now)
We spent a few weeks to port the original nesDS project to the GCC toolchain. Then we made a new EX Edition, and made it possible to emulate the the NES/FC games that the origianl nesDS didn't work well.
Since the 0.40 version, I ported the code of EX Edtion to the original nesDS, now it is the best nes-emulator~!
If you found any bug on nesDS, just tell me. Maybe I could fix it.
08-14-2018
coto:
- nifi, sound, touchscreen works in NTR mode as of devkitARM r43.
- fixed exception due to buffer overflow in Rom Database
2011-3-23
avenir contributed some codes to version 0.45a.
2011-9-32
avenir contributed some codes to version 1.0a.
Q: What can I do if some pics had been crashed?
A: You can try the 'sprite per-line type' under the 'Display' menu bar. If it does not work, just tell me, I will try to fix it.
CAUTION:
The extlink may cause some problems to nesDS, if does, please try the new moonshell.
Even if the sram is auto saved, it may be lost. This may be related to the dldi cache... If you have the same problem, just shutdown your DS when rom menu is shown.
The coming figures are:
????
Tell me what you need.
UPDATES:
--------
2014-08:
mapper5 update.
current:
FDS and vcr6 sound are enabled in NSF mode
sprite0y is updated in sp-pertile mode
1.3a:
alpha blend fixed.
touch the current menu item to hide menu.
cheat list bug fixed. fix the flicking of cheat list.
all saving flushed.
Sound update, the volume = sin(original * pi / 2) ^ 0.7, like a linear to log conversion.
Load and save slot number merged to one.
nsf play supported, use <left/right> to select song, use <up/down> to play/stop, use 'debug' menu to see the details.
1.2b:
vcr6 sound channel for mapper24 and mapper26 is added.
a sound reset button is added to menu>settings>config, which is used when the sound goes bad,
when close and open the DS, this is probly needed.
Mapper253 is added.
fds saving is disabled when the game is not a fds.
CRITICAL NOTE:
the sound rendering has almost reached the ability of arm7, so .....
the arm7 will auto detect the IF, by which to fix the mess of sound.
1.1b2:
every apu channel mirrored to a nds sound channel
1.1b:
sound update, fds sound works fine.
AutoFire config can be saved.
game is more stable & sound goes bad?
binary files converted to .c/.h, can be compiled by devkitARM r39
1.1a:
fds sound added, just works.
Mapper198 added, SRAM saving not supported.
Sound update.
Gesture update.
1.0:
rom patch database added, which can select a PAL/NTSC timing or fix the header of rom.
Nifi fixed.
'About' flicking fixed.
Better flicker when PALTIMING is enabled.
dswifix(which is for nifi) src is added.
1.0b:
Mapper240 added.
fixed the tmpfile.
DPCM weakened, sounds better?
A bug with ppustat fixed. e.g.'teenage mutant ninja turtles'
A bug with palette fixed.
Patch update. Battleloads (Europe) <Double Dragons> added.
SRAM can be saved whatever a game supports.
1.0a:
code of .gz replaced with a new one, still works.
.zip supported. NOTE: Only one file is allowed in the .zip archive.
code of ips been re-written.
'Double Screen Show' is supported to show all the pixels at the same time. Check 'About' for more info.
Sprites with SP-perframe updated.
Some bugs related to 'Scaling' are fixed.
Some other changes.
Thanks to avenir.
0.56a:
Short-Cuts updated. Fast forward & rewind can be changed.
Screen scaling can be saved to nesDS.ini
gzip file supported. only .gz could work. Thanks to dszip. The decompression of large files would take a while.
compiled with latest libnds(as required).
0.55b:
Sound update.
Sprites update.
A bug of Memory fixed.
Palette sync added, click Menu > Game > Display > OnOrOff to change. More info, see the 'About'.
Pal sync needed:Fantastic Adventures of Dizzy, Micro Machines, Wizards & Warriors, Feng Shen Bang.
0.55a:
A bug with nesDS.ini fixed, works with latest devkitARM-r34
Saving for FDS added. Menu > Game > Extra > Save FDS.
Shows time on the top menu.
Mapper 216 189 added. e.g. Magic Jewelry 2, Master Fight 2, Street Fighter 4...
Some others..
0.54a:
Big nose freak out update.
mapper225 226 227 229 230 231 255 added.
Sound enhanced.
Raw PCM update, nearly perfect.
sprite0y update.
nifi update.
NOTE: unstable with devkitARM r33, using r32 instead.
0.53b:
Mapper1 updated.
Auto-fire adjusting added.
Swap-Screens disabled if LIGHTGUN active.
sprite0y for SP-pertile fixed.
Careful to use Swap-Screens, which may shutdown DS.
0.53a:
IPS supported. First, load a .ips file, then load the rom to start a patched game. The rom file won't be changed. The ips file should be smaller than 512kB.
Barcode supported. Click Menu>Game>Extra>Barcode
Gesture supported. Click Menu>Config>Short-Cuts to configure. When the menu is hidden or the LIGHTGUN is enabled, you can touch the sub-screen to draw a gesture.
Mapper245 added.
Mapper16 updated.
Raw PCM updated.
'SP-Pertile' updated. E.g. The issue with Super Mario 3 is fixed.
Some others...
0.52a:
The 'menu' is re-designed.
Raw PCM supported, not perfect, can be switched off in menu>Settings>Config.
Settings of nesDS can be written to 'nesDS.ini' at runtime, done in menu>Settings.
Short-Cuts can be configured in menu>Settings.
'LightGun' is placed in menu>Game>Extra, 'Micphone' and 'FDS disk' are also added there. 'Micphone' is not tested.
Nothing more.
0.51a:
Roll back some updates in 0.50b.
Mapper90 added. It works fine. You need to reload the nes rom to get a 'Soft-Reset'.
Light-Gun added. Under the 'Input' bar, click 'No LightGun' to active Light-Gun. When shooting, hold L-button and touch the sub-screen. 'Swap screens' is recommended. R-button can be used to rewind game play.
sprite0y calculation for SP-pertile corrected, better.
V-flip for SP-pertile corrected, better.
A patch file added, used to correct the header of rom or modify the settings of nesDS.
Below shows the games patched:
PRGCRC Name
0x33AA Akumajou Densetsu
0x0A62 Joe & Mac
0x49B3 TMNT 1
0xE91E Duck Hunt(JUE)
0x15CF Wild Gunman
0x15CF Gum Shoe
0x9F65 Hogan's Alley (JU)
0xB2B5 Three Eyed ONE/Mitsume Ga Tooru
0x8A35 Feng Shen Bang(Chinese)
0xD796 Alien Syndrome (J)
0.50b:
nesDS.ini commented.
nesDS.ini: ScreenSwap added. If your DS' top-screen did not work well, set this value to 1.
mapper 19, 71, 118 updated.
NES cycles-per-scanline modified to 121, to make the graphic more smooth. E.g. tmnt, Akumajou Densetsu.... Also makes Joe&Mac work fine.
A sound bug fixed, which may cause a panic....
Sub-screen will be closed if there is a NES_RESET.
Cheat list can be loaded/saved from/to a file. EXTENTION:.cht
FrameSkip for Pure-Soft rendering can be adjusted. If you have a DSi, frameskip 1 would be OK; For DS/DSL, frameskip 2 is recommended.
frameskip 1 means that the graphic is updated at 30fps. 2 for 20fps. On the older nesDS, frameskip 2 equals to 30fps.
sprite0y changed, which makes the graphic better. e.g. Super Mario...
CRAM added..
0.50a2:
All memory needed is pre-allocated, and all malloc() are deleted.. This is done for those who cannot run nesDS well.
The average length of roms' names MUST be lower than 64bytes, for saving memory.
MAX_ROM_SIZE is set to 3M.
Delay for multi-player is slightly lower.
Mapper4 is updated. e.g. tmnt3 works well now.
Path for nesDS.ini is updated. Available paths now are:"/","/_dstwoplug/","/ismartplug/","/moonshl2/extlink/","/_iMenu/_ini/","/_plugin_/"
0.50a:
Nifi/Multi-players supported.
Cheat re-added.
About/Help tip added.
NTSC/PAL timing supported.
Roms menu cached, which will speed up the rom menu when start another game.
some bugs fixed.
0.48b:
Mapper68 updated. e.g. After Burner(U)
Some bugs fixed.
nesDS.ini updated.
0.48a:
software-render re-added, to deal with the mappers 9, 10, 19, etc.
0.47b:
sound update.
L+UP to show NES on top screen when playing.
L+DOWN for bottom screen.
0.47a:
sound enhanced. MAX VOL x2.
fds supported. Do NOT use realtime saving and loading.("save state" and "load state"). Safe to use KEY_R and KEY_L.
R+UP = disk A
R+LEFT = disk B
R+DOWN = disk C
R+RIGHT = disk D
0.46a:
mapper163 added..
sound updated.
MAX FILES enlarged.
0.45b:
The memory region of "NES" is relocated from 0x23f0000 to 0x23ec000. advised by avenir. Now the nesDS on my DS could return to the homebrew menu.
A software for sprite-scaling is added. Select 'Per-scanline' to active it.
Mid-frame BG pal refresh is supported. Some games like 'Wizards Warriors' work fine.
Some others not important...
0.45a_v2:
sound fixed..
0.45a:
avenir write a patch to nesDS, what's new? He said...
@----------- start -----------@
Extended the reset to "If not loaded from hbmenu/xenofile, returns DSi/3DS menu on DSi/3DS".
stringsort() is now a wrapper for qsort().
extlink now accepts multibyte filename thanks to Unicode support.
Directory listing is shown the same way as WinNT(8.3 lower case). <- If you name a file all lower case in 8.3...
/nesDS.ini is used for configuration(minIni).
@----------- end -----------@
updates:
Add the shout-cuts for configuration.
Sound fixed.. better than 0.44b. Almost no noise(not the noise channel).
sprite0y of 'per-scanline' fixed.
h-blank interrupt handler added, which was removed since 0.44b.
some other chanegs.. No update for mappers.
0.44b:
Since the nesDS file is larger, this version is NOT recommended for those who just want to play nes games.
Port the whole project to devkitPro, using libnds, libfat....
Almost no update, but some figures may be worse. e.g. sound with the games that read reg4015. Some games' sounds work better... - -!
You guys can try 'Start+Select+R+L' to exit your nesDS and return to the main menu of flash-card. On mine, it just shotdown my DS(R4SDHC with kernel1.34, no help with moonshell2 either).
Since this version, the mem region cannot be accessed freely, be careful if anyone wants to write a patch.
The libnds and libfat are too big... 128k around. Shit that!
0.44a:
A bug of cartflags was fixed, which will definitely make the game unable to save..
something about 'fetch_c' was changed, which may cause some problem. the bug logged in 0.43 was related to this.
set the nes ram reset value to 0x0, not 0xFFFFFFFF, which will cause the 'Super Mario' starting from world 0-1.
Supprised that karateka(j) works now...
0.43:
Warning: A bug of SRAM was fixed. It may cause the games that use SRAM crashed....
0.43b:
DPCM/DMC suppoted! I should say that this is just for testing.... DPCM causes a lot of sound crashes, and I am busy fixing them.. well, Mario 3 works fine, also 'Chan'..
no other updates.
I need to slow down this project...
0.42b:
no sound updates.
short-cuts added..
extlink supported.
some unused files of sound are removed. It is much clear now...
no more...
0.41b:
mapper 9, 10, 118, 228 updated/fixed. Punch-Out, Action 52 IN 1, and some others games play well now.
The 'Flicker' function was slightly fixed. Our eyes will not be that hurt now ;p
A new bg render method was added, but not actived in this version, there are still alot work to do.
0.40:
'roll back' fixed... I did not release this version because there is no need to...
0.40b
named as 'nesDS 0.40', not 'nesDS EX 0.40', because the two versions had been merged into one.
some bugs fixed ....
0.31
mapper 23, 25 supported
rendering method changed
scaling supported
0.30beta
All the rendering sections has been re-written. Uses the NDS hardware to emu the NES graphic.
Much better speed and sound.
0.22
uses software to cal the CRC, same as Virtuanes.
mapper074 updataed, supporting some special games.
mapper0, 1, 4 updated.
fixed some bugs..
0.22b
mappers supported: 0, 1, 2, 3, 4, 10, 16, 19, 74, 246 (EX's mapper files is very different from the original.)
function added: cheat
CHANGES£º
--------
Touch screen should work better now
Fixed bug that was causing ARM7 to crash on emulators (ideas and desemu inputs were not working)
CAUTIONS:
---------
Run the nesDS EX Edition on ideas may cause a crush, because ideas does NOT support "swi".
NOTES:
------
All other functionality should be identical to the original. nesDS inputs now work properly on
emulators. You can run the nesDS on ideas by DLDI patching it with the R4 dldi patch using
dlditool. You must then enable DLDI support for R4 under File->Properties. You can also run nesDS
on desmume but you will need to create a filesystem image from some files and embed the files to
the emulator (you need to use fcsr for this).
COMPILING:
----------
You need devkitARM to compile this project. If you are compiling on windows you also need mingw. On linux you will need to have make installed.
The project compiles on windows and linux using devkitARM r32 (devkitPro). To compile on windows use
msys-1.0.15 (devkitPro) as well. You do not need anyhting else to comiple the project.
Compiling on windows:
1) extract devkitARM to a folder
2) extract msys to a folder
3) add DEVKITARM environment variable and set its value to the path where you extracted devkitARM,
e.g: /c/devkitARM (must be linux style path!)
4) (OPTIONAL) add path to msys binaries in you windows path, e.g: c:\msys\bin (must be windows style path!)
You only need to do step 4 if you want to compile from the windows command shell. You can compile the project
without step 4 by launching mingw using msys.bat in the msys folder.
5) change to the project main directory, either in the windows command shell (step4 required) or mingw then
type make.
Compiling on linux:
1) extract devkitARM
2) create a DEVKITARM shell variable with the path to where you extracted devkitARM, e.g: /usr/local/devkitARM
You can create a variable in /etc/profile or in your home directory .bash_profile file as follows
export DEVKITARM=/usr/local/devkitARM
or just type this command in the shell before typing make
3) change to the project main directory then type make.
To delete all object files type:
make clean
in the main project directory
If you make changes to the emulator and want to add them to this project or if you want to join the project notify us
on http://sourceforge.net/projects/nesds
CREDITS:
--------
Original nesDS team:
Coding: loopy, FluBBa
More code: Dwedit, tepples, kuwanger, chishm
Sound: Mamiya
___________________________
ported to gcc by minitroopa
EX Edition made by huiminghao
0.4x Edition made by huiminghao
more credits:
-------------
avenir
(License)
nesDS is released into the PUBLIC DOMAIN. You may do anything you want with it.
If you make any changes you'd like to see added to the official version, please
let me know.
-- nesds@olimar.fea.st
nesDS was compiled with ARM ADS 1.2.
To build it, open the project file (nesDS.mcp) and click Project -> Make.
---------------------------------------------------------
Memory map:
1ff8000-1ffffff: ITCM (6502 core, etc)
2000000-23fffff: cached ram
2400000-27fffff: uncached ram
2800000-2803fff: DTCM (misc tables and data)
--------------------------
misc NES data 23f8000 -> 23fe000
sound and DMA buffers 27fe000 -> 27ffc00 (uncached)
firmware settings 23ffc00 -> ...
IPC 27fff00 -> 2800000 (uncached)
scratch memory is (Image$$EWRAM$$ZI$$Limit -> 23f8000), used for file list storage, rom storage, game recording
other ptrs:
rombase = Image$$EWRAM$$ZI$$Limit
freemem_start = end of rom
freemem_end=23f8000
(all of freemem_start -> end is used for recording)
---------------------------------
VRAM:
A=MAIN OBJ (128k) 6400000-641ffff
B=MAIN BG (128k) 6040000-605ffff
C=MAIN BG (128k) 6000000-601ffff
D=MAIN BG (128k) 6020000-603ffff
E
F
G
H=SUB BG 6200000-6207fff
I
6000000-605e000 MAIN CHR (#? chr banks)
605e000 MAIN SCR