F E L L O W COMMODORE AMIGA EMULATOR di Petter Shau(pschau@online.no)
Documentazione e FAQ di Brett Eden (revere@sub.net.au)
Traduzione in Italiano di Roberto Gasparrini (r.gasparrini@fastnet.it)

LEGGI ATTENTAMENTE LE ISTRUZIONI PRIMA DI UTILIZZARE FELLOW Questo archivio contiene Fellow V0.33, per DOS.
 
Autori
 
L'emulatore e' stato scritto da:
 
(C) Petter Schau nel 1996/1997/1998. (pettersc@ifi.uio.no)
 
Con il contributo di:
 
(C) Dolejsi Romano 1997 (roman@sorry.vse.cz)
(C) David Voracek 1997 (assassin@paru.cas.cz)
(C) Rainer Sinsch 1998 (sinsch@stud.uni-frankfurt.de)

Vai alla sezione credits per una dettagliata descrizione dei collaboratori

Licenza

Le condizioni per usare e distribuire questo emulatore:
 
I diritti su questo programma sono tenuti da Petter Schau e da chi ha dato un contributo per migliorare il prodotto.
 
Si ha il permesso di usare gratuitamente questo programma.
 
La distribuzione gratis e' permessa con delle restrizioni.
 
Esso e' liberamente distribuibile finche' il contenuto di questo archivio rimane intatto, non viene modificato, e non si ha nessuno scopo di lucro fuorche' il prezzo del media usato per la distribuzione.
 
La redistribuzione non cambiera' le condizioni di come il software deve essere utilizzato e distribuito.
 
L'inclusione in raccolte su CD-ROM con altro software liberamente distribuibile e' permesso.
 
La distribuzione che viola il principio del nessun-profitto richiede il permesso degli autori del programma.
 
L'emulatore e' provvisto cosi' come e', e viene utilizzato a proprio rischio. L'autore non e' tenuto al supporto e non si prende alcuna responsabilita' per danni a cose o persone.
 
Usando questo programma, l'autore non e' responsabile per qualsiasi problema che sorga nell'uso del programma. Questo software e' sperimentale e quindi utilizzato a proprio rischio.
 
Le condizioni si applicano anche all'archivio del codice dell'emulatore.
 
Condizioni supplementari per il codice dell'emulatore sono:
 
E' possibile cambiarlo quanto si vuole purche' sia per uso personale.
 
Se vengono fatti cambi o aggiunte di qualsiasi cosa che sara' utile per gli altri, sarebbe utile mandare una patch al fine di essere inclusa nel codice ufficiale.
 
Inclusione di parti del codice in altro software liberamente distribuibile e' permesso purche' gli autori vengano menzionati per la propria opera.
 
"AMIGA","AmigaOS","Kickstart" e "Workbench" sono marchi di fabbrica registrati da Amiga International. Gli altri marchi di fabbrica menzionati sono registrati dai rispettivi proprietari.
 
Contenuti
1.  Introduzione 
   
2. Requisiti di sistema
   
3.  Requisiti essenziali
3.1 Immagine del Kickstart
3.1.1 Usare Transrom
3.2  Disco-Immagine
3.2.1 Usare Transdisk
3.3  Copiare file da PC -> AMIGA & AMIGA -> PC
   
4. Avviare Fellow
   
5. Configurazione e Menu di Sistema
5.1 Menu di sistema
5.1.1 Menu di sistema ad albero
5.1.2 Menu di configurazione
5.1.3 Navigare nei file
5.2 Menu principale
5.2.1 Option
5.2.2 Configuration
5.2.3 Utilities
5.2.4 Hard Reset
5.2.5 Debugger
5.2.6 About
5.2.7 Quit
5.3 Menu Configuration
5.4 Menu Floppy Configuration
5.4.1 Diskimage in DF(x)
5.4.2 Drive (x) status
5.4.3 Disk-DMA speed
5.4.4 Alt-N cycling
5.5 Menu Filesystem Configuration
5.5.1 Add VFS filesystem
5.5.2 Add readonly VFS
5.5.3 Add normal filesystem
5.5.4 Add readonly normal filesystem
5.5.5 Remove filesystem
5.6 Menu Screen Configuration
5.6.1 Screen resolution
5.6.2 Frame-skip ratio
5.6.3  Maximum frame-rate
5.6.4 Flicker-free interlace
5.6.5 Cycle-exact drawing
5.6.6 Scale Y
5.7 Menu Memory Configuration
5.7.1 Chip memory
5.7.2 Fast memory
5.7.3 Bogo memory 
5.7.4 Kickstart-image
5.7.5 Keyfile
5.7.6 Memory space size
5.8 Menu Sound Configuration
5.8.1 Sound emulation
5.8.2 Output rate
5.8.3 Output channels
5.8.4 Output bits
5.8.5 Low-pass filter
5.8.6 Sound buffer depth
5.8.7 Send sound ouput to WAV-file
5.9 Menu CPU and Blitter configuration
5.9.1 Virtual CPU instruction set
5.9.2 Virtual CPU speed
5.9.3 Virtual Blitter speed 
5.9.4 Long Blits
5.10 Menu Hardfile configuration
5.10.1 fhfile.device state
5.10.2 FELLOWX hardfiles
5.11 Menu Various Configuration
5.11.1 Joystick Port 1 & 2
5.11.2 Power/floppy LEDs
5.11.3 Performance displayed on-screen 
5.11.4 Menu-position saved on exit
5.11.5 Autorun after some commands
   
6. Debugger 
6.1 Step
6.2 Step Over 
6.3 Breakpoint 
6.4 Memory 
6.5 CIA
6.6 IO 
6.7 Trace on
6.8 Trace off
6.9 Show Trace
6.10 Trace to file
6.11 Event log configuration 
6.12 Show event log 
   
7. Interfaccia Dos
   
8. Come Iniziare - Guida Base
   
9. Scorciatoie con i tasti
9.1 Scorciatoie con i tasti nell' interfaccia-utente
9.2 Scorciatoie con i tasti durante emulazione
   
10. Informazioni su come contattare l'autore
 
1. Introduzione
 
