home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / u / uae / Docs / LIESMICH < prev    next >
Text File  |  1997-06-03  |  15KB  |  314 lines
  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. UAE ist Copyright 1995-97 Bernd Schmidt & Co-Autoren (siehe die Datei
  12. CREDITS). UAE ist Freeware, es darf nichtkommerziell verbreitet werden,
  13. vorausgesetzt alle Dateien werden unverändert in einem Archiv verbreitet, ohne
  14. daß Dateien hinzugefügt oder weggelassen werden. Der Preis, der dafür verlangt
  15. wird, darf die Materialkosten nicht wesentlich übersteigen, es darf damit kein
  16. Profit gemacht werden. Einzige Ausnahme sind Sammlungen von PD-Software,
  17. Freeware und Shareware auf CD-ROM, bei denen mehrere Hundert frei vertreibbare
  18. Programme enthalten sind. Es gibt keinerlei Garantie für das Funktionieren des
  19. Programms, Sie benutzen es auf eigene Gefahr, der Autor übernimmt keinerlei
  20. Haftung für irgendwelche Schäden, die direkt oder indirekt durch die Benutzung
  21. des Programms entstehen.
  22.  
  23. Wie ich es hasse, so einen Krampf zu schreiben. Jetzt zu interessanteren
  24. Dingen:
  25.  
  26. [Anmerkung: Manche Versionen von UAE, etwa die DOS- und die Mac-Version haben
  27. zusätzliche Readme-Dateien, die Sie ebenfalls lesen sollten, da manche Details
  28. von der Unix-Version abweichen.]
  29.  
  30. Übersicht
  31. =========
  32.  
  33. UAE emuliert einen A500 mit bis zu 2MB Chipram und 8.5MB Fast-RAM. Die
  34. Emulation ist nahezu vollständig. Ursprünglich wurde UAE für Unix-ähnliche
  35. Systeme (ich selbst benutze Linux) geschrieben, hauptsächlich deswegen, weil
  36. Programmieren unter anderen Betriebssystemen Strafarbeit ist (Fehler=>Absturz).
  37. Die Hard-/Softwarevoraussetzungen für den Betrieb der Unix-Version sind:
  38.   - 8MB RAM, besser 12-16MB
  39.   - ein schneller Prozessor (i486 ist nicht das Gelbe vom Brot)
  40.   - X11, oder SVGAlib unter Linux
  41.   - ein ANSI-C-Compiler, am besten GCC.
  42.   - optional: Tcl7.4/Tk4.0
  43.  
  44. Vorbereitungen
  45. ==============
  46.  
  47. Zugriffe auf das Diskettenlaufwerk können nur über einen Umweg emuliert 
  48. werden, da PCs keine Amiga-Disketten lesen können. UAE verwendet 
  49. "Diskfiles", das sind genaue Abbilder des Inhalts einer Amiga-Diskette. Solche
  50. Diskfiles sind 901120 Bytes groß und können mit dem Tool "transdisk", das UAE 
  51. beiliegt erstellt werden. Um UAE laufenzulassen, benötigen Sie außerdem ein 
  52. Abbild eines Amiga-Kickstart-ROMs. Dieses kann aus Copyrightgründen nicht mit 
  53. UAE vertrieben werden. Es muß mit dem Tool "transrom" erzeugt werden.
  54. Die beiden Programme finden Sie im Unterverzeichnis "amiga". Sie müssen sie
  55. zunächst auf Ihren Amiga kopieren, entweder über ein serielles Nullmodem-Kabel
  56. oder mit Hilfe eines Amiga-Programms wie etwa CrossDOS oder MessyDOS, die es
  57. ermöglichen, PC-Disks mit einem Amiga zu lesen und zu beschreiben. Dieselbe
  58. Methode kann dann selbstverständlich auch benutzt werden, um Amiga-Dateien auf
  59. den PC zu kopieren. CrossDOS ist seit einiger Zeit Bestandteil des
  60. Amiga-Betriebssystems, und MessyDOS ist frei erhältlich (u.a. auf einer 
  61. älteren Fish-Disk, Nummer habe ich vergessen). Beachten Sie, daß in vielen
  62. Amigas nur DD-Laufwerke eingebaut sind, die PC-üblichen HD-Disketten lassen
  63. sich damit nicht verarbeiten.
  64. Wenn Sie die Lösung mit dem Nullmodemkabel benutzen wollen, werden Sie zwei
  65. Terminalprogramme benötigen, sowohl für den PC als auch für den Amiga.
  66. Bitte lesen Sie in den jeweiligen Anleitungen der Programme (etwa CrossDOS 
  67. oder die Terminalprogramme) nach, wie diese Programme zu bedienen sind.
  68. Nachdem Sie transrom und transdisk auf den Amiga kopiert haben, müssen Sie dem
  69. AmigaOS beibringen, daß diese Dateien ausführbare Programme sind. Das
  70. geschieht durch den CLI-Befehl
  71.  
  72.   "protect transrom rwed" (bzw. "protect transdisk rwed")
  73.  
  74. Danach können Sie die Programme aufrufen:
  75.  
  76.   transrom >RAM:kick.rom
  77.   
  78. erzeugt eine 524288 Byte große Kickstart-Datei in der Ramdisk. Diese müssen
  79. Sie auf Ihren PC übertragen und dort in dasselbe Verzeichnis kopieren, in dem
  80. UAE installiert ist.
  81. Mit 
  82.   transdisk >RAM:df0.adf
  83.   
  84. kann die in Laufwerk 0 liegende Diskette in ein Diskettenabbild umgewandelt
  85. werden, welches wiederum in der Ramdisk gespeichert wird. Hierbei kann ein
  86. Problem auftreten, wenn Ihr Amiga wenig Speicher hat (wenn er _sehr_ wenig
  87. Speicher hat, funktioniert schon der obige transrom-Befehl nicht; dann haben
  88. Sie leider Pech gehabt). Sie können die Diskette in mehreren Stücken
  89. übertragen. Eine Amiga-Diskette hat 80 Spuren (0..79); mit den Befehlen
  90.  
  91.   transdisk >ram:df0_1.adf -s 0 -e 19
  92.   transdisk >ram:df0_2.adf -s 20 -e 39
  93.   transdisk >ram:df0_3.adf -s 40 -e 59
  94.   transdisk >ram:df0_4.adf -s 60 -e 79
  95.  
  96. werden vier Teil-Disketten-Abbilder erstellt, (z.B. enthält df0_1.adf gerade
  97. die Spuren 0 bis 19). Es macht natürlich keinen Sinn, die Befehle in obiger
  98. Reihenfolge aufzurufen, Sie sollten immer nur jeweils eine Datei erzeugen, auf
  99. den PC übertragen, aus der Amiga-Ramdisk löschen und dann fortfahren.
  100. Die vier Dateien lassen sich dann auf dem PC wieder zu einer zusammensetzen,
  101. entweder unter DOS mit
  102.  
  103.   COPY /B df0_1.adf+df0_2.adf+df0_3.adf+df0_4.adf df0.adf
  104.  
  105. oder unter Unix:
  106.  
  107.   cat df0_1.adf df0_2.adf df0_3.adf df0_4.adf >df0.adf
  108.  
  109. UAE benötigt die Datei "kick.rom" (524288 Byte) und eine Datei "df0.adf"
  110. (901120 Byte), um etwas Sinnvolles zu tun. Diese müssen im gleichen
  111. Verzeichnis stehen, wie UAE.
  112. Die Datei, die das Kickstartabbild enthält, dürfen Sie nicht weitergeben, da
  113. sie Code enthält, dessen Copyright Commodore-Amiga hält. Ebenso dürfen die
  114. meisten Diskettenabbilder (etwa die Workbench, oder kommerzielle Spiele) nicht
  115. weiterverbreitet werden. Sie dürfen mit UAE nur Software benutzen, für die Sie
  116. das Nutzungsrecht haben.
  117.  
  118.  
  119. Compilierung
  120. ============
  121.  
  122. Die Versionen für Unix, NextStep und BeBox müssen zunächst compiliert werden.
  123. Für die BeBox müssen Sie dafür ins Verzeichnis "src" gehen und
  124.  
  125.   make -f Makefile.Be
  126.   
  127. eingeben, auf anderen Systemen müssen Sie zunächst
  128.  
  129.   configure
  130.  
  131. aufrufen; dieses Skript analysiert Ihr System und sammelt Informationen (aber
  132. im Gegensatz zu MessySoft-Produkten schickt es sie nicht übers Netz an andere
  133. Leute, sondern erstellt nur die Dateien "Makefile" und "sysconfig.h"). Danach
  134. können Sie mit
  135.  
  136.   make
  137.   
  138. UAE compilieren. Am Ende sollte eine ausführbare Datei namens "uae" entstanden
  139. sein. Falls Sie unter Linux die SVGAlib- anstelle der X11-Version benutzen
  140. möchten, geben Sie statt "configure" "configure --with-svgalib" ein.
  141. Sie müssen root sein, um die SVGA-Version starten zu können. Machen Sie UAE
  142. besser nicht suid root, wenn Ihnen an der Sicherheit des Systems gelegen ist,
  143. oder Sie könnten böse Überraschungen erleben.
  144.  
  145.  
  146. Kommandozeilen-Optionen
  147. =======================
  148.  
  149. Die folgenden Paramter können Sie UAE in der Kommandozeile übergeben. Sie 
  150. können häufig benötigte Optionen auch in eine Datei namens "~/.uaerc" (Unix)
  151. oder "uae.rc" (andere) schreiben, diese Datei wird von UAE beim Start
  152. gelesen (und wahlweise am Ende geschrieben).
  153.  
  154. Allgemeine Optionen:
  155.  -h      : Gibt einen Hilfetext aus, der alle Optionen beschreibt.
  156.  -f rate : Bildaufbau-Frequenz einstellen. Je höher "rate" ist, desto
  157.            schneller wird UAE, aber der Bildaufbau ist nicht mehr flüssig,
  158.        sondern abgehackt. Standard ist "-f 1", für manche Programme
  159.        könnte "-f 3" empfehlenswert sein.
  160.  -a      : Keine Erweiterungs"hardware" einbinden. Diese Option schaltet
  161.            die Harddisk- und Fastmem-Emulation aus, ist aber möglicherweise
  162.        für einige Programme nötig.
  163.  -l lang : Tastatur-Sprache auswählen. Für deutsche Tastaturen: "-l de"
  164.  -0 file : "file" wird anstelle von "df0.adf" benutzt, um Laufwerk 0 zu
  165.            emulieren. -1, -2 und -3 funktionieren auch (der Amiga kann bis zu 
  166.        4 Floppylaufwerke haben)
  167.  -r file : "file" wird als Kickstart-ROM-Datei benutzt.
  168.  -J ab   : Legt fest, wie Gameport 0 (a) und Gameport 1 (b) des Amigas
  169.            emuliert werden. Für "a" und "b" können die folgenden Werte
  170.            eingesetzt werden: "0" (Joystick 0), "1" (Joystick 1), "M" (Mau