******************************************************************************
                                F E L L O W
                          EMULATEUR DE COMMODORE AMIGA
                    Par Petter Schau (pettersc@ifi.uio.no)
           Documentation et FAQ par Brett Eden (revere@sub.net.au)
******************************************************************************

*** VEUILLEZ LIRE CE DOCUMENT AVEC ATTENTION AVANT D'EXECUTER FELLOW ***

Cette archive contient Fellow V0.3.1,

Cet mulateur a t crit par:

(C) Petter Schau en 1996/1997.  (pettersc@ifi.uio.no)

Ont galement contribu  la programmation:

(C) Roman Dolejsi 1997          (roman@sorry.vse.cz)
(C) David Voracek 1997          (assassin@paru.cas.cz)



Conditions pour l'utilisation et la distribution de cet mulateur:
------------------------------------------------------------------

Les droits sur ce logiciel sont dtenus par Petter Schau et les
contributeurs.

Vous tes autoriss  utiliser ce logiciel gratuitement.

La libre distribution est autorise, avec certaines restrictions.

Ce logiciel peut tre distribu librement tant que le contenu de cette
archive reste intact et inchang, et qu'aucun profit suprieur au prix
du support lui-mme n'est tir de la distribution.

La redistribution ne change pas les conditions sous lesquelles ce
programme peut tre utilis ou distribu.

Vous tes autoriss  inclure ce logiciel sur des CD-ROM avec d'autres
logiciels librement distribuables.

Toute distribution qui ne respecte pas le principe d'une distribution
sans profit doit faire l'objet d'une demande d'autorisation auprs des
auteurs de ce logiciel.

Cet mulateur est fourni tel quel, vous l'utilisez  vos risques et
prils. Aucune garantie expresse ou implicite n'est donne quant 
l'utilisation de ce logiciel, et l'auteur n'est soumis  aucune
obligation de fournir un quelconque support ou rparations en cas de
problme.

En utilisant ce logiciel, vous reconnaissez que l'auteur ne peut tre
reconnu responsable d'ventuels problmes lis  son utilisation.
Ceci est un logiciel exprimental utilis  vos risques et prils.


Les conditions dcrites ci-dessus s'appliquent galement  l'archive
contenant le code source de cet mulateur.

Les conditions supplmentaires portant sur le code source de
l'mulateur sont les suivantes:

Vous pouvez le modifier  loisir pour votre usage personnel.

Si un ajout ou une modification peuvent s'avrer utiles  d'autres
utilisateurs, nous aimerions beaucoup que vous nous envoyiez un patch
afin de l'inclure dans l'arbre officiel.

L'inclusion de parties du code source dans d'autres logiciels
distribuables librement est autorise du moment que les auteurs sont
prvenus au pralable et qu'ils sont crdits pour leur travail.


"AMIGA", "AmigaOS", "Kickstart" et "Workbench" sont des marques
dposes d'Amiga International. Les autres marques cites sont
dtenues par leurs propritaires respectifs.



Table des Matires:
------------------

1       INTRODUCTION
2       SYSTEME REQUIS
3       AVANT DE COMMENCER - PREREQUIS ESSENTIELS
3.1       Image Kickstart
3.1.1       Utiliser TransROM
3.2       Image Disque
3.2.1       Utiliser Transdisk
3.3       Copier des fichiers du PC -> AMIGA & AMIGA -> PC
4       EXECUTER FELLOW
5       MENU SYSTEME
5.1       Run
5.2       Soft Reset
5.3       Hard Reset
6       Debogueur
6.1       Step
6.2       Step over
6.3       Breakpoint
6.3.1       Set Breakpoint
6.3.2       Until Line 312
6.3.3       Until Event
6.4       Memory
6.5       Cia
6.6       IO
6.7       Trace on
6.8       Trace off
6.9      Show trace
6.10      Evlog config
6.11      Show evlog
7       CONFIGURATION
7.1       Disk
7.1.1       Diskimage in DF(x)
7.1.2       Drive (x) status
7.1.3       Disk-DMA speed
7.1.4       Alt-N cycling
7.1.5       File-requester
7.2       Screen
7.2.1       Screen resolution
7.2.2       Frame-skip ratio
7.2.3       Maximum frame-rate
7.2.4       Flicker-free interlace
7.2.5       Cycle exact drawing
7.2.6       Scale Y
7.3       Memory
7.3.1       Chip-memory
7.3.2       Fast-memory
7.3.3       Bogo-memory
7.3.4       Kickstart-image
7.3.5       Keyfile
7.4       Sound
7.4.1       Sound-emulation
7.4.2       Sound-quality
7.5       CPU
7.5.1       Cpu-type
7.5.2       Cpu-speed
7.6       Hardfile
7.6.1       Hardfile device state
7.6.2       Hardfile filename
7.7       Various
7.7.1       Joystick Port 1 & 2
7.7.2       Power Floppy Leds
7.7.3       Performance displayed on-screen
7.7.4       Menu-position saving on exit
7.7.5       Automatic run after commands
8           INTERFACE LIGNE DE COMMANDE
9           PETIT GUIDE DE DEMARRAGE
10          RACCOURCIS CLAVIER
10.1          Raccourcis dans l'interface utilisateur
10.2          Raccourcis pendant l'mulation