Benvenuto nel "Fellow Amiga Emulator", un programma di emulazione del Commodore Amiga. Fellow crea un ambiente Amiga virtuale sul tuo PC nel quale si può utilizzare il suo software. L'emulatore funziona su un IBM PC compatibile con DOS installato. Possono essere utilizzati diversi ambienti DOS anche se l'emulatore è stato testato con successo sotto MS-DOS, DosEmu per Linux e in sessioni DOS sotto Windows 95 e NT.
Il Commodore Amiga 500 è il modello usato come riferimento per la creazione di "Fellow Amiga Emulator", e la configurazione dell'emulatore mira a ricreare sul tuo PC questo computer.
Fellow è anche estremamente configurabile, con caratteristiche avanzate che possono essere abilitate surclassando di fatto le capacità di un semplice Amiga 500. È fortemente consigliato leggere il sommario della caratteristiche, così da avere un'idea dei punti di forza e delle limitazioni del programma..
L'Amiga 500 fu messo in vendita nel 1987 come successore dell' Amiga 1000. Fu per molti anni il modello entry-level e il più popolare della famiglia. Con le sue capacità multimediali ricche, grazie ad una serie di co-processori dedicati alla gestione della grafica così come i 4 canali stereofonici basati su sample, divenne presto una piattaforma popolare per giochi e demos. Le avanzate capacità multimediali combinate un sistema operativo a finestre con un eccezionale multi-tasking fu il successo dell'Amiga che fu considerato per molti anni il perfetto sistema casalingo.
Anche se ora sono passati piu' di 10 anni dal commercio del primo Amiga, l'emulazione dei primi Amiga e' sempre molto esigente (in termini di risorse) sui computer attuali, e occorre almeno una CPU Pentium.La parte piu' complicata è naturalamente la simulazione dei chip-custom e in generale l'architettura hardware dell' Amiga che porta via la maggior parte del tempo.
"Fellow Amiga Emulator" è stato creato da Petter Schau e la prima versione pubblica è stata rilasciata nel Dicembre del 1996. A monte di quella prima release c'erano stati molti anni di preparazione con curiose sperimentazioni sulle diverse parti hardware dell'Amiga. Oggi si puo' considerare un lavoro completo sotto molti punti di vista anche grazie agli aiuti offerti da molte altre persone.
 
2. Requisiti di sistema
 
Per avviare Fellow, il tuo sistema deve uguagliare, o eccedere, le seguenti caratteristiche:
 
Si RACCOMANDA di avere almeno la seguente configurazione per ottenere prestazioni decenti in Fellow:
Se la tua scheda video non supporta le VESA BIOS Extensions 2.0, avrai bisogno di un driver DOS VBE 2.0 (prova a vedere la Home Page del produttore), o Scitech Display Doctor, disponibile sulla rete.
 
Senza il supporto VBE 2.0, non tutte le risoluzioni dello schermo saranno disponibili per Fellow!
 
Fellow e' un software che utilizza intensamente la CPU , e se vuoi far lavorare l' Amiga con programmi che utilizzano in modo massiccio la grafica avrai bisogno di un Pentium 133 -> 166 e una scheda di video PCI/AGP veloce cosi' come gli altri fattori come la velocita' della RAM (tieni a mente che la RAM DIMM e' di 10ns a confronto con le SIMM EDO e FPM che operano rispettivamente a 60ns e 70ns).
 
3. Prima di iniziare - Requisiti essenziali
 
Prima di poter usare Fellow, avrai bisogno di due cose:
 
3.1 Immagine del Kickstart
 
Una copia della Rom Kickstart di AmigaDOS prelevata da un VERO Amiga. Questo file si ottiene grazie ad un programma chiamato TransROM che e' incluso con Fellow. Il Kickstart e' tutelato in base ai diritti d'autore del software da Amiga International e non e' chiaramente possibile includerlo con l'emulatore. Il modo piu' corretto per ottenere questo file e' quello di copiarlo dal proprio Amiga.
 
La soluzione migliore per ottenere questo file è copiarlo da Amiga, oppure comprare della Amiga Forever CD Cloanto che ha ottenuto la licenza delle rom Kickstart e dei Workbench dalla versione 1.0 alla 3.0 insieme ad altro software pronto all'uso
 
3.1.1 Usare transrom
 
TransROM deve essere copiato su un vero Amiga per estrarre una copia della ROM e metterla su un file.
CLI> il transrom >RAM:kick.rom
Copia il Kickstart e lo scrive in un file in RAM: chiamandolo kick.rom. Esso deve essere poi copiato sul PC nella directory di Fellow (sebbene possa essere posto in una directory diversa).
 
3.2 Disco-Immagine
 
Avrai bisogno anche di un' "immagine" di un vero floppy disk Amiga contenente il gioco/demo che desideri utilizzare su Fellow. Cio' si ottiene usando un programma chiamato "Transdisk" incluso anch'esso con Fellow.
 
Un disco-immagine e' un file nel quale sono presenti i file normalmente immagazzinati su un floppy disk.
 
Il disk drive di un PC non puo' leggere un floppy in formato Amiga, ma OCCORRE un'immagine disco di un vero floppy Amiga.
 
3.2.1 Usare transdisk
 
Come TransROM, TransDisk deve essere copiato su un vero Amiga per usarlo.
 
Transdisk si avvia con la shell di AmigaDOS, e copia un floppy disk, traccia x traccia, in un file (che puo' essere letto da Fellow).
 
CLI> transdisk >RAM:df0.adf
 
Fa un'immagine di un qualsiasi disco nel DF0:. Questo non deve essere chiamato per forza df0.adf, ma puo' avere qualsiasi altro nome.
 
3.3 Copiare file da PC -> AMIGA & AMIGA -> PC
 
1.Usando un cavo null-modem, puoi fare un trasferimento con Zmodem tra un Amiga e un PC, semplicemente collegando il cavo in una porta seriale su ciascuna macchina e caricando un qualsiasi programma come Terminus, Ncomm o Term sull'Amiga e Terminate, Telemate, Telix (o HyperTerminal per Win 95 se proprio insisti) sul PC e iniziando poi un upload con Zmodem sull'Amiga. Se l'hai correttamente configurato (download con ZModem automatico ), il PC accettera' automaticamente questo upload, e copiara' il software sul tuo Hard Disk.
 
2. Se vuoi il meglio, prendi una copia del serial.device BaudBandit per l'Amiga, e setta entrambi i computer a 57,600 Baud. Baud Bandit permette trasferimenti a 5500cps verso/da un Amiga con 68000. Il programma e' disponibile su AmiNET.
 
Se sei una di quelle persone con un AmigaOS 1.2/1.3 e A500, con solamente un floppy-drive potresti essere nei guai. A meno che tu non abbia un programma di emulazione terminale su un floppy-disk avviabile o la possibilita' di usare un secondo drive non c'e' modo per
usare un cavo null-modem per dialogare col PC (che e' attualmente indispensabile per ottenere software come transdisk o transrom su un drive Amiga). La cosa migliore sarebbe contattare un user-group Amiga che puo' farti ottenere tale disco o se sei fortunato, un distributore di shareware Amiga nella tua zona.

Nota: Alcuni Amiga permettono di impostare la seriale a 115,200 baud. Questo dipende soprattutto dalla macchina e cioe' dalla revisione della motherboard e del microprocessore. Settando a 115,200 baud sull'Amiga e sul PC, puoi trasferire velocemente file alla velocita' di 10,100cps.

3. Se non hai un cavo null-modem, o non vuoi comprarne uno, puoi trasferire il software Amiga sul PC usando un floppy disk formattato a 720k. Workbench 2.1+ viene venduto con CrossDOS che e' un software che permette di leggere i dischi da 720k del PC sull' Amiga. Se non hai CrossDOS (ovvero non hai Workbench 2.1 o superiore)), puoi usare anche MessyDOS che e' presente su Aminet. Qui sotto e' riportato passo passo come trasferire il software.
 
4. i) Prendi un floppy PC da 720k, formattalo su Pc o Amiga usando CrossDOS.
 
ii) Crea un file .ADF o un'immagine del Kickstart usando il metodo sopra-descritto.
 
