godzil/ti-nesulator
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation

Browse Source
This commit is contained in:
godzil 2008-02-25 14:52:06 +00:00
parent c2ae371bed
commit 8e99ac85ff
4 changed files with 249 additions and 245 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/Changements.txt
View File

@ -1,3 +1,15 @@
25/02/2008: V0.30 part 2
- Correct a bug in CPU emulation related with cycle count and the stupid R_FLAG
- Correct bugs in PAL emulation where VBlank line count was incorrect.
- Correct a bug with VBlank (it occured one line too late)
- Correct a bug with cart loading, if the file name was incorrect it crashed instead
exiting gently.
- All mappers are remerged.
- Unix & Windows build are totaly broken...
- Sprite are back! There are some bad behaviour, but they will be corrected with next versions.
- New SVN repository (the disk where the old one was had crashed...)
- Iremh3100 is now active! (finaly)
05/10/2007 V0.30 part 2 ... In progress ... 05/10/2007 V0.30 part 2 ... In progress ...
- Start rewrite of mapper manager. The goal, like for plugin manager, is - Start rewrite of mapper manager. The goal, like for plugin manager, is
to allow in the future to have plugins or mapper in external libraries. to allow in the future to have plugins or mapper in external libraries.

34
doc/Changes.txt
View File

@ -1,20 +1,32 @@
05/10/2007 V0.30 part 2 ... In progress ... 25/02/2008: V0.30 part 2
- Correct a bug in CPU emulation related with cycle count and the stupid R_FLAG
- Correct bugs in PAL emulation where VBlank line count was incorrect.
- Correct a bug with VBlank (it occured one line too late)
- Correct a bug with cart loading, if the file name was incorrect it crashed instead
exiting gently.
- All mappers are remerged.
- Unix & Windows build are totaly broken...
- Sprite are back! There are some bad behaviour, but they will be corrected with next versions.
- New SVN repository (the disk where the old one was had crashed...)
- Iremh3100 is now active! (finaly)
25/10/2007:
- Savestate now work correctly (It was not loaded at the right time...)
- Mapper manager seems to work correctly ok
- [MACOSX] Builds options are better now
- [TODO] Remerge old PPU debug utilities in real plugin form
- [TODO] Change the make util. Maybe cmake ?
- [TODO] Remerge all mappers with the new manager
- [TODO] Rewrite UNIX Makefile for support new src organization.
05/10/2007:
- Start rewrite of mapper manager. The goal, like for plugin manager, is - Start rewrite of mapper manager. The goal, like for plugin manager, is
to allow in the future to have plugins or mapper in external libraries. to allow in the future to have plugins or mapper in external libraries.
- New sound layer using Allegro. Not really accurate, but more portable. - New sound layer using Allegro. Not really accurate, but more portable.
A lot of work has to be done on this (especialy because the actual sound A lot of work has to be done on this (especialy because the actual sound
is really bad.) is really bad.)
- Started a new source organisation. Should be the good one this time! - Started a new source organisation. Should be the good one this time!
25/10/2007:
- Savestate now work correctly (It was not loaded at the right time...)
- Mapper manager seems to work correctly ok
- [MACOSX] Buils options are better now
- [TODO] Remerge old PPU debug utilities in real plugin form
- [TODO] Change the make util. Maybe cmake ?
- [TODO] Remerge all mappers with the new manager
- [TODO] Rewrite UNIX Makefile for support new src organization.
03/05/2007 V0.30 part 1 03/05/2007 V0.30 part 1
- Started the process of PPU total rewrite. - Started the process of PPU total rewrite.

222
doc/LisezMoi.txt
View File