1 Introduction
---------------

Bienvenue dans Fellow, un mulateur de Commodore Amiga pour les PC
compatibles. Cette documentation traite des caractristiques et de
l'utilisation de Fellow 0.3.1. Vous y trouverez galement des
informations sur sa configuration et son utilisation optimale. Fellow
est un mulateur logiciel.

Fellow est similaire  UAE, un autre mulateur Amiga crit par Bernd
Schmidt avec l'aide d'autres contributeurs. Fellow est diffrent dans
le sens o il a t crit spcifiquement pour MS-DOS, et en
assembleur x86 pour certaines routines dont la vitesse est
dterminante. De ce fait, Fellow jouit d'un avantage indiscutable en
rapidit par rapport  UAE. Cependant, UAE prsente de nombreuses
caractristques au niveau de l'mulation de l'OS Amiga qui manquent
encore  Fellow  ce jour.

Le fonctionnement de Fellow est trs similaire  celui d'UAE. Si vous
avez dj utilis UAE, Fellow ne devrait vous poser aucun probleme. Si
vous voulez en savoir plus sur l'mulation Amiga, vous tes
vivement encourags  lire la documentation de UAE, vous y trouverez
beaucoup d'information ne figurant pas ici.




2 SYSTEME REQUIS
----------------

Pour pouvoir excuter Fellow, votre systme doit au minimum rpondre
aux spcifications suivantes:

* Un ordinateur compatible IBM PC avec un processeur 486 ou plus rapide
* MS-DOS version 5.00 ou suprieure
* 11 Mo de RAM
* Une carte video compatible VGA
* Une souris

Il est RECOMMANDE de possder au minimum le matriel ci-dessous pour
profiter au maximum de Fellow:

* Un ordinateur compatible IBM PC avec un processeur 486 100 MHz ou plus
  rapide
* MS-DOS version 5.00 ou suprieure
* 16-20 Mo de RAM (peut utiliser jusqu' 28 Mo si disponibles)
* Une carte vido PCI compatible (S)VGA avec support VBE 2.0
* Une carte son Soundblaster ou compatible

* En option, un processeur MMX dans certains cas.

Si votre carte video ne supporte pas les Extensions VESA BIOS 2.0, vous
devez vous procurer un driver VBE 2.0 sous DOS pour votre carte video
(essayez de visiter la page web du fabricant), ou Scitech Display
Doctor, disponible sur le net.

Si votre carte ne supporte pas VBE 2.0, certaines rsolutions d'cran
ne seront pas disponibles quand vous excuterez Fellow!

Fellow est assez gourmand en CPU, et si vous voulez que vos programmes
Amiga aux graphismes intensifs s'excutent  la vitesse d'un "vrai
Amiga", vous aurez besoin d'un Pentium 133-150 et d'une carte video PCI
rapide. D'autres facteurs influencent galement le rsultat, comme une
RAM rapide (sachant que le temps d'accs est de 12ns pour de la RAM
DIMM, et de 60ns et 70ns pour les barettes SIMM -EDO ou non EDO
respectivement).


3 AVANT DE COMMENCER - PREREQUIS ESSENTIELS
-------------------------------------------

Avant de pouvoir utiliser Fellow, vous aurez besoin de 2 choses: une
image Kickstart et une image disque.


3.1 Image Kickstart
-------------------

C'est une copie d'une ROM Kickstart AmigaDOS, prleve sur un VRAI
Amiga. Ce fichier est extrait au moyen d'un programme appel
"TransROM", qui est inclus dans Fellow. Kickstart tant un logiciel
appartenant  Amiga International et protg par copyright, il est
bien sr impossible de l'inclure dans l'mulateur. Il vous faut copier
ce logiciel  partir de l'Amiga que vous possdez.


3.1.1 Utiliser TransROM
-----------------------

TransROM doit tre copi sur un vrai Amiga afin de faire une copie de
la ROM Kickstart dans un fichier.


CLI> transrom >RAM:kick.rom

Copiera la ROM dans un fichier appel "kick.rom" situ en RAM:. Ce
fichier doit alors tre copi sur un PC, dans le rpertoire de Fellow
(bien qu'il soit possible de l'appeler  partir d'un rpertoire
diffrent).



3.2 Image Disque
-----------------

Vous aurez galement besoin de l'"image" d'une vraie disquette Amiga,
contenant le jeu/dmo que vous voulez excuter sous Fellow. Vous
l'obtiendrez en utilisant un programme nomm "transdisk", galement
inclus dans Fellow.

Une image disque est un fichier contenant les donnes normalement
stockes sur une disquette.

Un lecteur de disquettes PC ne peut pas lire des disquettes Amiga, donc
pour utiliser Fellow vous DEVEZ avoir l'image disque d'une disquette
Amiga.


3.2.1 Utiliser Transdisk
------------------------

Comme TransROM, il faut copier Transdisk sur un vrai Amiga pour
pouvoir s'en servir.

Transdisk s'excute  partir du prompt du shell AmigaDOS, et copie une
disquette, piste par piste, dans un fichier (qui peut tre lu par
Fellow).

CLI> transdisk >RAM:df0.adf

Fabriquera une image de la disquette prsente dans DF0:. Le nom df0.adf
n'est pas obligatoire, vous pouvez utiliser le nom de votre choix.


3.3 Copier des fichiers du PC -> AMIGA & AMIGA -> PC
----------------------------------------------------

1. Vous pouvez faire des transferts Zmodem entre un Amiga et un PC 
l'aide d'un cble null-modem. Il suffit de connecter le cble aux port
srie de chaque machine, de charger un programme de terminal comme
Terminus, NComm ou Term sur l'Amiga, ou Terminate, Telemate, Telix (ou
HyperTerminal pour Windows 95 si vous insistez) sur le PC. Initialisez
alors un upload Zmodem sur l'Amiga. Si votre configuration est correcte
(la rception Zmodem automatique ct rcepteur devrait tre active),
le PC acceptera automatiquement la transmission, et dchargera le
logiciel sur votre disque dur.