iii) Archivia questo file usando LhA o Zip, (assicurati di averli entrambi sul PC, cosi' potrai decomprimerli).
iv) Copia l'archivio sul disco da 720k usando CrossDOS o MessyDOS.
 
v) Metti il disco sul PC, copia l'archivio sull'Hard Disk e decomprimilo. Copia i il Kickstart o i file .ADF nella directory di Fellow e via!
 
4 Avviare FELLOW
 
Fellow si avvia semplicemente usando FELLOW.EXE dal prompt di MS-DOS. Dopo avere fatto cosi', ti sara' presentato lo schermo del menu con la situazione circa i dischi (file .ADF) che sono inseriti al momento, e se la ROM Kickstart e' presente o meno.
 
5 Configurazione e Menu di Sistema
 
5.1 Menu di sistema

Questa sezione si riferisce all' utente iniziale.

5.1.1 Menu di sistema ad albero
 
Nella parte in basso a destra dello schermo vi e' il menu di sistema. Usa i tasti freccia per muoverti tra i vari menu, e premi return per selezionare. scorciatoie segnalate in verde sono disponibili, cosi' come scorciatoie globali per alcune delle opzioni utilizzate. Il tasto ESC vi fa muovere al livello direttamente superiore.

5.1.2 Menu di configurazione

I settaggi di configurazione sono cambiati nel menu di configurazione. Appaiono nella finestra principale quando uno degli argomenti è stato selezionato. Il nome dell'opzione è visualizzato sulla sinistra evidenziata a destra di ciascuna opzione. Per muoversi usare i tasti UP e DOWN. I tasti LEFT e RIGHT cambiano i settaggi di ciascuna opzione. Alcune di esse richiedono la selezione di un file e la visualizzazione di una navigatore che consente di selezionare cio' che si desidera. Per confermare premere il tasto RETURN.

5.1.3 Navigare nei file

Il navigatore dei file appare nella finestra principale. Muoviti con i tasti freccia finchè non hai trovato cio' che desideri e seleziona con il tasto RETURN. Per uscire senza modificare nulla premere il tasto ESC.

Puoi arrivare direttamente al file scrivendo le prime lettere di esso.

E' possibile utilizzare un'opzione che ricordi il file inserito. Consulta la parte riguardante le scorciatoie con i tasti da utilizzare nella navigazione tra i file.

5.2 Menu principale
 
 
5.2.1 Start
 
Selezionando questa opzione inizierai l'emulazione di Amiga. Se tutto è corretto l'emulatore tentera'di fare il boot come un normale Amiga. Ricordati di inserire sia l'immagine disco che la ROM Kickstart.

Se interrompi l'emulazione questa opzione ti da' la possibilità di riprenderla.

5.2.2 Configuration
 
Il menu della Configurazione e' articolato su un certo numero di sottomenu che permettono di abilitare ed alterare i vari aspetti dell'emulazione.
 
5.2.3 Utilities
 
Il seguente sotto-menu comprende dei tools per creare gli ADF, gli Hard-Disk e rippare i MOD
5.2.4 Hard Reset
 
Questa opzione resetta e re-inizializza l'Amiga. Questa funzione viene, tra l'altro, automaticamente avviata nel caso in cui si cambino alcune opzioni di configurazione .
 
Se nessun Kickstart e' stato caricato, Fellow cerchera' di far partire quei programmi che non richiedono una stretta interazione con l'Amiga OS.Il disco-immagine inserito deve comunque essere inserito nel DF0. Puo' in alcuni casi avviare programmi che non facciano uso delle routine del Kickstart. (Nota: questa caratteristica è tipica delle prime versioni fino alla 0.3.2a.)
 
5.2.5 Debugger
Questo tool viene utilizzato per analizzare che cosa succede nell'Amiga emulato. E' stato sviluppato per cercare errori nell'emulazione e include un metodo per correggere i bug dei programmi Amiga, così come l'analisi dello stato corrente dell' hardware emulato, da qualsiasi punto dell' esecuzione del programma.
 
5.2.6 About
Questa opzione visualizza chi ha collaborato alla programmazione di Fellow
 
5.2.7 Quit
 
Con questa opzione si esce dall'emulatore e si ritorna in DOS
 
5.3 Menu Configuration
 
 
Il menu 'Configuration' contiene una serie di opzioni che consentono di configurare al meglio l'emulatore, come meglio spiegato qui di seguito.
 
5.4 Menu Floppy Configuration
 
 
Questo menu controlla i settaggi relativi alle immagini disco e all'emulazione dell'hardware dei drives Amiga.
 
5.4.1 Diskimage in DF(x)
 
Dove (x) e' 0, 1, 2 o 3 e queste scelte permettono di assegnare il disco virtuale in ciascuno dei 4 floppy disk dell'Amiga. Quando si lancia l'emulatore, verra' richiesto che l'immagine del disco sia assegnato a DF0: (o qualunque disk drive usando Kickstart 2.0
 