@ -1,65 +1,64 @@
<----------------------------------------------------------------------------------> <------------------------------------------------------------------------------>
TI-NESulator TI-NESulator
Version 0.26 beta Version 0.30.2 beta
Par Manoël TRAPIER aka Godzil Par Manoel TRAPIER aka Godzil
godzil at godzil point net godzil at godzil point net
1 -> #include <disclamer.h> 1 -> #include <disclamer.h>
L'utilisation de se logiciel se fait a vos risque et périls. Il s'agit d'une pars L'utilisation de se logiciel se fait a vos risque et pŽrils. Il s'agit d'une
d'une version non terminée, et en cours de dévellopement, et la diffusion n'a été pars d'une version non terminŽe, et en cours de dŽvellopement, et la diffusion
faite que pour permettre le teste, et la démonstration de se que sera le logiciel n'a ŽtŽ faite que pour permettre le teste, et la dŽmonstration de se que sera le
final. logiciel final.
Je ne peut donc être tenu pour responsable en cas de problème lié a l'utilisation Je ne peut donc <EFBFBD>tre tenu pour responsable en cas de probl<62>me liŽ ˆ
ou posession de se logiciel. l'utilisation ou posession de se logiciel.
Vous êtes libre de l'utiliser à partir du moment au se logiciel n'a pas été modifié Vous <EFBFBD>tes libre de l'utiliser ˆ partir du moment au se logiciel n'a pas ŽtŽ
que sa soit de manière binaire, ou par désassemblage. Si vous trouver une version modifiŽ que sa soit de mani<6E>re binaire, ou par dŽsassemblage. Si vous trouver
modifié ou fourni avec des fichiers illégaux, veuillez me le faire savoir. Vous une version modifiŽ ou fourni avec des fichiers illŽgaux, veuillez me le faire
trouverez comment me contacter dans la suite de se fichier. savoir. Vous trouverez comment me contacter dans la suite de se fichier.
Vous êtes libre aussi de le distribuer tant que les fichiers contenus dans le Vous <20>tes libre aussi de le distribuer tant que les fichiers contenus dans le
paquetage original sont laissé intouché (les fichiers Changements.txt LisezMoi.txt paquetage original sont laissŽ intouchŽ.
et TINes.exe)
Information légales : Information lŽgales :
NES, Famicon, Nintendo Entertainment System, Nintendo sont des marques déposé de NES, Famicon, Nintendo Entertainment System, Nintendo sont des marques dŽposŽ de
Nintendo France, Nintendo of america et Nintendo Company, Ltd. Nintendo France, Nintendo of america et Nintendo Company, Ltd.
Tout les titres et marques apparaisant dans se fichier texte sont la propriété de Tout les titres et marques apparaisant dans se fichier texte sont la propriŽtŽ
leurs auteurs respectifs. de leurs auteurs respectifs.
N'oubliez pas aussi que la posession de ROM (Fichier binaire représentant le N'oubliez pas aussi que la posession de ROM (Fichier binaire reprŽsentant le
contenue d'une cartouche) sans en posseder l'originale (la cartouche) est absolument contenue d'une cartouche) sans en posseder l'originale (la cartouche) est
illégale, que vous la gardiez 24 heures ou seulement 30 secondes absolument illŽgale, que vous la gardiez 24 heures ou seulement 30 secondes
2 -> Qu'est-ce que TI-NESulator ? 2 -> Qu'est-ce que TI-NESulator ?
TI-NESulator est un émulateur de la console Nintendo Entertainment System TI-NESulator est un Žmulateur de la console Nintendo Entertainment System
(connunément appelé NES) fabriqué par Nintendo au milieu des année 80. L'originalité (connunŽment appelŽ NES) fabriquŽ par Nintendo au milieu des annŽe 80.
de cet emulateur est que sa plateforme de fonctionnement principal est les L'originalitŽ de cet emulateur est que sa plateforme de fonctionnement principal
calculatrices TI-89 et TI-92+ de chez Texas Instrument. Ses calculatrices on la est les calculatrices TI-89 et TI-92+ de chez Texas Instrument. Ses
particularité de posseder un microprocesseur 68000 de chez motorola, qui est pour calculatrices on la particularitŽ de posseder un microprocesseur 68000 de chez
se genre de plateforme relativement puissant et programmer un emulateur, meme de motorola, qui est pour se genre de plateforme relativement puissant et
NES, sur ses machine est un véritable défit. programmer un emulateur, meme de NES, sur ses machine est un vŽritable dŽfit
Tant au niveau matériel que mémoire, la NES et les TI-68k sont completements tant au niveau matŽriel que mŽmoire, la NES et les TI-68k sont completements
différents. diffŽrents.
La NES utilise une version légérement personalisé du microprocesseur 6502 La NES utilise une version lŽgŽrement personalisŽ du microprocesseur 6502
fonctionnant a environ 1.7Mhz. fonctionnant ˆ environ 1.7Mhz.
Vous avez actuellement une version spéciale (comprendre pas faite pour Vous avez actuellement une version spŽciale (comprendre pas faite pour
calculatrices TI.) Cette version ne me sert qu'a mettre en oeuvre de nouvelles calculatrices TI.) Cette version ne me sert qu'a mettre en oeuvre de nouvelles
choses dans la version TI de l'émulateur (notemment a cause d'un gros manque choses dans la version TI de l'Žmulateur (notemment a cause d'un gros manque
de debuggueur C dans le monde TI.) de debuggueur C dans le monde TI.)
Cette version est et sera toujours plus avancé que la version TI dans le sens ou Cette version est et sera toujours plus avancŽ que la version TI dans le sens ou
elle me sert a expérimenter les nouveaux hardware émulé et a finaliser le hardware elle me sert a expŽrimenter les nouveaux hardware ŽmulŽ et a finaliser le
deja emuler. Une fois fonctionnant d'un maniere convenable sur le portage Windows, hardware deja emuler. Une fois fonctionnant d'un maniere convenable sur le
les mises a jours sont faites dans la version TI. Mais la version Windows au final portage Windows, les mises a jours sont faites dans la version TI. Mais la
contiendra plus de fonctionnalité que la version TI (support des palletes, de la version Windows au final contiendra plus de fonctionnalitŽ que la version TI
couleur, voir meme le son etc...) (support des palletes, de la couleur, voir meme le son etc...)
3 -> Utilisation de TI-NESulator 3 -> Utilisation de TI-NESulator
@ -86,7 +85,7 @@ SELECT P
-------------------------- --------------------------
Autres touches : Autres touches :
R identique a l'apuis du bouton Reset de la console R identique ˆ l'apuis du bouton Reset de la console
1-2 A un effet, mais vous risque de pas le voir ;) 1-2 A un effet, mais vous risque de pas le voir ;)
@ -97,136 +96,109 @@ R identique a l'apuis du bouton Reset de la console
-------------------------- --------------------------
Il faut noter aussi qu'afficher ces tables ralenti considérablement la vitesse de Il faut noter aussi qu'afficher ces tables ralentisent considŽrablement la
l'émulateur vitesse de l'Žmulateur
4 -> Compatibilité 4 -> CompatibilitŽ
TI-NESulator version Win32 est normalement compatible avec tous les Windows (95, 98, TI-NESulator version Win32 est normalement compatible avec tous les Windows
Me, NT 4, 2000, XP) (95, 98,Me, NT 4, 2000, XP)
TI-NESulator version .X (MacOS X) est normalement compatible toutes version de OS X TI-NESulator version .X (MacOS X) est normalement compatible toutes version
(.1.x .2.x .3.x) de OS X (.1.x .2.x .3.x)
L'émulateur émule actuellement avec les mappers :
L'Žmulateur Žmule actuellement avec les mappers :
- 0 aucun mapper (Super Mario Bros 1, Donkey Kong, ...) - 0 aucun mapper (Super Mario Bros 1, Donkey Kong, ...)
- 1 MMC1 (a 99%, Megaman 2, Zelda1 & 2, Final Fantasy 1, ...) - 1 MMC1 (a 99%, Megaman 2, Zelda1 & 2, Final Fantasy 1, ...)
- 2 UNROM (MegaMan, Final fantasy 2, ...) - 2 UNROM (MegaMan, Final fantasy 2, ...)
- 3 CNROM - 3 CNROM
- 4 MMC3 (Super mario Bross 2 & 3, MegaMan 3 ˆ 6, ...)
- 7 AOROM (Battletoad, ...)
- 4 *NOUVEAU* MMC3 (Super mario Bross 2 & 3, MegaMan 3 à 6, ...) Les mappers marquŽ comme *NOUVEAU* sont ceux qui on ŽtŽ ajoutŽ dans la derniere
version disponible. Merci de faire un rapport dŽtaillŽ si vous rencontrer des
probl<EFBFBD>mes avec.
- 7 *NOUVEAU* AOROM (Battletoad, ...) 5 -> Question RŽponses
Les mappers marqué comme *NOUVEAU* sont ceux qui on été ajouté dans la derniere
version disponible. Merci de faire un rapport détaillé si vous rencontrer des
problèmes avec.
5 -> A faire
* Optimisation du coeur de l'émulation du CPU de la NES.
* Son ?
* Supprimer les printf et les remplacer par l'affichage dans une console (prochaine
maj) pour eviter les soucis sur
- PC: car la console n'est pas forcement ouverte tout le temps
- Unix: pour la meme raison
- MacOS: aussi (%))
- TI: pasqu'on peut pas avoir les deux en meme temps.
* Recoder le ppu (gestion de l'affichage)
6 -> Question Réponses
Q: Pourquoi le jeu xxx ne fonctionne pas ? Q: Pourquoi le jeu xxx ne fonctionne pas ?
R: TI-NESulator est actuellement en cours de dévellopement. Beaucoup de jeux ne R: TI-NESulator est actuellement en cours de dŽvellopement. Beaucoup de jeux ne
sont pas supporté. sont pas supportŽ.
Q: Vous dites que certain de jeux ne sont pas supporté, mais si j'essaye xxx, il Q: Vous dites que certain de jeux ne sont pas supportŽ, mais si j'essaye xxx, il
marche ! Pourquoi ? marche ! Pourquoi ?
R: Ceci est du a une des particularité du Hardware de la NES/Famicon. Le hardware R: Ceci est du a une des particularitŽ du Hardware de la NES/Famicon. Le
de base de la console est assé limité, et la mémoire est aussi tres limité. pour hardware de base de la console est assŽ limitŽ, et la mŽmoire est aussi tres
palier à ses limitations, certains jeux utilise ce qu'on appele des Mappers, qui limitŽ. pour palier ˆ ses limitations, certains jeux utilise ce qu'on appele des
permettent notemment d'avoir des jeux plus gros, et qui sont implémenté dans la Mappers, qui permettent notemment d'avoir des jeux plus gros, et qui sont
cartouche du jeu. Malheureusement supporter tout ses mappers font grossir implŽmentŽ dans la cartouche du jeu. Malheureusement supporter tout ses mappers
l'emulateur, et certain on un fonctionnement qui est malheureusement encore font grossir l'emulateur, et certain on un fonctionnement qui est
inconnu. N'oubliez pas non plus que TI-NESulator est encore en dévellopement. malheureusement encore inconnu. N'oubliez pas non plus que TI-NESulator est
Certain mapper connu ne sont pas encore implémenté. encore en dŽvellopement. Certain mapper connu ne sont pas encore implŽmentŽ.
Q: Oui puis-je trouver le jeux xxxx ? Q: Oui puis-je trouver le jeux xxxx ?
R: Désolé, je ne donne aucun lien menant, ni aucune ROM de jeux commerciaux. R: DŽsolŽ, je ne donne aucun lien menant, ni aucune ROM de jeux commerciaux.
N'oubliez pas que les personnes vous disant que vous avez le droit de ne garder que N'oubliez pas que les personnes vous disant que vous avez le droit de ne garder
24h une ROM, vous raconte absolument n'importe quoi. Il est absolument *ILLEGAL* de que 24h une ROM, vous raconte absolument n'importe quoi. Il est absolument
posseder la ROM d'un jeu que vous ne possedez pas officiellement. *ILLEGAL* de posseder la ROM d'un jeu que vous ne possedez pas officiellement.
Q: XXX donne l'air de fonctionner, pourtant il ne reagis pas au touches Q: XXX donne l'air de fonctionner, pourtant il ne reagis pas au touches
R: Cet emulateur n'est pas parfait. Certain jeux/demo demandent un fonctionnement R: Cet emulateur n'est pas parfait. Certain jeux/demo demandent un
tres proche de celui de la console originale, ce que TI-NESulator est encore loin fonctionnement tres proche de celui de la console originale, ce que TI-NESulator
d'arriver a faire est encore loin d'arriver a faire.
Q:J'ai des problèmes graphiques avec XXXX Q: J'ai des probl<62>mes graphiques avec XXXX
R:Cf réponse-ci dessus R: Cf rŽponse-ci dessus
Q: C'est lent :( Q: C'est lent :(
R: Désolé. Le code est toujours en cours de devellopement. Si vous trouvez trop lent, R: DŽsolŽ. Le code est toujours en cours de devellopement. Si vous trouvez trop
attendez la prochaine version une surprise vous y attendra peut-etre ! lent, attendez la prochaine version une surprise vous y attendra peut-etre !
7 -> En cas de problème 7 -> En cas de probl<EFBFBD>me
a) Un jeu indiqué compatible ne fonctionne pas (ie "Mapper non supporté") a) Un jeu indiquŽ compatible ne fonctionne pas (ie "Mapper non supportŽ")
Alors plusieurs possibilité, soit vous avez une autre version du jeu officielle Alors plusieurs possibilitŽ, soit vous avez une autre version du jeu officielle
ou non, cela peut changer par exemple le mapper utilisé par le jeux, soit vous ou non, cela peut changer par exemple le mapper utilisŽ par le jeux, soit vous
avez recuperer un "bad dump", c'est a dire plus simplement une rom foireuse. avez recuperer un "bad dump", c'est a dire plus simplement une rom foireuse.
Dans ces deux cas essayez d'en recuperer une autre version. Dans ces deux cas essayez d'en recuperer une autre version.
b) TI-NESulator à planté !! b) TI-NESulator ˆ plantŽ !!
Si cela arrive regulierement pour le meme jeu et au meme endroit faites moi un Si cela arrive regulierement pour le meme jeu et au meme endroit faites moi un
crash report avec les information que TI-NESulator vous met dans la console crash report avec les information que TI-NESulator vous met dans la console
(pour pouvoir la copier tranquillement il faut lancer a partir d'une console (pour pouvoir la copier tranquillement il faut lancer a partir d'une console
et pas faire glisser la rom sur l'executable) et pas faire glisser la rom sur l'executable)
N'oubliez pas de préciser le nom complet du jeu, la taille du fichier et toutes N'oubliez pas de prŽciser le nom complet du jeu, la taille du fichier et toutes
les infos que vous trouverez pertinante (manipulation a faire etc...) les infos que vous trouverez pertinante (manipulation a faire etc...)
8 -> Remerciement 8 -> Remerciement
PpHd pour PreOS, et SMA :) Loopy, Y0Shi, Marrat Fayzullin, et bcp d'autre pour la documentation technique
TiMad Membre de la XTeam sans lequel XLib existerait pas. sur la NES
nEUrOO Membre de la XTeam sans lequel XLib existerait pas.
Loopy, Y0Shi,
Marrat Fayzullin,
et bcp d'autre pour la documentation technique sur la NES
Ainsi que tout ceux que j'ai pu oublier Ainsi que tout ceux que j'ai pu oublier
9 -> Litérature 9 -> LitŽrature
[A faire.] [A faire.]
mais lien rapide : mais lien rapide :
http://www.nesdev.org http://nesdev.parodius.com/
http://nesdevwiki.org/
10 -> Comment me contacter ? 10 -> Comment me contacter ?
s
Vous pouvez me contacter grace au forum yAronet
http://www.yaronet.com
Et surtout grace au lien suivant : Vous pouvez me contacter grace au forum yAronet: http://www.yaronet.com
http://www.yaronet.com/posts.php?sl=&s=2339
Vous pouvez aussi me joindre par mail en m'écrivant à "godzil chez godzil point net" Et surtout grace au lien suivant : http://www.yaronet.com/posts.php?sl=&s=2339
Vous pouvez aussi essayer de visiter un de mes sites :
http://www.godzil.net Vous pouvez aussi me joindre par mail en m'Žcrivant ˆ
"godzil chez godzil point net"
Vous pouvez aussi essayer de visiter mon site : http://www.godzil.net
-------------------------------------------------------------------------------- --------------------------------------------------------------------------------
$Id$ $Id$

12
doc/TODO.txt
View File

@ -1,7 +1,15 @@
07/10/2007 V0.30 part 2 25/02/2008
- Finish th Quick6502 C project to merge it into TI-NESulator [ ]
- Extract graphic primitive to be less dependent of Allegro [ ]
- Rewrite sound engine [ ]
07/10/2007
- Remerge old PPU debug utilities in real plugin form [ ] - Remerge old PPU debug utilities in real plugin form [ ]
- Change the make util for UNIX. Maybe cmake ? [ ] - Change the make util for UNIX. Maybe cmake ? [ ]
- Cleanup os/win32 folder [ ] - Cleanup os/win32 folder [ ]
- Thinks about a better svn repository (Maybe a dedibox is a good choice?) - Thinks about a better svn repository (Maybe a dedibox is a good choice?)
[ ] [X]
--------------------------------------------------------------------------------
$Id$
--------------------------------------------------------------------------------