Pour de meilleurs rsultats, procurez-vous un exemplaire du
priphrique srie de remplacement BaudBandit pour l'Amiga, et
configurez les deux cts  57,600 Baud. BaudBandit devrait permettre
d'atteindre des transferts jusqu' 5500cps vers/ partir d'un Amiga 
base de 68000 - ce programme est disponible sur AmiNET.


Si vous tes avez un A500 avec AmigaOS 1.2/1.3 et un seul lecteur de
disquette, vous pourriez bien tre dans la panade. A moins d'avoir un
logiciel de Terminal sur un disquette que vous pouvez booter ou
utiliser sur un second lecteur, vous n'avez aucun moyen d'utiliser un
cble null-modem pour communiquer avec le PC (condition essentielle
pour transfrer des programmes comme transdisk ou transrom sur une
disquette Amiga). Une faon de vous en sortir serait de contacter un
groupe d'utilisateurs d'Amiga, qui pourraient vous fournir une telle
disquette, ou un distributeur de shareware Amiga prs de chez vous.

Note: Certains Amigas permettent de verrouiller le port srie  115,200
bauds. Ceci dpend largement de la machine, de la rvision de sa carte
mre, et de son processeur. En verrouillant le port srie  115,200
bauds  la fois sur l'Amiga et le PC, vous pouvez rellement transfrer
des fichiers par cble null-modem  plus de 10,100cps.



2. Si vous n'avez pas de cble null-modem, ou qu'en possder ne vous
intresse pas particulirement, vous pouvez transfrer le logiciel
Amiga vers le PC en utilisant une disquette PC 720k. Workbench 2.1+ est
livr avec CrossDOS, qui est un logiciel permettant de lire des
disquettes PC 720k dans le lecteur de disquettes de votre Amiga. Si
vous n'avez pas CrossDOS (si vous n'avez pas Workbench 2.1 ou
suprieur), vous pouvez galement utiliser MessyDOS, disponible sur
Aminet. Voici un guide pas  pas du transfert de logiciel par
disquette.

     i) Formattez une disquette PC 720k sur votre PC ou sur votre Amiga
     en utilisant CrossDOS.

     ii) Crez un fichier .ADF ou une image de la ROM Kickstart avec la
     mthode ci-dessus.

     iii) Compressez ce fichier en utilisant Lha ou Zip (assurez-vous
     que ces programmes sont sur le PC, afin de pouvoir les
     dcompresser par la suite)

     iv) Copiez cette archive sur la disquette 720k, en utilisant
     CrossDOS ou MessyDOS.

     v) Transportez la disquette jusqu'au PC, copiez l'archive sur le
     disque dur, et dcompressez-la. Copiez l'image Kickstart ou le
     fichier .ADF dans le rpertoire de Fellow et c'est parti.



4 EXECUTER FELLOW
-----------------

Fellow s'excute en appelant simplement FELLOW.EXE  partir du prompt
DOS. Aprs avoir entr la commande, vous verrez apparatre un cran de
menu: l'interface utilisateur. La partie au milieu prsente des
informations sur les disques actuellement affects aux lecteurs de
disquettes, et sur la prsence ventuelle d'une ROM Kickstart.



5 MENU SYSTEME
--------------

La partie infrieure droite de l'cran contient le menu systme.
Utilisez les flches curseur pour parcourir les menus, et appuyez sur
Entre pour en slectionner un. Des raccourcis clavier, en surbrillance
verte, sont galement disponibles. La touche ESC vous fait remonter
d'un niveau de menu.

Le menu systme est divis comme suit:

Run                     (Excuter)
Debugger                (Dbogueur)
Configuration
Soft Reset              (Remise  zro logicielle)
Hard Reset              (Remise  zro matrielle)
Quit                    (Sortie)


Le dbogueur et la configuration font l'objet de chapitres distincts
plus loin.


5.1 "Run"
---------
Excuter

Cette option dmarre l'mulation Amiga, l'mulateur essayant de booter
sur l'image disque affecte au lecteur DF0:.



5.2 "Soft Reset"
----------------
Remise  zro logicielle

Cette option remet l'Amiga mul  zro. Le Soft Reset devrait
prserver le contenu de la mmoire et permettre aux programmes
rsidents de survivre, bien que je ne sois pas sr  100% que cette
option se conduise bien comme prvu. Le Soft Reset peut se rvler
instable et provoquer une GURU Meditation ou quelque chose du mme
acabit si l'Amiga est victime des assauts d'un mchant programme.