Premendo Del si espelle il disco-immagine dal floppy.
 
Con ALT-0 a 9 si scegliera' a rotazione uno dei file-immagine tra i 10 memorizzati. (ALT-0 a 9 e' descritto meglio nel paragrafo che parla del file-requester.)
 
Le immagini disco compresse con gzip o bzip saranno decompresse nella directory di sistema TEMP o TMP. Cambiamenti (es. salvataggio di giochi) alle immagini disco compresse saranno ignorati (solamente l'immagine disco decompressa in TEMP e' cambiata)
 
5.4.2 Drive (x) status
 
Dove (x) e' uno 0, 1, 2 o 3. Queste scelte permettono di disabilitare il drive per non farlo riconoscere all'Amiga. L'utilita' di questo e' che l' AmigaOS non utilizza il buffer del drive, e cosi' si risparmia un paio di K memoria che risulteranno cosi' disponibili all'utente.
 
L'uso intenzionale di questa funzione e' che alcuni vecchi demos potrebbero non funzionare. Per i normali usi, lascia i disk-drive abilitati.
 
5.4.3 Disk-DMA Speed
 
Permette di selezionare la velocita' con la quale i file dei dischi virtuali verranno letti dal drive. L'accesso al disco originale e' lento, ma l'emulazione provvede ad effettuare un accesso piu' veloce.
 
I valori Permessi sono "Original" e "Fast".
 
Bisogna ricordarsi pero' che parecchi programmi potrebbero avere bisogno del 'Disk-DMA speed' settato ad Original per poter funzionare bene.
 
5.4.4 Alt-N cycling
 
Controlla quanto lontano il cursore deve saltare se Del e' pigiato, o se un disco-immagine e' settato in memoria.
 
5.5 Menu Filesystem Configuration
 
 
Questo menu contiene un certo numero di selezioni che controllano e definiscono i filesystem nella tua configurazione. Il filesystems è una directory o altro sito che l'emulatore rende visibile all'Amiga come se fosse un proprio device
 
5.5.1 Add VFS filesystem
 
Questa opzione aggiunge un filesystem virtuale alla configurazione generale. Il filesystem virtuale traduce il formato DOS 8.3 nel normale formato usato dall'Amiga. E' quindi richiesto che il software Amiga sia installato da zero nello spazio disco usato per mantenere aggiornata la tabella di conversione dei files, altrimenti saranno visibili solamente quelli in formato DOS 8+3 e il software potrebbe non trovare i files richiesti.
 
Quindi decomprimi o installa il software nell'emulatore con il formato VFS gia' impostato.
 
Quando si seleziona questa opzione, prima inserisci il nome del volume cosi' come vuoi che appaia su Amiga, quindi il path della directory nel filesystem nativo del PC. Infine bisogna impostare la lunghezza massima dei file permessa dopo che un file lungo. Normalmente lascia come default questa opzione.
 
5.5.2 Add readonly VFS
 
Questa opzione è simile alla 5.5.1, eccetto per il filesystem che è a sola lettura
 
5.5.3 Add normal filesystem
 
Simile alla precedente, eccetto che vengono visualizzati solo i nomi file DOS 8+3 e non viene effettuata una traslazione per i nomi file lunghi.
 
5.5.4 Add readonly normal
 
Simile alla precedente, eccetto per i file DOS 8.3 e per il filesystem che è a sola lettura.
 
5.5.5 Remove filesystem
 
Selezionando questa opzione vi viene visualizzato un menu' con il filesystem da rimuovere.
 
5.6 Menu Screen Configuration
 
 
Questo sotto-menu controlla gli aspetti dell'emulazione grafica e della visualizzazione sullo schermo
 
5.6.1 Resolution
 
Controlla quale risoluzione l'emulatore usera' quando si utilizza l'emulatore.Le risoluzioni disponibili dipendono da quale driver VESA si ha disponibile. Le seguenti risoluzioni sono presenti nell'emulatore se il tuo driver VESA le supporta:
 
Risoluzioni supportate:
800x600x16 bit color
800x600x15 bit color
640x480x16 bit color
640x480x15 bit color
640x400x16 bit color
640x400x15 bit color
640x350x16 bit color
640x350x15 bit color
400x300x16 bit color
400x300x15 bit color
400x300x8 bit color
320x480x16 bit color
320x480x15 bit color
320x480x8 bit color
320x400x16 bit color
320x400x15 bit color
320x400x8 bit color
320x240x16 bit color
320x240x15 bit color
320x240x8 bit color
320x200x16 bit color
320x200x15 bit color
320x200x8 bit color (Std. VGA)
L'emulatore seleziona solo una delle risoluzioni a 15/16 bit se entrambe sono disponibili. La risoluzione VGA 320x200x8 è implicito che sia presente in tutte le schede grafiche. Se un driver Vesa non è disponibile o non è supportato, la risoluzione 320x200x8 è l'unica disponibile e selezionabile.
 
NOTA:
Le risoluzioni Non-VGA possono essere usate solamente con il supporto del liner framebuffer da parte del driver VESA.
 
L'emulatore costruisce le immagini di un Amiga avendo presente che esso ha un campo grafico di 768x580. Molte risoluzioni, quiandi, non possono essere abbastanza grandi da visualizzare l'intero schermo. La schermata risultante e' tagliata per farla entrare nello schermo, e con le basse risoluzioni nell'emulatore le schermate Amiga in alta risoluzione subiscono una conversione a perdita, perdendo ciascun secondo pixel.
 
5.6.2 Frame-skip ratio
 
Il Frame-skip ratio controlla l'aggiornamento video dell'emulatore. 1/1 consente un aggiornamento continuo.
 
Rapporti piu' bassi produrranno animazioni a scatti, ma permettera' l'emulazione di altre componenti in modo piu' veloce.
Aggiustare questo valore e' generalmente la prima cosa da fare per migliorare la performance dell'emulatore.
5.6.3 Maximum frame-rate
 
Controlla il limite massimo di frame che deve generare l'emulatore.
 
Le opzioni disponibili sono "Unlimited", "50 Hz" e "Synch with VGA-card".
 
La funzione "Unlimited" disabilitera' ogni limite massimo, e permette di far funzionare il tutto nel modo piu' veloce possibile.
Cio' porta ad una alterazioni della velocità di ripetizione dei tasti ed in generale ad una alterzione del timing dell'emulatore. Potrebbe, su alcune macchine molto veloci risultare impossibile utilizzare la tastiera.
 
