![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to LIESMICH CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [UNIX Amiga Emulator] / uae / docs / translated|
Return to LIESMICH CVS log | Up to [UNIX Amiga Emulator] / uae / docs / translated |
1.1 root 1: [If the rest of this file is incomprehensible to you, that's because it
2: contains german instructions.]
3: F�r Leute, die englische Texte nicht besonders gut verdauen, sind in dieser
4: Datei noch einmal die wichtigsten Hinweise zu UAE zusammengefa�t. Die
5: englische README-Datei enth�lt wesentlich mehr Information; diese deutsche
6: �bersetzung ist nur eine Notl�sung.
7:
8: UAE steht f�r Un*x Amiga Emulator, was den Kern der Sache nicht ganz trifft,
9: da auch Versionen f�r Mac, DOS, NextStep, BeBox und Amiga verf�gbar sind.
10:
11: [Anmerkung: Manche Versionen von UAE, etwa die DOS- und die Mac-Version haben
12: zus�tzliche Readme-Dateien, die Sie ebenfalls lesen sollten, da manche Details
13: von der Unix-Version abweichen.]
14:
15: Lizenz
16: ======
17:
18: UAE unterliegt der GNU General Public License, die in der Datei "COPYING"
19: im Hauptverzeichnis dieses Archivs enthalten ist.
20:
21:
22: �bersicht
23: =========
24:
25: UAE emuliert einen A500 mit bis zu 2MB Chipram und 8.5MB Fast-RAM. Die
26: Emulation ist nahezu vollst�ndig. Urspr�nglich wurde UAE f�r Unix-�hnliche
27: Systeme (ich selbst benutze Linux) geschrieben, haupts�chlich deswegen, weil
28: Programmieren unter anderen Betriebssystemen Strafarbeit ist (Fehler=>Absturz).
29: Die Hard-/Softwarevoraussetzungen f�r den Betrieb der Unix-Version sind:
30: - 8MB RAM, besser 12-16MB
31: - ein schneller Prozessor (i486 ist nicht das Gelbe vom Brot)
32: - X11, oder SVGAlib unter Linux
33: - ein ANSI-C-Compiler, am besten GCC.
34: - optional: Die gtk+-Bibliothek, Version 0.99.3 oder h�her
35:
36:
37: Vorbereitungen
38: ==============
39:
40: Zugriffe auf das Diskettenlaufwerk k�nnen nur �ber einen Umweg emuliert
41: werden, da PCs keine Amiga-Disketten lesen k�nnen. UAE verwendet
42: "Diskfiles", das sind genaue Abbilder des Inhalts einer Amiga-Diskette. Solche
43: Diskfiles sind 901120 Bytes gro� und k�nnen mit dem Tool "transdisk", das UAE
44: beiliegt erstellt werden. Um UAE laufenzulassen, ben�tigen Sie au�erdem ein
45: Abbild eines Amiga-Kickstart-ROMs. Dieses kann aus Copyrightgr�nden nicht mit
46: UAE vertrieben werden. Es mu� mit dem Tool "transrom" erzeugt werden.
47: Die beiden Programme finden Sie im Unterverzeichnis "amiga". Sie m�ssen sie
48: zun�chst auf Ihren Amiga kopieren, entweder �ber ein serielles Nullmodem-Kabel
49: oder mit Hilfe eines Amiga-Programms wie etwa CrossDOS oder MessyDOS, die es
50: erm�glichen, PC-Disks mit einem Amiga zu lesen und zu beschreiben. Dieselbe
51: Methode kann dann selbstverst�ndlich auch benutzt werden, um Amiga-Dateien auf
52: den PC zu kopieren. CrossDOS ist seit einiger Zeit Bestandteil des
53: Amiga-Betriebssystems, und MessyDOS ist frei erh�ltlich (u.a. auf einer
54: �lteren Fish-Disk, Nummer habe ich vergessen). Beachten Sie, da� in vielen
55: Amigas nur DD-Laufwerke eingebaut sind, die PC-�blichen HD-Disketten lassen
56: sich damit nicht verarbeiten.
57: Wenn Sie die L�sung mit dem Nullmodemkabel benutzen wollen, werden Sie zwei
58: Terminalprogramme ben�tigen, sowohl f�r den PC als auch f�r den Amiga.
59: Bitte lesen Sie in den jeweiligen Anleitungen der Programme (etwa CrossDOS
60: oder die Terminalprogramme) nach, wie diese Programme zu bedienen sind.
61: Nachdem Sie transrom und transdisk auf den Amiga kopiert haben, m�ssen Sie dem
62: AmigaOS beibringen, da� diese Dateien ausf�hrbare Programme sind. Das
63: geschieht durch den CLI-Befehl
64:
65: "protect transrom rwed" (bzw. "protect transdisk rwed")
66:
67: Danach k�nnen Sie die Programme aufrufen:
68:
69: transrom >RAM:kick.rom
70:
71: erzeugt eine 524288 Byte gro�e Kickstart-Datei in der Ramdisk. Diese m�ssen
72: Sie auf Ihren PC �bertragen und dort in dasselbe Verzeichnis kopieren, in dem
73: UAE installiert ist.
74: Mit
75: transdisk >RAM:df0.adf
76:
77: kann die in Laufwerk 0 liegende Diskette in ein Diskettenabbild umgewandelt
78: werden, welches wiederum in der Ramdisk gespeichert wird. Hierbei kann ein
79: Problem auftreten, wenn Ihr Amiga wenig Speicher hat (wenn er _sehr_ wenig
80: Speicher hat, funktioniert schon der obige transrom-Befehl nicht; dann haben
81: Sie leider Pech gehabt). Sie k�nnen die Diskette in mehreren St�cken
82: �bertragen. Eine Amiga-Diskette hat 80 Spuren (0..79); mit den Befehlen
83:
84: transdisk >ram:df0_1.adf -s 0 -e 19
85: transdisk >ram:df0_2.adf -s 20 -e 39
86: transdisk >ram:df0_3.adf -s 40 -e 59
87: transdisk >ram:df0_4.adf -s 60 -e 79
88:
89: werden vier Teil-Disketten-Abbilder erstellt, (z.B. enth�lt df0_1.adf gerade
90: die Spuren 0 bis 19). Es macht nat�rlich keinen Sinn, die Befehle in obiger
91: Reihenfolge aufzurufen, Sie sollten immer nur jeweils eine Datei erzeugen, auf
92: den PC �bertragen, aus der Amiga-Ramdisk l�schen und dann fortfahren.
93: Die vier Dateien lassen sich dann auf dem PC wieder zu einer zusammensetzen,
94: entweder unter DOS mit
95:
96: COPY /B df0_1.adf+df0_2.adf+df0_3.adf+df0_4.adf df0.adf
97:
98: oder unter Unix:
99:
100: cat df0_1.adf df0_2.adf df0_3.adf df0_4.adf >df0.adf
101:
102: UAE ben�tigt die Datei "kick.rom" (524288 Byte) und eine Datei "df0.adf"
103: (901120 Byte), um etwas Sinnvolles zu tun. Diese m�ssen im gleichen
104: Verzeichnis stehen, wie UAE.
105: Die Datei, die das Kickstartabbild enth�lt, d�rfen Sie nicht weitergeben, da
106: sie Code enth�lt, dessen Copyright Commodore-Amiga h�lt. Ebenso d�rfen die
107: meisten Diskettenabbilder (etwa die Workbench, oder kommerzielle Spiele) nicht
108: weiterverbreitet werden. Sie d�rfen mit UAE nur Software benutzen, f�r die Sie
109: das Nutzungsrecht haben.
110:
111:
112: Compilierung
113: ============
114:
115: Die Versionen f�r Unix, NextStep und BeBox m�ssen zun�chst compiliert werden.
116: F�r die BeBox m�ssen Sie daf�r ins Verzeichnis "src" gehen und
117:
118: make -f Makefile.Be
119:
120: eingeben, auf anderen Systemen m�ssen Sie zun�chst
121:
122: configure
123:
124: aufrufen; dieses Skript analysiert Ihr System und sammelt Informationen (aber
125: im Gegensatz zu MessySoft-Produkten schickt es sie nicht �bers Netz an andere
126: Leute, sondern erstellt nur die Dateien "Makefile" und "sysconfig.h"). Danach
127: k�nnen Sie mit
128:
129: make
130:
131: UAE compilieren. Am Ende sollte eine ausf�hrbare Datei namens "uae" entstanden
132: sein. Falls Sie unter Linux die SVGAlib- anstelle der X11-Version benutzen
133: m�chten, geben Sie statt "configure" "configure --with-svgalib" ein.
134: Sie m�ssen root sein, um die SVGA-Version starten zu k�nnen. Machen Sie UAE
135: besser nicht suid root, wenn Ihnen an der Sicherheit des Systems gelegen ist,
136: oder Sie k�nnten b�se �berraschungen erleben.
137:
138:
139: Kommandozeilen-Optionen
140: =======================
141:
142: Die folgenden Paramter k�nnen Sie UAE in der Kommandozeile �bergeben. Sie
143: k�nnen h�ufig ben�tigte Optionen auch in eine Datei namens "~/.uaerc" (Unix)
144: oder "uae.rc" (andere) schreiben, diese Datei wird von UAE beim Start
145: gelesen (und wahlweise am Ende geschrieben).
146:
147: Allgemeine Optionen:
148: -h : Gibt einen Hilfetext aus, der alle Optionen beschreibt.
149: -f rate : Bildaufbau-Frequenz einstellen. Je h�her "rate" ist, desto
150: schneller wird UAE, aber der Bildaufbau ist nicht mehr fl�ssig,
151: sondern abgehackt. Standard ist "-f 1", f�r manche Programme
152: k�nnte "-f 3" empfehlenswert sein.
153: -a : Keine Erweiterungs"hardware" einbinden. Diese Option schaltet
154: die Harddisk- und Fastmem-Emulation aus, ist aber m�glicherweise
155: f�r einige Programme n�tig.
156: -l lang : Tastatur-Sprache ausw�hlen. F�r deutsche Tastaturen: "-l de"
157: -0 file : "file" wird anstelle von "df0.adf" benutzt, um Laufwerk 0 zu
158: emulieren. -1, -2 und -3 funktionieren auch (der Amiga kann bis zu
159: 4 Floppylaufwerke haben)
160: -r file : "file" wird als Kickstart-ROM-Datei benutzt.
161: -J ab : Legt fest, wie Gameport 0 (a) und Gameport 1 (b) des Amigas
162: emuliert werden. F�r "a" und "b" k�nnen die folgenden Werte
163: eingesetzt werden: "0" (Joystick 0), "1" (Joystick 1), "M" (Maus),
164: "A", "B", "C" (verschiedene Joystickemulationen auf der Tastatur)
165: "A": Zehnerblock (8/4/6/2/0), "B": Cursortasten/Ctrl,
166: "C": T/F/H/B/Alt
167: -x : In der X11-Version von UAE macht diese Option den X-Mauszeiger als
168: Fadenkreuz unsichtbar. In der SVGAlib-Version schaltet sie die
169: Benutzung eines linearen Framebuffers ab, was die Emulation
170: langsamer macht, aber bei Problemen n�tig sein k�nnte.
171: -G : Stellt alle Benutzeroberfl�chen ab. Nur der Emulator wird
172: gestartet.
173: -C specs: Gibt an, welche CPU emuliert werden soll. Das erste Zeichen in
174: "specs" muss sein: '0' f�r 68000, '1' f�r 68010, '2' f�r 68020
175: oder '3' f�r 68020+68881. Danach kann ein 'c' folgen, f�r eine
176: langsamere aber kompatiblere 68000-Emulation, oder ein 'a' f�r
177: eine 68020-Emulation mit 24-Bit-Adressraum.
178:
179: Externe Hardware emulieren (Drucker, serielle Schnittstelle, Harddisk)
180: -M VOLUME:path
181: -m VOLUME:path
182: Hiermit k�nnen Sie ein Verzeichnis Ihrer Festplatte vom Amiga aus
183: nutzen. Wenn Sie "-M sound:/usr/amiga/modules" eingeben, wird auf
184: der Amiga-Seite eine Festplatte namens "SOUND:" emuliert, deren
185: Inhalt sich im Unix-Verzeichnis /usr/amiga/modules befindet.
186: Mit -M wird das Verzeichnis schreibgesch�tzt gemountet.
187: -p cmd : Schaltet die Druckeremulation ein. Sie ben�tigen den
188: Amiga-Postscript-Druckertreiber der Workbench 3.0. Als Parameter
189: cmd �bergeben Sie den Namen des Programms, das zum Drucken
190: gestartet werden soll ("lpr" f�r die meisten Unix-Systeme), bzw.
191: den Namen der parallelen Schnittstelle unter DOS ("PRN").
192: -I dev : Schaltet die Emulation der seriellen Schnittstelle ein. dev gibt
193: dabei den Devicenamen an (etwa "/dev/ttyS1" unter Linux)
194: Funktioniert noch nicht zuverl�ssig.
195:
196: Sound-Optionen:
197: -S specs: Falls Ihre Version von UAE Sound unterst�tzt, k�nnen Sie hiermit
198: einstellen, wie die Soundemulation arbeiten soll. Die "specs"
199: bestehen aus mehreren Feldern: "n:stereo:bits:frequenz:min:max"
200: n = 0: Keine vern�nftige Soundemulation. Diese Einstellung k�nnte
201: in unwahrscheinlichen F�llen inkompatibel sein.
202: n = 1: Soundhardware emulieren, aber keinen Sound ausgeben. Diese
203: Einstellung kann deutlich langsamer sein als n = 0.
204: n = 2: Soundhardware emulieren und Sound ausgeben. Empfohlen.
205: n = 3: Soundhardware _exakt_ emulieren. Sie werden keinen
206: Unterschied h�ren, aber die Emulation kann hierdurch stark
207: ausgebremst werden.
208: stereo kann entweder 's' oder 'm' sein.
209: bits ist normalerweise 8 oder 16, wobei 16 Bit h�here Qualit�t
210: bedeuten.
211: frequenz gibt die Ausgabefrequenz an; h�here Werte sind besser.
212: �blich sind 22050 oder 44100 Hz.
213: min und max geben die Gr��e des Soundpuffers an. Normalerweise
214: betr�gt die Gr��e 8192 Bytes; auf schnellen Maschinen
215: k�nnen kleinere Werte Sinn machen.
216:
217: Speicher-Optionen
218: -s n : n*256K Slow-Memory emulieren (Adresse 0xC00000). Das Zeug, was
219: unten in den A500 reingesteckt wird. Manche Programme brauchen es,
220: obwohl haufenweise anderer Speicher vorhanden ist.
221: -F n : n MB Fast-Memory emulieren (Adresse 0x200000). Das Zeug, was beim
222: A500 au�er Festplatten in die Seite gesteckt wird.
223: -Z n : n MB Zorro III-Fast-Memory emulieren. Funktioniert nur in der
224: 68020-Emulation, erlaubt aber groessere Speicherbereiche (bis zu
225: 64 MB)
226: -c n : n*512K Chip-Memory. Sollte man nicht �ndern m�ssen, standardm��ig
227: werden 2MB Chip emuliert.
228:
229: Debugging-Optionen:
230: -D : Nicht die Emulation, sondern den eingebauten Debugger starten.
231: -i : Ung�ltige Speicherzugriffe anzeigen.
232: -g : Teile des Betriebssystems emulieren. Dies ist noch nicht sehr
233: stabil und wenig empfehlenswert.
234:
235: Anzeige-Options:
236: -H mode : Anzahl der Farben, in der UAE den Bildschirm darstellen soll,
237: w�hlen
238: -O mode : Bildschirmufl�sung einstellen (s.u.)
239: -U n : n MB Grafikkartenspeicher emulieren. Mit dieser Option wird der
240: Support fuer Picasso96-Grafikkarten eingeschaltet. Diese Option
241: funktioniert nur mit der 68020-Emulation.
242:
243: Der "mode"-Parameter der Option "-O" wird wie folgt angegeben:
244: -O Breite:H�he:Tuning-Parameter
245: wobei Breite und H�he die Dimensionen des Fensters (oder den Grafikmodus)
246: angeben. Die Tuning-Parameter bestehen aus einzelnen Buchstaben, die
247: angegeben werden k�nnen (aber nicht m�ssen):
248: l: Schaltet Lores-Darstellung ein, nur jedes zweite horizontale Pixel wird
249: gezeichnet. Sinnvoll f�r kleine VGA-Aufl�sungen wie etwa 320x200.
250: x,y,X,Y: Wenn "x" angegeben wird, versucht UAE, das dargestellte Bild an
251: der richtigen Stelle am Bildschirm darzustellen. Dies ist nur n�tig,
252: falls die Breite des Fensters weniger als 800 Pixel betr�gt (etwa in
253: 640er oder 320er-Modi). Ohne "x" wird das Bild normalerweise �ber den
254: rechten oder linken Bildschirmrand herausragen. "y" tut dasselbe f�r die
255: vertikale Richtung, es ist nur bei Fenstern n�tig, die weniger als 300
256: Pixel hoch sind. Werden Gro�buchstaben f�r diese Optionen verwendet
257: (X oder Y), so versucht UAE, besonders clever zu sein (aber da ich
258: Computern nicht sehr viel Cleverness zutraue, gibt's auch die dummen
259: Varianten).
260: d: Verdoppelt jede Zeile. Daf�r sollte das Fenster dann mindestens 600
261: Zeilen hoch sein. Der Vorteil ist, da� Interlace-Screens besser
262: dargestellt werden (aber es l�uft auch langsamer).
263: c: Quetscht das Amiga-Bild so, da� es mit den gew�hlten Dimensionen des
264: Fensters so gut wie m�glich �bereinstimmt.
265:
266: Beispiel: "-O 320:200:lXYc" ist der kleinste sinnvolle Modus. Durch das "c"
267: werden Amiga-Screens, die 320x256 Pixel gro� sind, durch Weglassen einzelner
268: Zeilen auf 320x200 gestaucht (ohne "c" werden keine Zeilen zwischendurch
269: weggelassen, es fehlt dann einfach der untere Rand des Bildes).
270: Die gr��te sinnvolle Aufl�sung ist "-O 800:600:d", dazwischen gibt es
271: verschiedene sinnvolle Einstellungen, etwa "-O 640:480:X" oder auch
272: "-O 640:480:XYdc". Am besten, Sie experimentieren ein wenig damit.
273:
274: Farb-Modi: 0 (256 Farben); 1 (32768 Farben); 2 (65536 Farben)
275: 3 (256 Farben, allerdings gerastert um die Qualit�t zu
276: verbessern (ist etwas langsamer als Modus 0)
277: 4 (16 Farben, gerastert); 5 (16 Millionen Farben)
278:
279:
280: H�ufige Probleme
281: ================
282:
283: Manche Kickstart-ROM-Versionen (aus neueren A4000 und A1200) sind f�r den
284: 68020 compiliert, der von UAE derzeit noch nicht 100% emuliert wird, daher
285: laufen diese Kickstarts nicht.
286:
287: Auf manchen Linux-Systemen ist ein kaputter Linker installiert. Falls Sie
288: Fehlermeldungen der Sorte "final link failed: Bad value" beim Compilieren
289: kriegen, sollten Sie sich von sunsite.unc.edu:/pub/Linux/GCC eine neuere
290: Version der binutils besorgen. Allerdings sollten Sie die Hinweise, die in den
291: "release.*"-Dateien stehen, genau beachten.
292:
293:
294: Adresse des Autors
295: ==================
296:
297: [email protected]
298:
299: oder mit der gelben Post:
300:
301: Bernd Schmidt
302: Schlo�weiherstra�e 14
303: 52072 Aachen
304:
305: (bitte nicht anrufen, wenn's geht)
306:
307: Wenn Sie Verst�ndnisprobleme mit diesem Text haben oder Teile der englischen
308: Dokumentation nicht verstehen, versuchen Sie bitte, jemand in Ihrer N�he zu
309: finden, der Ihnen die Dinge erkl�ren/�bersetzen kann. Ich kann nicht jedem
310: Computerneuling noch einmal lang und breit erkl�ren, wie man (beispielsweise)
311: CrossDOS bedient: dazu gibt's bei CrossDOS auch eine Dokumentation. Ich
312: versuche, zu helfen, aber manche Dinge sind zu zeitaufwendig.
313:
314: Bevor Sie eine Frage stellen, �berpr�fen Sie bitte, ob sie nicht in der
315: Dokumentation bereits beantwortet wird.
316: Ich verschicke keine Kickstart-ROM-Dateien oder Amiga-Spiele. Schicken Sie
317: mir bitte auch keine Raubkopien, ich l�sche so etwas sofort. Generell gilt
318: auch, da� Sie keine Dateien, die gr��er als 50KB sind, per email verschicken
319: sollten. Wenn ich 3MB Screenshots oder �hnliches Zeug per email kriege, freue
320: ich mich nicht dar�ber.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.