Si aucun Kickstart n'est charg, un bootstrap de remplacement sera
utilis pour la disquette insre dans DF0. Dans certains cas il est
possible de booter des programmes n'ayant pas besoin des routines
Kickstart pour fonctionner. Si l'image disque est change avant de
lancer l'mulation et aprs le reset prcdent, il faut refaire un
reset.


5.3 "Hard Reset"
----------------
Remise  zro matrielle

Cette option efface la totalit de la mmoire (Amiga) et rinitialise
l'mulation.

Si aucun Kickstart n'est charg, ceci activera le bootstrap de
remplacement pour la disquette insre dans DF0.

Si aucun Kickstart n'est charg, un bootstrap de remplacement sera
utilis pour la disquette insre dans DF0. Dans certains cas il est
possible de booter des programmes n'ayant pas besoin des routines
Kickstart pour fonctionner. Si l'image disque est change avant de
lancer l'mulation et aprs le reset prcdent, il faut refaire un
reset.


6 DEBOGUEUR
-----------

Un utilisateur ordinaire n'aura probablement jamais  utiliser le
dbogueur, donc si vous ne comprenez pas les explications ci-dessous,
sautez simplement cette partie.

Le dbogueur est un environnement simple dans lequel on peut entre
autres choses examiner l'tat de l'Amiga mul. Il contient un
dsassembleur basique qui montre le code entourant le compteur du
programme, et l'tat du processeur Motorola 68000 mul. On peut
excuter les instructions pas  pas ou jusqu' un point d'arrt. La
mmoire peut tre examine, ainsi que certains registres des chips
spcifiques Amiga. Des fonctions de trace sont galement disponibles
(aprs compilation (*).)

Le sous-menu du dbogueur est divis comme suit:

Step
Step Over
Breakpoint
Memory
Cia
Wav Capture
Trace on (*)
Trace off (*)
Show trace (*)
Evlog config (*)
Show evlog (*)


6.1 "Step"
----------

Excute l'instruction suivante (avance d'une instruction)


6.2 "Step over"
---------------

Place un point d'arrt sur l'instruction suivante, et l'mulateur
s'excute jusqu' cette instruction (utile pour passer les boucles et
les instructions jsr/bsr).


6.3 "Breakpoint"
----------------

Cette option appelle un autre sous-menu; l'mulateur s'excute jusqu'
ce que la condition slectionne soit remplie.

Le sous-menu est divis comme suit:

Set Breakpoint
Until line 312
Until Event


6.3.1 "Set Breakpoint"
----------------------

Vous permet d'entrer l'adresse de l'instruction qui agira comme point
d'arrt. L'excution dmarre quand le point d'arrt est regl.


6.3.2 "Until Line 312"
----------------------

Le programme s'excute jusqu' atteindre la ligne 312 (position du
faisceau).


6.3.3 "Until Event"
-------------------

Le programme s'excute jusqu' ce qu'un venement mmoris survienne.
Les vnements  mmoriser sont dfinis dans l'option "Evlog config"
situe dans le premier niveau du menu du dbogueur.


6.4 "Memory"
------------

Affiche la mmoire. Vous pouvez vous dplacer avec les flches de
curseur haut et bas et Page Prcdente/Suivante. Les touches "h" et "a"
affichent le format hexadecimal ou ascii.



6.5 "Cia"
---------

Affiche l'tat des registres des circuits CIA.


6.6 "IO"
--------

Affiche l'tat des registres des chips spcifiques Amiga. Cette option
appelle un sous-menu dans lequel on peut slectionner les registres de
diffrentes units.

6.7 "Trace on"
--------------

Active l'historique des instructions CPU. Les 500000 dernires
instructions seront mmorises.


6.8 "Trace off"
---------------

Dsactive l'historique des instructions CPU.


6.9 "Show trace"
----------------

Affiche l'historique des instructions CPU.


6.10 "Evlog config"
-------------------

Active et configure la mmorisation d'vnements, on peut tracer les
interruptions et les exceptions.


6.11 "Show evlog"
-----------------

Affiche les vnements mmoriss.


7 CONFIGURATION
---------------

Le menu de configuration est divis en sous-menus, qui vous permettent
de modifier diffrents paramtres de l'mulation.


7.1 "Disk"
----------
Disque

Ce sous-menu contrle divers aspects de la configuration de l'image
disque.

7.1.1 "Diskimage in DF(x)"
--------------------------
Image disque dans DF(x)

(x) tant compris entre 0 et 3.

Ces options vous permettent d'affecter des images disques  n'importe
lequel des 4 lecteurs de disquettes de l'Amiga.

Si vous dsirez booter sur une disquette au dmarrage de l'mulation,
celle-ci doit obligatoirement tre affecte  DF0:.

La touche Supr. permet d'jecter l'image disque du lecteur virtuel.

Les touches ALT-0  9 permettent d'insrer dans le lecteur virtuel le
fichier dont le nom est stock dans une des 10 mmoires (ces touches
sont expliques plus loin, dans la slection de fichier).

Les images disque compresses avec gzip ou bzip seront dcompresses
dans le rpertoire temporaire dfini par les variables d'environnement
TEMP ou TMP. Les modifications faites  ces fichiers seront perdues,
puisque seules les images temporairement dcompresses seront
modifies.