"50 hz" limita la velocita' ad un Amiga A500 PAL.
 
"Synch with VGA-card" tentera' di sincronizzare lo schermo col refresh della VGA usata. Puo' in alcuni casi creare immagini fluidissime. Rispetto al normale refresh Pal il modo VGA-card provochera' spesso degli errori nella velocita' del suono e nelle applicazioni in generale. Il settaggio viene ignorato quando l'emulazione del suono e' su "Sychronized with emulation".
 
NOTA:
Questo settaggio è ignorato se l'emulazione sonora è settata su "Synchronized with emulation". Fa eccezione l'opzione "Synch with VGA-card" che verra' comunque usata insieme al sonoro. Da notare che "Synch with VGA-card" e sonoro non è una buona combinazione.
 
5.6.4 Flicker-free interlace
 
Quando abilitato, esso tentera' di de-interlacciare uno schermo Amiga interlacciato. Questo e' utile solamente quando l'emulatore usa uno schermo a 800x600.
 
5.6.5. Cycle exact drawing
 
Questa e' un'opzione molto sperimentale. Se abilitata permette la corretta emulazione degli effetti plasma, ecc.( o perlomeno, questa e' l'intenzione:-))
Questa opzione per ora emula soltanto i cambi di colore nelle linee intermedie. E' piu' che altro un test per vedere
se funziona senza dover riprogrammare tutta la parte relativa alla grafica. Per ora questa funzione lavora solo a 800x600
 
NOTA:
Tenere l'opzione permanentemente abilitata puo' creare problemi dato che ha bisogno ancora di molto lavoro, quindi utilizzala solo per vedere particolari effetti.
 
5.6.6 Scale Y
 
Quando abilitata l'opzione consente la correzione dell'immagine rispetto alla risoluzione adottata. E' applicabile solo con le alte risoluzioni dell'emulatore.
 
Sono possibili tre scelte: "No Scaling", "Hardware VGA Line Doubling" e "Insert black lines"
 
"No scaling" non effettua alcun ridimensionamento verticale
 
"Hardware VGA Line Doubling" utilizza alcuni registri VGA per scalare le immagini. Funziona solamente con le schede grafiche compatibili con i registri VGA e che utilizzano tali registri anche nelle risoluzioni SVGA (Non tutte sono così).
 
"Insert black lines" è un metodo software che inserisce linee nere nell'immagine per mostrare lo schermo Amiga con un aspect ratio piu' corretto.
 
5.7 Menu Memory Configuration
 
 
Questo sotto-menu controlla quale tipo e la quantità di memoria debba emulare l'Amiga
 
5.7.1 'Chip-memory'
 
Permette di decidere quanta chip-ram sara' emulata. I valori permessi sono tra 256KB e 2048KB.
 
5.7.2 'Fast-memory'
 
Permette di decidere quanta fast-ram sara' emulata. I valori permessi sono 0, 1, 2, 4 e 8 MB.
 
5.7.3 'Bogo-memory'
 
Permette di decidere quanta Bogo Ram (talvolta chiamata Slow-ram) sara' emulata. Questo e' un terzo tipo di memoria uguale a quella usate nelle schede di espansione che venivano installate nell'apertura sotto l' Amiga 500. I valori permessi sono tra 0KB e 1792KB.
 
5.7.4 'Kickstart-image'
 
