
                    TTTTTTT    OOOOO    7777777
                       T      O     O        7
                       T      O     O       7
                       T      O     O      7
                       T      O     O     7
                       T       OOOOO     7

                             EMULATEUR

                          Par Sylvain HUET
                       (huet@eis.enac.dgac.fr)
                       premiere version : 1994
                       derniere version : 1996

 README : notice d'utilisation

   VERSION 1.4
 ---------------

 Ce programme permet d'emuler le TO7 sous Msdos (avec Dos4gw). La version
ici presentee correspond a un TO7 avec stylo optique, manettes de jeu,
et lecteur de k7.
 Le TO7 est un ordinateur ouvert : la majeure partie de sa ROM (16ko)
est ammovible et se presente sous forme de cartouche.

I. INSTALLATION
-----------------

- simplement decompressez le fichier emuto7.zip
- si votre clavier est special, lancez 'enterkey' pour definir les 58 
touches du to7 ainsi que les 10 touches permettant d'emuler les manettes de
jeu. le fichier produit s'appelle "keyto7"
sinon, le package contient le "keyto7" standard. si vous avez un ordinateur
portable, renommez "keyto7.por" en "keyto7".

II. RECUPERATION DES ROMS
---------------------------

Il y a deux types de roms :
- la rom haute du to7 (de &he800 a &h7fff) : 6144 octets
- les cartouches memo7 (de &h0000 a &h3fff) : 16384 octets

Pour faire fonctionner l'emulateur, vous devez disposer de :
- la rom haute, sous forme d'un fichier 'romto7' de 6144 octets, place dans 
le repertoir Emuto7/
- au moins une cartouche, sous forme d'un fichier de 16384 octets. Il sera
commode de placer ces fichiers dans le repertoire /Emuto7

Pour recuperer les roms, deux moyens : utiliser un lecteur d'eprom (c'est le
seul moyen pour les cartouches de jeux), ou utiliser le lecteur de k7 de
votre to7. La procedure a suivre est alors la suivante (voir chapitre IV pour
les conseils d'utilisation de l'utilitaire 'wav2k7') - il vous faudra une
cassette audio, comme au bon vieux temps :
- pour recuperer la rom haute du to7 :
  + ressortir le lecteur de k7 de votre to7, placer la cartouche basic
  + allumer le to7 et taper la commande :
    . SAVEM"ROMTO7",&HE800,&HFFFF,0
  + puis digitaliser la k7 de maniere a former un fichier romto7.wav 
    (utiliser un utilitaire standard), echantillonner sur 8bits, mono, a 44kHz.
  + mettre ce fichier dans /Emuto7/tools
  + y lancer 'wav2k7 romto7.wav' ; ceci produit un fichier 'romto7.k7'
  + lancer 'getrom romto7.k7' ; ceci produit un fichier 'romto7.rom'
  + taper 'mv romto7.rom ../romto7'
- pour recuperer une cartouche du to7 :
  + ressortir le lecteur de k7 de votre to7, placer la cartouche basic
  + allumer le to7 et taper la commande :
    . SAVEM"MEMO7",0,&H3FFF,0
  + puis digitaliser la k7 de maniere a former un fichier memo7.wav 
    (utiliser un utilitaire standard), echantillonner sur 8bits, mono, a 44kHz.
  + mettre ce fichier dans /Emuto7/tools
  + lancer 'wav2k7 memo7.wav' ; ceci produit un fichier 'memo7.k7'
  + lancer 'getmemo7 memo7.k7' ; ceci produit un fichier 'memo7.rom'
  + le fichier 'memo7.rom' contient l'image de la cartouche, vous pouvez
    le deplacer et le renommer.
Les utilitaires se trouvent dans le repertoire Emuto7/tools


III. UTILISATION
-----------------

-lancer 'to7' avec les options suivantes :
  -k [nom] : specifier le fichier clavier ("keyto7" par defaut)
  -fastk7  : lecture directe des k7 (sans emulation du son)
  -nosound : pas de son
  -fast    : pas de ralentissement (vitesse maximum de l'emulateur)

-le programme lance le moniteur (en mode texte), qui permet de 
controler l'execution de l'emulateur.

-la rom basic est chargee automatiquement, a condition qu'elle soit presente 
dans le repertoire Emuto770/memo7. si vous souhaitez en charger une
autre, placez-vous dans le bon repertoire et tapez :
  -load [memo7]

-puis lancez l'emulateur par la commande 'go'

-a tout moment, vous pouvez suspendre l'execution de l'emulateur en appuyant 
 sur ESC. vous pouvez alors la reprendre au meme point en retapant 'go'

-pendant l'execution, le stylo optique est emule avec la souris, le bouton
 gauche correspondant a la pointe du stylo, la position de la souris est
 materialisee par un petit point

-vous pouvez faire un 'reset' en revenant au moniteur (ESC), et en tapant 
 'reset' (ce qui se contente de replacer le pc sur sa valeur initiale), 
 puis bien sur 'go'

-vous pouvez manipuler, depuis le moniteur, le lecteur de k7 de la maniere
 suivante :
 - k7 [nom]   : changer de fichier k7 (par exemple : k7 toto.k7)
 - seek [num] : positionner la bande sur une valeure particuliere (en hexa)
                seek seul sans numero donne la position courante de la bande

-les commandes dir, cd et pwd sont disponibles

-vous pouvez changer la vitesse de  l'emulateur a l'aide de la fonction 
 'speed', qui permet de regler une boucle de ralentissement


IV. RECUPERATION DE VOS VIEUX PROGRAMMES SUR K7
-------------------------------------------------

Un utilitaire permet de recuperer vos vieux programmes sur k7 : wav2k7,
place' dans Emuto7/tools (celui-ci est aussi utilise' pour recuperer les roms)
 Il suffit de proceder ainsi :
. creez un fichier toto.wav de l'enregistrement de votre programme sur
cassette, en 8bits, mono, a 44.1kHz, a l'aide de n'importe quel soft de 
type "enregistreur".
. lancez : wav2k7 toto.wav
. vous obtenez un fichier toto.k7, qui doit marcher si votre cassette est
encore en bon etat.
. en cas de probleme, assurez-vous que le volume d'enregistrement du .wav
etait suffisant, utilisez eventuellement un equaliseur, en poussant 
la bande 4,5kHz - 6,3kHz



V. AVERTISSEMENT
--------------------

 Malgre le travail que represente la creation d'un emulateur, celui que je 
vous livre est un freeware. Je ne demande aucune remuneration. Vous pouvez
modifier le source, a la seule condition de le mentionner lors de l'execution
(ajoutez un printf dans la fonction inimonitor() de monitor.c).

L'emulateur est egalement disponible sous Unix-Xwindow

N'hesitez pas a me contacter pour echanger de vieux souvenirs ou pour faire
part de tout probleme de compatibilite rencontre :

mail huet@eis.enac.dgac.fr