7.1.2 "Drive (x) status"
------------------------
Statut Drive (x)

(x) tant compris entre 0 et 3.

Ces options vous permettent de dsactiver les lecteurs afin que l'Amiga
ne les dtecte pas. Le but tant qu'AmigaOS n'allouera pas de buffer
pour le lecteur, ce qui libre ainsi quelques KiloOctets pour une autre
utilisation.

L'utilisation principale de cette option est de permettre l'excution
d'anciennes dmos qui taient compresses avec des cruchers casss.

En utilisation normale, laissez les lecteurs activs.


7.1.3 "Disk-DMA speed"
----------------------
Vitesse DMA disque

Vous permet de choisir la vitesse de lecture des fichiers
disques virtuels par le lecteur de disquettes. Les accs disques
taient lents  l'origine, mais l'mulation permet de les acclerer
grandement.

Les valeurs possibles sont "Original" (vitesse originale) and "Fast"
(rapide).

Souvenez-vous cependant que certains programmes ne marcheront qu'avec
une vitesse DMA "Original".


7.1.4 "Alt-N cycling"
---------------------
Rotation Alt-N

Controle l'endroit o ira le curseur si on appuie sur Supr., ou si une
image disque est affecte  une mmoire.


7.1.5 "File-requester"
----------------------
Slection de fichier

La slection de fichier est active quand on choisit l'option
"Diskimage in DF(x)". Parcourez vos rpertoires et slectionnez l'image
 insrer avec Entre.

Quelques fonctions spciales:

Quickfind (recherche rapide) : Tapez le dbut du nom d'un fichier, et
            le curseur se dplacera sur le nom le plus proche.

ALT-(x) :   Affiche le contenu du rpertoire courant du lecteur x:


Mmorisation:

Lorsque le curseur est sur un nom de fichier, vous pouvez appuyer sur
ALT- 0   9 pour mmoriser son nom et le rcuprer plus tard, comme
expliqu plus haut.

La combinaison ALT- | (alt + pipe) efface tous les noms mmoriss.

7.2 "Screen"
------------
Ecran

Ce menu permet de choisir les paramtres graphiques de l'mulation.

7.2.1 "Screen resolution"
-------------------------
Rsolution de l'affichage

Contrle quelle rsolution de la machine hte sera utilise par
l'mulateur. Les rsolutions dpendent des possibilits de votre
pilote VESA.

7.2.2 "Frame-skip ratio"
------------------------
Frquence des trames ignores

Contrle  quelle frquence est rafrachi l'cran. Un rapport de
1/1 rafrachit l'cran aussi souvent que possible.

Des rapports plus faibles auront pour effet de saccader les animations,
etc., mais conomiseront beaucoup de temps machine qui pourra tre
consacr  d'autres tches de l'mulation.


7.2.3 "Maximum frame-rate"
--------------------------
Taux maximum de rafrachissement des trames

Contrle les limites en temps imposes  l'mulateur.

"Unlimited" (illimit) dsactivera tout contrle des temporisations, et
l'mulateur s'excutera aussi rapidement que possible. Ceci affecte
galement la vitesse de rptition des touches. Choisir une vitesse
trop leve peut rendre l'utilisation du clavier impossible.

"50 hz" limite la vitesse  celle d'un A500 PAL normal.

"Synch with VGA-card" (synchrone  la carte VGA) tentera de
synchroniser l'affichage au rafraichissement de la rsolution VGA
utilise. Dans certains cas, le rsultat peut tre parfaitement fluide.
Etant donn que le taux de rafraichissement du PAL n'est presque jamais
gal  celui des modes VGA, le rsultat sera le plus souvent une
dgradation de la vitesse de l'mulation sonore et de l'application en
gnral.

Ce paramtre est ignor lorsque l'mulation sonore est synchronise 
l'mulation.

7.2.4 "Flicker-free interlace"
------------------------------
Entrelacement sans scintillement

Ce paramtre, quand il est activ, tentera de dsentrelacer un cran
Amiga entrelac.

Ceci n'est valide que quand l'mulateur utilise un cran SVGA 800x600.


7.2.5 "Cycle exact drawing"
---------------------------
Trac cyclique exact

Option trs exprimentale. Quand elle est active, des effects tels que
l'effet plasma seront muls correctement.

NOTE: Garder cette option constamment active n'a aucun sens. Elle
demande encore beaucoup de rglages et de travail pour fonctionner
correctement et sans danger. La meilleure faon de l'utiliser est de ne
l'activer que pour regarder un effet particulier.


7.2.6 "Scale Y"
---------------
Echelle Y

Cette option permet  la carte VGA d'afficher l'cran Amiga avec un
meilleur aspect (rapport horizontal/vertical). Ceci ne concerne que
certaines rsolutions (800x600, 640X480, 640x400, 640x350).


N'utilisez pas cette option si votre carte est compatible VESA mais
n'est pas compatible avec les registres VGA.



7.3 "Memory"
------------
Mmoire

Ce menu contrle la configuration de la mmoire dont l'Amiga mul
dispose.

7.3.1 "Chip-memory"
-------------------
Mmoire chip

Cette option permet de choisir la quantit de RAM chip mule. Les
valeurs autorises vont de 256kB  2048 kB.