Permette di scegliere l'ubicazione dell'immagine della ROM (che e' indispensabile per lavorare con Workbench, o in generale per avviare i programmi). Scegliendo questa opzione si presentera' un semplice file-requester con cui selezionare la ROM. Fellow cerchera' il file "kick.rom" come default.
 
Il suffisso .rom e' indispensabile. E' possibile utilizzare anche un kickstart su disco ADF.
 
L'emulatore cercherà automaticamente la locazione di memoria dove la Rom deve essere inserita. Per ROM locate all' indirizzo $F000000, è possibile caricare una seconda ROM da $F80000 or $FC0000 con il comando -r2. E' utilizzabile per vedere l'animazione di boot del CDTV. (Al momento l'emulazione CDTV non è pero' possibile)
 
5.7.5 'Keyfile'
 
Questa opzione specifica il keyfile usato per accedere ai kickstart criptati che sono su Cloanto 'Amiga Forever'

5.7.6 Memory Space Size

Questa opzione controlla la larghezza del bus della memoria. Le opzioni permesse sono "24 bit" o "32 bit". "24" bit è lo standard utilizzato nel Motorola 68000 e 68010 ed in alcune versioni del 68020 che possono indirizzare al massimo 16MB di memoria. "32 bit" permette invece l'indirizzamento di uno spazio di memoria massimo di 4GB ed è utilizzato nelle CPU 68K medium e high end.

5.8 Menu Sound Configuration
 
 
Questo sotto-menu controlla gli aspetti dell'emulazione sonora
 
5.8.1 Sound-emulation
 
Seleziona il tipo di emulazione. Le scelte possibili sono: "No sound" and "Emulated, not played"
 
"No sound" - Disabilita l'emulazione sonora dell'Amiga
 
"Emulated, not played" - Il suono e' emulato, ma non viene riprodotto.
 
Le opzioni disponibili se e' presente una scheda sonora compatibile (Soundblaster) sono: "Normal, synchronized with emulation" e "Normal, synchronized with real-time"
 
Ci sono quindi tue tipi diversi di timing per l'emulazione sonora. "Normal, synchronized with emulation" produce una uscita audio sincronizzata con l'emulazione in generale. Se l'emulazione è troppo lenta, ci saranno dei buchi o interruzioni nell'esecuzione. In una macchina abbastanza veloce questo metodo consente una buona qualità audio.
 
"Normal, synchronized with real-time" separa l'emulazione del suono dal resto dell'emulazione. Lo svantaggio è una sensibile distorsione audio. Ebbene, non utilizzatela su macchine troppo lente. Un'altro svantaggio è che il metodo utilizzato non permette buone prestazioni in CPU Pentium 2, ma non ci dovrebbero essere problemi con il "Normal, synchronize with emulation" che lavora bene con tutte le CPU.
 
NOTA:
L'opzione "Normal,synchronized with real-time" non è stata inclusa nella versione 0.3.3, e cosi' le informazioni si riferiscono alle precedenti versioni.
 
5.8.2 Output-rate
 
Questa opzione seleziona la qualità del sonoro emulato. I valori disponibili sono: 15650 Hz, 22050 Hz, 31300 Hz, 44100 Hz
 
5.8.3 Output-channels
 
Questa opzione seleziona il numero di canali da utilizzare nell'emulazione. I valori sono "Mono" o "Stereo"
 
5.8.4 Output-bits
 
Seleziona il numero di bits da usare per l'emulazione. I valori sono "8 bits" o "16 bits"
 
NOTA:
Non tutte le schede audio supportano tutti i settaggi. Se hai settato dei valori errati per la tua scheda i settaggi saranno modificati al minimo dell'emulazione possibile. Si puo' comunque utilizzare l'opzione "Emulated, no playback". Esso permette il salvataggio in qualsiasi qualità audio in formato WAV
 
PERFORMACE NOTE:
Utilizzare 44100 Hz non è necessario e, tra l'altro appesantisce ancora di piu' la CPU. Un buon compromesso tra velocità e qualità è 31300 Hz. 8/16 bits e mono/stereo fanno poca differenza in termini di velocità.
5.8.5 Low-pass filter
Con questa opzione puo' essere abiitato Un filtro passa-basso da 7Khz. Esso modifica il suono e lo rende piu' ricco di bassi permettendo, almeno presumibilmente rimuovendo il rumore ad alta ferquenza dai samples.
 
5.8.6 Sound buffer depth
 
La lunghezza del buffer sonoro influenza il ritardo del suono, oltre ad avere altri due effetti. Su macchine lente, è possibile utilizzare questa opzione per avere un buffer maggiore e quindi evitare rumori fastidiosi ed interruzioni sonore.
Un' importante caratteristica di questa opzione e' di rendere piu' stringente la sincronizzazione. Su macchine veloci (Pentium 2) la migliore soluzione è un buffer corto per ottenere uno frame-rate costante
 
5.8.7 Send sound output to WAV-File
 
Abilitando questa opzione durante l'emulazione si avra' l'uscita audio su un file WAV della qualità audio selezionata
 
5.9 Menu CPU and Blitter configuration
 
 
Questo sotto-menu controlla alcuni aspetti dell'emulazione della CPU e del Blitter.
 
5.9.1 Virtual CPU instruction set
 
Questa opzione seleziona il set di istruzioni della CPU da emulare. I modelli disponibili sono "68000", "68010", "68020", "68030". Il 68020 e il 68030 corrispondono al tipo EC senza FPU ed MMU
 
5.9.1 Virtual CPU speed
 
Controlla la velocita' virtuale della cpu emulata. Da non confondere pero' con le vere performance in real-time.
 
Le scelte sono "3.5 Mhz", "7 Mhz", "14 Mhz" e "28 Mhz". Il clock è riferito alla temporizzazione di un A500 con 68000 a 7Mhz e non è quindi riferibile a nessuna CPU reale. (E' una delle cose che si possono fare con l'emulazione)
 
5.9.3 Virtual Blitter Speed
 
Questa opzione controlla come i programmi Amiga debbano vedere la velocità del blitter. Le scelte sono: "Normal OCS Speed" e "Finish Instantly".
 
"Normal OCS Speed" prevede un Blitter allineato con la temporizzazione di un normale chipset OCS e ne rispetta la velocità. Alcune operazioni infatti richiedono delle attese e la maggior parte dei programmi usano questa caratteristica.
 
"Finish instantly" prevede un Blitter che non aspetta alcuna operazione e termina le proprie operazioni subito. In alcuni casi cio' potrebbe sovraccaricare l'emulatore di operazioni del Blitter e degradare le performace in real-time. D'altro canto è possibile con alcuni programmi che soffrono di problemi di sincronizzazione, rendere come visibili scattosita' in animazioni o grafica vettoriale
 
5.9.4 Long blits
 
"Long blits" è una caratteristica del chipset ECS. Alcuni programmi lo richiedono come ad esempio il port di Doom.
 
5.10 Menu Hardfile configuration
 
 
Questo sotto-menu controlla l' hardfile.
 
Un hardfile e' un modo per fornire un hard-disk all'Amiga emulato. Esso è un enorme file che è usato come un Hard Disk.Essi possono essere di qualsiasi grandezza.
 
L'Hardfile puo' essere usato solamente con il kickstart 2.0 o superiore.
 
Ricordati di formattare ogni nuovo hardfile.
 
E' possibile fare il boot da qualsiasi Hard-disk che hanno quindi la priorità sul DF0: ma non sul DF1:
 
E' possibile utilizzare i file ADF non compressi al posto degli hardfiles.
 
Questi ultimi sono numerati come FELLOW con accanto un numero crescente.
 
NOTA: Cambiare Hardfile significa fare automaticamente un reset hardware dell'Amiga.
 
5.10.1 fhfile.device state
 
L'hardfile e' implementato tramite un device -driver software che puo' essere abilitato (Enabled) o disabilitato (Disabled)
 
5.10.2 FELLOW(X) hardfiles
 
L'opzione riguarda quanti hardfile l'eseguibile deve avviare e si puo' aggiungere un certo numero di questi alla configurazione. Selezionando questa opzione si presenterà un navigatore di file che consente di selezionare la memoria di massa da emulare.
E' possibile utilizzare degli ADF scompressi come hardfile
 
5.11 Menu Various Configuration
 
 
Questo sotto-menu è una serie di opzioni che controllano diversi aspetti.
 
5.11.1 Joystick Port 1 & 2
 
Questa opzione controlla le porte joystick dell'Amiga.
 
I settaggi possibili sono:
 
Disabled, Mouse, Analog Joystick, Keyboard Joystick Replacement 1 & 2
 
L'opzione Keyboard Joystick Replacements consente di usare:
 
I tasti Freccia, CTRL come firebutton 1 e ALT come firebutton 2.
 
oppure
 
' D' sinistra, ' F' giu', ' G' destra, ' R' su, 'CTRL Sinistro' come firebutton 1 e 'ALT sinistro' come firebutton 2.
 
Il Joystick Analogico non e' consigliabile. Per calibrarlo ruota lo stick durante l'emulazione.
 
Se si hanno problemi si puo' provare ad utilizzare l'utilita' Joyemu che permette una miglior gestione.(Cercala con qualunque Search-engine)
 
5.11.2 'Power Floppy Leds'
 
Controlla dove visualizzare i vari leds dei floppy e del power.
 
E' possibile utilizzare anche un apposito circuito hardware (inventato da Roman Dolejsi ) e si trova su ledboard.txt.
 
Il settaggio per l'ordine dei LED sulla tastiera comunica all'emulatore la disposizione dei LED sulla tua tastiera.
 
5.11.3 Performance displayed on-screen
 
Questa opzione abilita la visualizzazione dei frame per secondo nella parte alta destra dello schermo.La percentuale e' comunque molto approssimativa.
 
5.11.4 'Menu-position saving on exit'
 
Questa e' un'opzione sperimentale. Quando e' abilitata, i movimenti nei vari menu saranno salvati in uscita, e eseguiti la prossima volta che l'emulatore sara' avviato.
 
5.11.5 Automatic run after commands
 
L'avvio automatico puo' essere abilitato dopo alcuni comandi.
6. Debugger
 
 
Questa scelta ti fa entrare in un sotto-menu, e l'emulatore procedera' fino a che la condizione selezionata non verra' incontrata. E' possibile specificare un indirizzo, oppure una fine ad uno specifico punto se si verifica un caso(*), ed è possibile continuare fino ad al verificarsi di una eccezione o di un evento irq.
6.1 Step
 
Esegue la prossima istruzione (passo 1)
 
6.2 Step over
 
Setta un punto d'arresto alla prossima istruzione, e l'emulatore continuera' fino a che l'istruzione non viene raggiunta. (Utile per saltare alcuni loops e le istruzioni jsr/bsr)
 
6.3 Breakpoint
 
Questa scelta ti fa entrare in un sotto-menu, e l'emulatore procedera' fino a che la condizione selezionata non verra' incontrata. E' possibile specificare un indirizzo, oppure una fine ad uno specifico punto se si verifica un caso(*), ed è possibile continuare fino ad al verificarsi di una eccezione o di un evento irq.
 
 
6.4 'Memory'
 
Visualizza lo stato della memoria. Frecce su e in giu' e Page Up/Down per muoversi, "h" e "a" per settare i caratteri ascii o esadecimali.
 
 
6.5 'Cia'
 
Visualizza lo stato dei registri nel chip CIA.
 
6.6 'IO'
 
Visualizza lo stato dei Chip-custom. Questo ti permette di entrare in un sottomenu dove e' possibile selezionare vari registri.
 
6.7 Trace on (*)
 
Abilita la storia delle istruzioni della cpu. L'ultimo mezzo milione di istruzioni verranno ricordate.
 
6.8 Trace off
 
Disabilita la storia delle istruzioni della cpu.
 
6.9 Show Trace
 
Mostra la storia delle istruzioni della cpu. E' possibile muoversi con i tasti freccia UP/DOWN, PGUP/PGDOWN, HOME/END e INSERT/DELETE (+- 1000 istruzioni).
 
6.10 Trace To File
 
Questa opzione scrive la presente storia delle istruzioni della CPU in un file chiamato "mytrace.cpu"
 
6.11 'Evlog config'
 
Configura gli eventi registrati, irq e eccezioni che possono abilitati e disabilitati.
 
6.12 'Show evlog'
 
Selezionando questa opzione si entra in un navigatore che mostra gli eventi registrati.
 
7 Interfaccia Dos
Various command line options:  
-h Sommario delle opzioni
-log
Genera un log-file dell'inizializzazione.
Usa questa opzione per vedere quello che
l'emulatore scopre del tuo hardware. (Default è nessun log)
-nogui Bypassa l'interfaccia GUI. (Default: GUI abilitata)
-f12exit F12 esce dall'emulatore (Default: F12 returns alla GUI)
-config <file> Usa un file diverso da fellow.cfg per la configurazione. (Default: Usa fellow.cfg)
-noconfig Non usa il file config (Default: Usa il config file)
-ns Non salva i settaggi all'uscita (Default: Salva settaggi)
-nommx Non usa le istrzioni MMX instructions se è presente. (Default: Usa l' MMX se presente)
Floppy disk command line options:  
-0 <file> Disco-immagine nel DF0 (Default: Nessuna immagine)
-1 <file> Disco-immagine nel DF1 (Default: Nessuna immagine)
-2 <file> Disco-immagine nel DF2 (Default: Nessuna immagine)
-3 <file> Disco-immagine nel DF3 (Default: Nessuna immagine)
-0e +|- Abilita (+) o Disabilita (-) DF0 (Default: Abilitato)
-1e +|- Abilita (+) o Disabilita (-) DF1 (Default: Abilitato)
-2e +|- Abilita (+) o Disabilita (-) DF2 (Default: Abilitato)
-3e +|- Abilita (+) o Disabilita (-) DF3 (Default: Abilitato)
-ds +|- Abilita (+) o Disabilita (-) l'accesso veloce al disco (Default: Accesso lento)
-dmX <file> Contenuto dei Dischi in memoria X (0 ..9)
-dpath <dir/file> Attiva la path per il disco.
Hardfile command line options:  
-hfX <file> Use il file come X hardfile dove X è un numero tra 0 e 9. (Default: Nessun hardfile)
-he +|- Abilita (+) o Disabilita (-) l' hardfile device. (Default: Abilitato quando si usa un Kickstart V2.0++)
Memory command line options:  
-c <size> Usa <size> KB di memoria chip, dove size è 256, 512, 768, 1024, 1280, 1536, 1792 o 2048. (Default: 2048 KB)
-fm <size> Usa <size> MB di memoria fast, dove size è 0, 1, 2, 4, or 8. (Default: 0MB)
-b <size> Usa <size> KB di memoria bogo (slow-fast), dove size è 0, 256, 512, 768, 1024, 1280, 1536 or 1792. (Default: 0 KB)
-r <file> Usa il <file> come Kickstart o kickdisk (Default: kick.rom)
-r2 <file> Usa <file> come secondo Kickstart o kickdisk. (Default: Nessun Kickstart)
-K <file> Usa <file> come keyfile per Kickstart criptati. (Default: rom.key)
Joystick command line options:  
-j1 n|a|m|k1|k2  Specifica l'interfaccia nella porta game 1:  
n - Nessuna
a - Joystick Analogico 
m - Mouse  
k1 - Rimpiazza il Joystick con la Tastiera 1  
k2 - Rimpiazza il Joystick con la Tastiera 2  
(Default: Mouse)
-j2 n|a|m|k1|k2  Specifica l'interfaccia nella porta game 1:  
n - Nessuna
a - Joystick Analogico 
m - Mouse  
k1 - Rimpiazza il Joystick con la Tastiera 1  
k2 - Rimpiazza il Joystick con la Tastiera 2 
(Default: Nessuna)
Sound command line options:  
-s d|n|c|e Specifica il metodo di emulazione del sonoro  
d - Disabilitato
n - Normal, synchronized with emulation  
c - Normal, synchronized with real-time  
e - Emulated, no playback  
(Default: Disabilitato)
-sf <rate> L'uscita audio in <rate> HZ, dove rate è 15650, 22050, 31300 o 44100  
(Default: 15650)
-ss on|off Uscita stereo on o off (Default: off)
-sb <bits> Qualità audio in bits, dove bits è 8 o 16 (Default: 8)
-sd <frames> Sound buffer in 50 hz frames, dove frames range è un numero tra 1 e 9. (Default: 5)
-sw +|- Abilita (+) o Disabilita (-) la cattura su wav del sonoro. (Default: Disabilita)
-sl 0|1|2 Uso del Low-pass filter:  
0 - Original  
1 - Always  
2 - Never  
(Default: Original)
-s1 Forza l'utilizzo delle routines Soundblaster V1
Screen command line options:  
-res 800600w | 640480w | 640400w | 640350w | 400300w | 400300b | 320480w | 320480b | 320400w | 320400b | 320240w | 320240b | 320200w | 320200b Specifica la risoluzione da adottare (Default:800600w, o in alternativa 320200b)
-fl none|50|vga Limite di frame per secondo
-f <number> Salta 1/numero di frame. (Default: 1/1)
-i on|off Deinterlaccia in 800600 (Default: off)
-gc on|off Usa cycle-exact graphics in 800600 (Default: off)
-y n|h|b Specifica il tipo di scalatura verticale:  
n - No scaling  
h - Hardware VGA Scaling  
b - Blank line interleave
8. Come Iniziare - Guida Base
 
Una volta che hai copiato un disco Amiga in un archivio .adf, e lo trasferisci sul tuo PC, avvia Fellow e assegna a questo disco-immagine il DF0:
 
Se e' un disco Workbench, assicurati di aver copiato la Rom Kickstart in un file situato nella stessa directory di Fellow, e averlo chiamato kick.rom, oppure selezionandone uno diverso con il menu di configurazione.
 
Se il Kickstart non e' presente, Fellow bypassera' il bootstrap dell' Amiga e tentera' di avviarlo in un altro modo. Questo sistema funziona con i demo e giochi i quali ignorano le routine del Kickstart e fanno tutto a modo loro. Devi selezionare "RESET" per abilitare questo sistema dopo avere inserito un disco-immagine.
 
Seleziona l'ammontare della Ram che devi usare, configura l'emulazione del suono e scegli "RUN" dal menu principale.
 
Se tutte le cose verranno fatte come si deve,Fellow avviera' il disco.
 
9. Scorciatoie con i tasti
 
Alcune scorciatoie sono disponibili nell' interfaccia-utente, e alcuni anche durante l'emulazione.
 
9.1 Scorciatoie con i tasti nell' interfaccia-utente
Keypress: Description:
ALT-X Esci
CTRL-q Esci
F1 Configuration Menu
F3 Utilities Menu
F5 Hard Reset
F7 Debugger Menu
F9 Start
F11 About
ALT-d Disk-Image Configuration
ALT-f Filesystem Configuration
ALT-m Memory Configuration
ALT-o Sound Configuration
ALT-c CPU and Blitter Configuration
ALT-h Hardfile Configuration
ALT-v Various Configuration
ALT-a Add VFS Filesystem
ALT-r Remove Filesystem
9.2 Scorciatoie con i tasti durante emulazione
Keypress: Description:
F12 Ritorna nell' interfaccia-utente
HOME-PGUP Cambia la risoluzione video alla prossima
HOME-PGDOWN Cambia la risoluzione video alla precedente
END-PGUP Usa il prossimo metodo di scalatura verticale
END-PGDOWN Usa il precedente metodo di scalatura verticale
HOME-KEYPAD ARROW UP Scrolla lo schermo Amiga in su
HOME-KEYPAD ARROW LEFT Scrolla lo schermo Amiga in giu'
HOME-KEYPAD ARROW RIGHT Scrolla lo schermo Amiga a destra
HOME-KEYPAD ARROW DOWN Scrolla lo schermo Amiga a sinistra
HOME-F11 Cattura l'immagine su schermo come file BMP
HOME-F1 Inserisci il disco-immagine nel drive DF0
HOME-F2 Inserisci il disco-immagine nel drive DF1
HOME-F3 Inserisci il disco-immagine nel drive DF2
HOME-F4 Inserisci il disco-immagine nel drive DF3
END-F1 Togli il disco-immagine nel drive DF0
END-F2 Togli il disco-immagine nel drive DF1
END-F3 Togli il disco-immagine nel drive DF2
END-F4 Togli il disco-immagine nel driveDF3
10. Informazioni su come contattare l'autore
 
Contattare Petter Shau è facile e basta inviare una e-mail a pschau@online.no
Tenete presente che io (Petter Shau) con ho tempo di rispondere a tutta la posta. Richieste sulle prossime versioni o sui bug saranno perentoriamente ignorate cosi' come il supporto agli utenti visto che potete fare riferimento alla documentazione. Queste vanno inviate alle persone che normalmente danno aiuti e risposte agli utenti come ad esempio usare un Amiga o come trasferire file da Amiga a PC.
 
Per gli affezionati ecco il mio indirizzo vecchio-stile:
Petter Schau
Ravnkollbakken 83
N-0971 Oslo
Norway
 
Le e-mail degli altri autori o di chi ha contribuito sono nel file di credits.

Il seguente testo e' stato redatto da Gasparrini Roberto (r.gasparrini@fastnet.it) e revisionato da James Ossi (j.ossi@fi.flashnet.it), dopo una estenuante traduzione del documento principale redatto da Brett Eden e Petter Shau. Il sottoscritto mantiene anche una pagina Web dedicata esclusivamente a questo emulatore e puo' essere raggiunta con:
http://www.tdm.italia.tm/fellowtheamiga/
N.B.
Per eventuali consigli o precisazioni sulla documentazione scrivetemi.