1------------------------------------------------------------------------------- 2$Id: README.de,v 1.2 2002/06/09 14:24:31 torsten_paul Exp $ 3------------------------------------------------------------------------------- 4 5 _ ______ 6 | |/ / ___|___ _ __ ___ _ _ 7 | ' / | / _ \ '_ ` _ \| | | | 8 | . \ |__| __/ | | | | | |_| | 9 |_|\_\____\___|_| |_| |_|\__,_| 10 ================================= 11 12 Copyright (c) 1997-2002 Torsten Paul 13 Lommatzscher Str. 26 14 01139 Dresden 15 Torsten.Paul@gmx.de 16 Alle Rechte Vorbehalten 17 18------------------------------------------------------------------------------- 19 README 20------------------------------------------------------------------------------- 210. Inhalt 22 23 1. COPYRIGHT 24 2. Installation 25 3. Konfiguration 26 4. Das Programm 'kcemu-remote' 27 5. Das Floppy-System 28 29------------------------------------------------------------------------------- 301. COPYRIGHT 31 32 This program is free software; you can redistribute it and/or modify 33 it under the terms of the GNU General Public License as published by 34 the Free Software Foundation; either version 2, or (at your option) 35 any later version. 36 37 This program is distributed in the hope that it will be useful, 38 but WITHOUT ANY WARRANTY; without even the implied warranty of 39 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 40 GNU General Public License for more details. 41 42 You should have received a copy of the GNU General Public License 43 along with this program; if not, write to the Free Software 44 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 45 46------------------------------------------------------------------------------- 472. Installation 48 49 Die Installation erfolgt normalerweise einfach durch: 50 51 ./configure 52 make 53 make install 54 55 Eventuell ist es f�r den letzten Schritt notwendig, sich vorher als 'root' 56 anzumelden. 57 58 Soll der Emulator nur f�r einen User und in dessen Verzeichnis installiert 59 werden, kann auch der folgende Aufruf genutzt werden. 60 61 ./configure --prefix=$HOME 62 make 63 make install 64 65 Damit wird der Emulator in das Verzeichnis "$HOME/bin" und die 66 Daten-Dateien in die Verzeichnisse "$HOME/share/KCemu" und 67 "$HOME/share/locale/..." installiert. 68 69------------------------------------------------------------------------------- 703. Konfiguration 71 72 In der Datei .kcemurc k�nnen eine Reihe von Einstellungen vorgenommen 73 werden. Diese Datei mu� im Homeverzeichnis des Benutzers liegen. 74 Eine Beispieldatei befindet sich mit dem Namen kcemurc.sample im 75 Verzeichnis doc des Programmarchivs. Diese Datei enh�lt auch die 76 Beschreibungen f�r die m�glichen Eintr�ge. 77 78 Jeder Eintrag in dieser Datei hat die Form: 79 80 <Name des Schl�ssels>: <Wert> 81 82 z.B.: 83 Tape File: /tmp/x.kct 84 85 Zus�tzlich gibt es noch die M�glichkeit f�r bestimmte Namen mehrere Werte 86 zuzuweisen. Dies geschieht indem an den eigentlichen Namen des Schl�ssels 87 durch _ getrennt eine 8-stellige Dezimalzahl angeh�ngt wird: 88 89 z.B.: 90 Tape File List_00000000: /home/tp/projects/KCemu/PRG/files.kct 91 Tape File List_00000001: /home/tp/projects/KCemu/PRG/test.kct 92 Tape File List_00000002: /home/tp/projects/KCemu/PRG/wordpro.kct 93 94 Zeilen, die mit einem # beginnen sind Kommentarzeilen und werden 95 beim Einlesen ignoriert. 96 97------------------------------------------------------------------------------- 984. Das Programm 'kcemu-remote' 99 100 Mit dem Programm kcemu-remote kann der Emulator von au�en gesteuert 101 werden. Die Kommunikation erfolgt �ber den X-Server, was bedeutet, da� 102 das Programm kcemu-remote nicht auf dem selben Rechner laufen mu�, wie 103 der Emulator. Es mu� jedoch auf das gleiche Display zugreifen (wird 104 normalerweise durch die Umgebungsvariable $DISPLAY gesteuert). 105 106 Laufen zwei Emulatoren gleichzeitig, wird einer zuf�llig ausgew�hlt. 107 Zur Zeit ist es noch nicht m�glich, einen speziellen Emulator anzugeben. 108 109 Der Aufruf des Programms erfolgt mit: 110 111 kcemu-remote <Kommando> <Parametername>=<Wert> <Parametername>=<Wert> ... 112 113 Die wichtigsten Kommandos sind in der folgenden Tabelle aufgelistet 114 (Wenn Dateinamen als Parameter angegeben werden, m�ssen das zur Zeit 115 immer absolute Dateinamen sein!) 116 117 +------------------+-----------+-----------------------------------------+ 118 | Kommando | Parameter | Wert | 119 +------------------+-----------+-----------------------------------------+ 120 | emu-reset | - | Reset des Emulators | 121 | | | | 122 | | | Entspricht dem Reset-Knopf des KCs, | 123 | | | Programme bleiben im Speicher. | 124 +------------------+-----------+-----------------------------------------+ 125 | emu-power-on | - | Power-On Reset des Emulators | 126 | | | | 127 | | | Entspricht dem Ausschalten und wieder | 128 | | | Einschalten des KCs, der komplette | 129 | | | Speicher wird gel�scht. | 130 +------------------+-----------+-----------------------------------------+ 131 | emu-quit | - | Beenden des Emulators | 132 +------------------+-----------+-----------------------------------------+ 133 | kc-image-load | filename | Dateiname der zu ladenden Datei | 134 | | | Die Datei wird nur geladen, ausf�hrbare | 135 | | | Programme werden nicht gestartet. | 136 | | | | 137 | | | (Entspricht dem Men�punkt File/Load) | 138 +------------------+-----------+-----------------------------------------+ 139 | kc-image-run | filename | Dateiname der zu startenden Datei | 140 | | | | 141 | | | (Entspricht dem Men�punkt File/Run) | 142 +------------------+-----------+-----------------------------------------+ 143 | floppy-attach | filename | Dateiname des Disketten-Images | 144 | | | | 145 | | | Es kann nur auf das physisch erste | 146 | | | Diskettenlaufwerk zugegriffen werden. | 147 | | | | 148 | | | (Da der Men�punkt zum Einlegen von | 149 | | | Disketten noch nicht funktioniert, ist | 150 | | | das die einzige M�glichkeit Disketten | 151 | | | zu wechseln :-) | 152 +------------------+-----------+-----------------------------------------+ 153 | keyboard-replay | text | Text der an den Emulator gesendet wird. | 154 | | | Der Emulator tut dann so, als w�rden | 155 | | | die entsprechenden Zeichen �ber die | 156 | | | Tastatur eingegeben. | 157 +------------------+-----------+-----------------------------------------+ 158 159------------------------------------------------------------------------------- 1605. Das Floppy-System 161 162 Der Start des Floppy-Systems erfolgt im CAOS-Men� �ber den Befehl JUMP. 163 Da der Modulschacht des Floppy-Systems immer auf FC festgelegt ist, 164 lautet der Befehl: 165 166 JUMP FC 167 168 Bei eingelegter CAOS-Erweiterungsdiskette erfolgt die Initialisierung des 169 Floppy-Systems und danach der R�cksprung ins CAOS-Men�. Dort existiert 170 nun ein neuer Men�punkt FLOAD (KC85/3): 171 172 * HC-CAOS 3.1 * 173 %FLOAD 174 %BASIC 175 %REBASIC 176 % 177 %SWITCH 178 %JUMP 179 %MENU 180 %SAVE 181 %VERIFY 182 %LOAD 183 %COLOR 184 %MODIFY 185 %DISPLAY 186 %KEYLIST 187 %KEY 188 189 Mit diesem neuen Befehl k�nnen nun Dateien von Diskette geladen werden. 190 Die CAOS-Diskette enth�lt die folgenden Programme: 191 192 DEP.COM 193 FSAVE.KCC 194 FLOAD.KCC 195 SERVICE.KCC 196 BASEX.KCC 197 DEVEX.KCC 198 TEXOREX.KCC 199 FORTHEX.KCC 200 INITIAL.SUB 201 202 Erweiterte Funktionen erh�lt man durch Laden des Programms SERVICE: 203 204 %FLOAD 205 NAME :SERVICE 206 207 Danach gibt es die zus�tzlichen Men�punkte: 208 209 %FSAVE 210 %DIR 211 %STAT 212 %REN 213 %ERA 214 %SETRO 215 %SETWR 216 217 Weiterf�hrende Hinweise gibt es in den Handb�chern zum Floppy-System D004, 218 die unter der folgenden Adresse des KC-Clubs erreichbar sind: 219 220 http://www.iee.et.tu-dresden.de/~kc-club/05/0500.HTML 221 222------------------------------------------------------------------------------- 223Have fun! 224 225-- 226Torsten Paul 227Torsten.Paul@gmx.de 228