7.3.2 "Fast-memory"
-------------------
Mmoire rapide

Cette option permet de choisir la quantit de RAM rapide mule. Les
valeurs autorises sont 0, 1, 2, 4 et 8 MB.


7.3.3 "Bogo-memory"
-------------------
Mmoire lente

Cette option permet de choisir la quantit de RAM lente (Bogo) mule.
Ce troisime type de mmoire correspond aux cartes d'extension mmoire
qui se connectaient dans l'ouverture situe dans le fond des Amiga 500.
Les valeurs autorises vont de 0  1792 kB.



7.3.4 "Kickstart-image"
-----------------------
Image Kickstart

Permet de dfinir l'emplacement de l'image de la ROM AmigaOS
(ncessaire pour excuter les programmes qui lancent Workbench, ou pour
Workbench mme). Cette option appelle un menu simple de slection
de fichier, dans lequel vous devrez choisir le fichier ROM.
Par dfaut, Fellow recherche le fichier "kick.rom".

Ces fichiers doivent avoir l'extension .rom .


7.3.5 "Keyfile"
---------------
Ficher cl

Pour spcifier le fichier cl utilis pour dverouiller les Kickstarts
encrypts.



7.4 "Sound"
-----------
Son

Ce sous-menu permet de configurer l'mulation du son.
Il est impossible d'muler le son si aucune carte sonore n'est dtecte.


7.4.1 "Sound-emulation"
------------------------
Emulation sonore

Slectionne le type de l'mulation sonore. Les possibilits sont:

"No sound"             - Aucun son: le son n'est ni mul ni diffus
"Emulated, not played" - Le son est mul mais n'est pas diffus

Ces deux choix sont toujours disponibles.

Les options suivantes ne sont disponibles que quand une carte sonore
(Soundblaster) a t dtecte:

"Normal, synchronized with emulation" - Normal, synchronis avec
                                        l'mulation, c'est la mthode
                                        de restitution la plus fidle
"Normal, synchronized with real-time" - Normal, synchronis avec le
                                        temps rel, cette option
                                        fonctionnera peut-tre sur des
                                        systmes plus lents, mais la
                                        vitesse de restitution peut
                                        varier normment. Dans tous
                                        les cas, le son sera presque
                                        synchronis  l'image.

L'option "Normal, synchronized with emulation" est recommande.


L'utilisation de l'option "Normal, synchronized with real-time" peut
causer d'importantes distorsions sonores. La vitesse sera incorrecte et
peut galement varier de faon importante, elle dpend de faon directe
de la vitesse de l'mulation. La mthode utilise pour implmenter
cette option fonctionne bien sur des Pentiums, en revanche les cpu AMD
K6 ont une trs mauvaise raction en terme de vitesse.



7.4.2 "Sound-quality"
---------------------
Qualit sonore

Permet de dterminer la qualit sonore. Diffrentes modes
d'chantillonage sont disponibles selon la Soundblaster que vous
possdez: 8-16bits, mono/stereo.

NOTE: slectionner 44100 hz n'apporte aucun avantage et engloutira
allgrement vos cycles cpu.

31300 hz semble un bon compromis vitesse/qualit.
Il n'y a que trs peu de diffrence de vitesse entre les modes 8/16
bits mono/stereo.


7.5 Cpu
-------

Ce sous-menu permet de configurer l'mulation de la CPU.


7.5.1 "Cpu-type"
----------------
Type de CPU

Pour l'instant, seule l'option 68000 est fonctionnelle. L'option 68030
est en cours de dveloppement. On peut la slectionner mais elle est
inutilisable.



7.5.2 "Cpu-speed"
-----------------
Vitesse CPU

Contrle la vitesse virtuelle de la CPU mule. A ne pas confondre avec
les performances relles.

Les possibilits sont "original", qui correspond  une cpu cadence
 7.14 MHz, et "fast" (rapide), qui correspond  une cpu cadence  28
MHz (l'option rapide permet galement d'excuter les oprations Blitter
immdiatement sans pnaliser la temporisation).


7.6 "Hardfile"
--------------
Fichier disque dur

Ce sous-menu contrle les fichiers de disque dur.

Un fichier de disque dur permet de fournir une mmoire de masse  un
Amiga mul. C'est un trs gros fichier qui est utilis comme un disque
dur. Il peut avoir n'importe quelle taille.

Les fichiers disque dur ne peuvent tre utiliss que si la version de
votre kickstart est gale ou suprieure  v2.0.

Souvenez-vous qu'il faut formater un nouveau fichier disque dur.

Vous pouvez booter  partir de n'importe quel fichier de disque dur -
ils ont une priorit au dmarrage infrieure  DF0, mais suprieure 
DF1.


Vous pouvez aussi utiliser des fichier ADF non compresss  la place de
fichiers de disque dur.

Les units sont appelles FELLOW0, FELLOW1...

NOTE: Si vous changez le setup du fichier de disque dur, un hard reset
sera fait automatiquement.


7.6.1 "Hardfile device state"
-----------------------------
Etat du priphrique fichier de disque dur

Les fichiers de disque dur peuvent tre activs ou dsactivs.

7.6.2 "Hardfile filename"
-------------------------
Nom du fichier de disque dur.

Cette option permet de slectionner le fichier (fichier de disque dur
ou fichier ADF) que vous voulez utiliser.


7.7 "Various"
-------------
Divers

Ce sous-menu contient d'autres paramtrages.


7.7.1 "Joystick Port 1 & 2"
---------------------------

Pour controller les ports joysticks de l'Amiga.

Les options sont:

Disabled (dsactiv), Mouse (souris), Analog Joystick (joystick
analogique), Keyboard Joystick Replacement 1 & 2 (remplacement
clavier des joysticks 1 & 2).

Les remplacements clavier des joysticks 1 & 2 sont:

Flches curseur, CTRL droit pour bouton 1 et ALT droit pour bouton 2

ou

'D' gauche, 'F' bas, 'G' droite, 'R' haut, CTRL gauche bouton 1, ALT
gauche bouton 2.


Le maniement du joystick analogique n'est pas trs ais. Pour le
calibrer, faites tourner la manette pendant l'mulation.

Si vous trouvez l'mulation du joystick analogique de Fellow
insuffisante, vous pouvez vous procurer Joyemu, qui gre bien mieux le
joystick analogique (vous trouverez Joyemu  l'adresse
http://www.dsi.unive.it/~szanella/index.htm )


7.7.2 "Power Floppy Leds"
-------------------------
Leds Marche - Lecteur

Pour dfinir l'emplacement de l'affichage de diverses leds, telles que
la led de marche/arrt et les leds des lecteurs de disquette.

Il est galement possible d'ajouter une carte de leds (ajout de Roman
Dolejsi). Voir ledboard.txt.


L'option "Keyboard led order" permet de dfinir l'ordre des leds sur
votre clavier.


7.7.3 "Performance displayed on-screen"
---------------------------------------
Affichage des performances  l'cran

Affichage le rapport entre la vitesse de l'Amiga mul et celle d'un
Amiga rel, pour lequel on prend une vitesse de 50 trames/seconde. Ce
rapport est affich en haut et  droite de l'affichage Fellow.

Ce chiffre est approximatif.


7.7.4 "Menu-position saving on exit"
------------------------------------
Sauvegarde de la position des menus en quittant

Cette option est encore exprimentale. Elle permet de mmoriser les
mouvements qui ont t faits dans les menus, pour les restituer lors du
dmarrage suivant de l'mulateur.


7.7.5 "Automatic run after commands"
------------------------------------
Excution automatique aprs les commandes

On peut activer une excution automatique aprs certaines commandes.


8  INTERFACE LIGNE DE COMMANDE
------------------------------


Les options de configuration peuvent galement tre entres sur la
ligne de commande.

Voici une brve liste de ces options, reportez-vous aux explications
des paramtres correspondants dans la partie Interface utilisateur.


Paramtres divers:

-h                         Affiche cette liste
-log                       Gnre un rapport  l'initialisation
                           Utile pour voir le matriel dtect par
                           l'mulateur
-nogui                     Dsactiver l'interface utilisateur au
                           dmarrage
-config file               Pour utiliser un autre fichier que celui par
                           dfaut, fellow.cfg dans le rpertoire courant.
-ns                        Pour ne pas sauvegarder la configuration en
                           quittant


Configuration images disque:

-0 fichier                 fichier disque dans df0
-1 fichier                 fichier disque dans df1
-2 fichier                 fichier disque dans df2
-3 fichier                 fichier disque dans df3
                           Voir section 7.1.1

-0e +|-                    Active/dsactive df0
-1e +|-                    Active/dsactive df1
-2e +|-                    Active/dsactive df2
-3e +|-                    Active/dsactive df3
                           Voir section 7.1.2

-ds +|-                    Active/dsactive le DMA disque rapide
                           Voir section 7.1.3

-dmX file                  Contenu de la mmoire disque X (0..9)
                           Voir section 7.1.4

-dchemin rpertoire/fichier
                           Chemin du disque actif. La slection de
                           fichier dmarrera sur ce chemin/fichier  la
                           premire utilisation.

-rmpos +|-                 Active/dsactive la mmorisation de la
                           position des menus en quittant
                           Voir section 7.7.4

-mpos /../...              Spcifier la position du menu actif
                           Described in 7.7.4


Configuration fichier disque dur:

-hf fichier                Nom du fichier disque dur, voir 7.6.2
-he +|-                    Active/dsactive le fichier de disque
                           dur, voir 7.6.1
-hi taille                 Cre (met  zro!) le fichier de disque dur
                           spcifi, la taille est dfinie en Mo.


Configuration mmoire:

-c taille                  Quantit de mmoire chip, taille*256k,
                           valeur par defaut: 2Mo, voir en 7.3.1
-fm taille                 Quantit de mmoire rapide, en Mo (0, 1, 2,
                           4, 8), voir en 7.3.2
-b taille                  Quantit de mmoire lente, taille*256k,
                           valeur par dfaut : 1.75MB, voir en 7.3.3
-r fichier                 fichier contenant Kickstart, voir en 7.3.4
-K fichier                 Fichier cl pour Kickstart encrypt, voir
                           en 7.3.5

Configuration Joystick:

-j1 n|a|m|k1|k2
-j2 n|a|m|k1|k2            Port joystick 1 ou 2:
                           n - aucun, a - Joystick Analogique
                           m - souris, k1 - replacement clavier 1
                           k2 - replacement clavier 2
                           Voir en 7.7.1


Configuration sonore:

-s d|n|c|e                 d - dsactiv n - normal c - continu
                           e - emul, non diffus
                           Voir en 7.4.1
-sf frqence               Frquence: 44100,31300,22050,15650
-ss on|off                 Stereo, marche ou arrt
-sb bits                   8 ou 16 bits

-sf,ss,sb                  voir en 7.4.2

-s1                        Force le pilote Soundblaster V1.0


Configuration de l'cran:

-res 320200b|320200|320240|640350|640400|640480|800600
                           Rsolution, dfaut: 800600
                           Voir en 7.2.1
-v none|50|vga             Limite frquence rafraichissement cran:
                           none (aucun), 50 - 50hz, vga - en fonction
                           de la carte VGA
                           Voir en 7.2.3

-f nombre                  Ignorer une frame sur (nombre). Voir en 7.2.2
-i on|off                  Dsentrelacement en rsolution 800x600
                           Voir en 7.2.4


Configuration CPU:

-cpu 0|3                   Type CPU: 0 - 68000  3 - 68030
                           Voir en 7.5.1
-cs normal|max             Vitesse d'horloge du M68000 mul et du
                           Blitter. Voir en 7.5.2


Configurations diverses:

-p on|off                  Affichage de la vitesse  l'cran. Voir en
                           7.7.3
-l scr|kb?|lp?|lp?m|off    Indicateurs led:
                           scr - l'cran (800x600 seulement)
                           kb1 - sur le clavier (lecteurs 0, 1, 2)
                           kb2 - sur le clavier (marche, lecteurs 0, 1)
                           kb3 - sur le clavier (marche, lecteurs 0+1,
                           2+3)
                           lp1/2/3 - sur la carte led sur le port
                           parallle
                           lp1/2/3m - sur la carte led sur le port
                           parallle (invers)
                           Voir en 7.7.2
-lk ncs|nsc...             Utiliser les leds sur le clavier PC dans
                           l'ordre spcifi (Verr Num = N, Verr Maj =
                           C, Arrt dfil = S)
                           Voir en 7.7.2

-altn 1..4                 Boucle Alt-N sur les lecteurs
                           Voir en 7.7.4
-arun none|altn|res        Execution automatique aprs les commandes
                           Voir en 7.7.5


9 PETIT GUIDE DE DEMARRAGE
--------------------------

Une fois que vous avez copi une disquette Amiga dans un fichier .adf
et que vous l'avez transfr sur votre PC, dmarrez Fellow et affectez
cette image disque au lecteur DF0:.

Si c'est une disquette du Workbench, assurez-vous d'avoir copi votre
ROM kickstart et de l'avoir plac dans le rpertoire de Fellow sous le
nom "kick.rom",  moins d'avoir choisi un autre rpertoire/nom dans le
menu de configuration.


En l'absence de Kickstart, Fellow n'utilisera pas le bootstrap Amiga
normal et essaiera de booter quand mme. Cela marche avec quelques
dmos et jeux qui n'utilisent pas les routines de Kickstart et qui se
dbrouillent tous seuls. Un reset peut s'avrer ncessaire aprs avoir
insr un fichier disque.

Choisissez la quantit de RAM dsire, configurez l'mulation sonore en
fonction de votre matriel, et choisissez "RUN" dans le menu principal.

Si tout va bien, Fellow devrait booter votre image disque.


10 RACCOURCIS CLAVIER
---------------------

Des raccourcis claviers sont disponibles dans l'interface utilisateur
et pendant l'mulation.

10.1 Raccourcis clavier dans l'interface utilisateur
----------------------------------------------------

     F5: Soft Reset
     F7: Hard Reset
     F9: Start
    F11: Debugger
  Alt-D: Configuration lecteurs de disquette
  Alt-F: Rapport de trames ignores
  Alt-H: Configuration fichier disque dur
  Alt-J: Configuration joystick
  Alt-L: Configuration LED
  Alt-M: Configuration mmoire
  Alt-R: Configuration de la rsolution
  Alt-S: Configuration sonore
  ESC  : Remonte d'un niveau dans les menus, dmarre l'mulation quand
         on est dans le menu le plus haut.


10.2 Raccourcis clavier pendant l'mulation
-------------------------------------------

F12                     - Retour  l'interface utilisateur.
HOME + PGUP/PGDOWN      - change la rsolution.
HOME + flches pav numrique
                        - centre l'affichage dans les modes VGA basse
                          rsolution
HOME + F11              - Capture l'cran dans un fichier BMP.
HOME + F1/F2/F3/F4      - Insre l'image disque dans le lecteur
END  + F1/F2/F3/F4      - Ejecte l'image disque du lecteur
END  + PGUP/PGDOWN      - Bascule le doublement des lignes (seulement
                          dans certains modes VGA) (mme effet que
                          l'option "Scale Y", voir en 7.2.6).



----------------------------------------------------------------------------

Ce document a t rdig par Brett Eden. Si vous avez des questions (ou
autres), il peut tre joint  revere@sub.net.au.

Mise  jour pour la version V0.3.1. par Petter Schau

