-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.html
460 lines (449 loc) · 16.9 KB
/
README.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de" lang="de">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<meta name="Content-Language" content="de" />
<meta name="Copyright" content="(c) 2009-2016 Jens Mueller" />
<meta name="Description" content="Kleincomputer-Emulator" />
<title>JKCEMU - Ein in Java entwickelter Kleincomputer-Emulator</title>
</head>
<body>
<h1>JKCEMU</h1>
<h2>1. Allgemeines</h2>
JKCEMU ist ein hauptsächlich in Java entwickelter Software-Emulator,
der die meisten der in der DDR hergestellten Heim- und Kleincomputer
sowie als Bauanleitung veröffentlichten Selbstbaucomputer nachbildet.
<br/><br/>
<h2>2. Lizenzbestimmungen und Haftung</h2>
Die Software JKCEMU darf von jedermann entsprechend den Bedingungen
der GNU General Puplic License (GNU-GPL) Version 3
angewendet und weitergegeben werden.
Weitere Rechte, die in der GNU-GPL nicht aufgeführt sind,
werden ausdrücklich nicht gewährt.
Wird das Programm weiterentwickelt oder der Quelltext teilweise
oder vollständig in anderen Programmen verwendet,
so ist die daraus neu entstandene Software ebenfalls unter der GNU-GPL
zu veröffentlichen und muss einen Copyright-Vermerk mit allen,
auch den ursprünglichen, Rechteinhabern enthalten.
Den originalen Wortlaut der GNU-GPL finden Sie in der Datei
<a href="LICENSE.txt">LICENSE.txt</a>.
Zum besseren Verständnis gibt es auch eine
<a href="src/help/gpl3_de.htm">deutsche Übersetzung</a>.
Diese ist jedoch kein offizieller bzw. rechtskräftiger Ersatz
für den originalen englischsprachigen Wortlaut!
Sollten Sie Verständnisprobleme mit dem englischsprachigen Wortlaut
haben und Ihnen die inoffizielle Übersetzung nicht genügen,
müssen Sie sich selbst um eine juristisch abgesicherte
Übersetzung bemühen,
bevor Sie JKCEMU anwenden, weitergeben oder modifizieren.
Der Autor stellt die Software entsprechend den Bedingungen der GNU-GPL
zur Verfügung.
Der Gebrauch der Software ist kostenfrei und erfolgt deshalb
ausschließlich auf eigenes Risiko!
<br/><br/>
<b>Jegliche Gewährleistung und Haftung ist ausgeschlossen!</b>
<br/><br/>
<h2>3. Von der GNU-GPL ausgenommene Programmteile</h2>
Für den Betrieb von JKCEMU sind ROM-Images der jeweils emulierten
Computer notwendig.
Diese finden Sie im Verzeichnis <em>src/rom</em>.
Des weiteren enthält JKCEMU im Verzeichnis <em>src/disks</em>
auch einige Disketteninhalte.
Die ROM- und Disketten-Images unterliegen nicht der GNU-GPL,
d.h., die Rechte, die Ihnen von der GNU-GPL bzgl. der Benutzung,
Modifizierung und Weitergabe von JKCEMU eingeräumt werden,
gelten nicht für die ROM- und Disketteninhalte!
Jegliche Benutzung dieser ROM- und Disketten-Images außerhalb
von JKCEMU müssen Sie im Zweifelsfall mit den Urhebern
bzw. deren Rechtsnachfolgern klären.
<br/><br/>
<h2>4. Urheberschaften</h2>
<h3>4.1. Urheberschaft am Programmcode</h3>
Die Urheberschaft am Java- und C-Programmcode sowie den dazu
gehörenden Skripten, Beschreibungen, Hilfe-Dateien und Bildern
liegt bei Jens Müller.
Dieser Teil ist unter der GNU General Public License Version 3
(GNU-GPL) freigegeben.
<br/><br/>
Ein Programmcodeteil basiert auf der Arbeit anderer Autoren:
<br/><br/>
<table border="1">
<tr><th>Autor</th><th>Beschreibung</th></tr>
<tr>
<td valign="top">
John Elliott<br/>
Per Ola Ingvarsson
</td>
<td valign="top">
CRC-Berechnung für das CopyQM-Dateiformat<br/>
(aus dem Projekt LIBDSK übernommen und nach Java portiert)
</td>
</tr>
</table>
<br/>
<h3>4.2. Urheberschaften an den ROM- und Disketteninhalten</h3>
<ul>
<li>Akademie der Wissenschaften der DDR, Berlin (CP/A)</li>
<li>
Amstrad plc (KC compact, ZX Spectrum)<br/>
<em>
Amstrad has kindly given their permission for the redistribution
of their copyrighted material but retain that copyright.
</em>
</li>
<li>
Ingenieurhochschule für Seefahrt Warnemünde/Wustrow
(NANOS 2.2)
</li>
<li>
International Research Institute for Management Sciences (IRIMS),
Moskau (MicroDOS)
</li>
<li>Universität Rostock (MicroDOS)</li>
<li>VEB Meßelektronik Dresden (A5105, KC85/1, KC87, Z9001)</li>
<li>VEB Mikroelektronik Erfurt (LC80, SC2)</li>
<li>
VEB Mikroelektronik Mühlhausen
(HC900, KC85/2...5, KC compact, MicroDOS)
</li>
<li>VEB Polytechnik Karl-Marx-Stadt (Poly-Computer 880)</li>
<li>VEB Robotron-Elektronik Riesa (Z1013)</li>
<li>Prof. Dr. Albrecht Mugler (PC/M)</li>
<li>Dr. Dieter Scheuschner (SLC1)</li>
<li>Dr. Frank Schwarzenberg (CP/A für KC85/1, KC87 und Z9001)</li>
<li>Dr. Gerd Maudrich (LLC1)</li>
<li>
Dr. Hans-Jürgen Gatsche (RBASIC-Programme für A5105)
</li>
<li>
Dr. Rainer Brosig (erweitertes Z1013-Monitorprogramm
sowie CP/M für Z1013)
</li>
<li>
Andreas Suske (Monitorprogramm, FDC-Programm und ROM-Bank-Verwaltung
für AC1-2010)
</li>
<li>Bernd Hübler (Hübler/Evert-MC, Hübler-Grafik-MC)</li>
<li>
Christian Schiewe (80-Zeichen-Treiber für KC85/1, KC87 und Z9001)
</li>
<li>Eckart Buschendorf (LC-80.2-Monitorprogramm)</li>
<li>Eckhard Ludwig (SCCH-Software für AC1 und LLC2)</li>
<li>Eckhard Schiller (BCS3 und VCS80)</li>
<li>Frank Heyder (Monitorprogramm 3.1 und MiniBASIC für AC1)</li>
<li>
Frank Ludwig (Joystick-Editor und CAOS-Taschenrechner für KC85/5)
</li>
<li>Frank Prüfer (S/P-BASIC V3.3 für BCS3)</li>
<li>Harald Saegert (RBASIC-Programme für A5105)</li>
<li>Hertbert Mathes (PC/M)</li>
<li>Jens Müller (Diskette mit Bildern für A5105)</li>
<li>Joachim Czepa (C-80)</li>
<li>Klaus-Peter Evert (Hübler/Evert-MC)</li>
<li>Manfred Kramer (Kramer-MC)</li>
<li>
Mario Leubner (CAOS 4.8 und 80-Zeichen-Editor für KC85/5,
D004-ROM-Version 3.31, D008-ROM-Version 3.41, USB-Software
sowie Anpassungen an KC-BASIC, Assembler, Reassembler
und Testmonitor/Debugger für KC85/5)
</li>
<li>Ralf Kästner (KCNet-Software)</li>
<li>Rolf Weidlich (LCTools und BASIC-Adaption für LC-80ex)</li>
<li>Torsten Musiol (Maschinenkode-Editor für BCS3)</li>
<li>
Ulrich Zander (Treiberanpassungen für A5105,
KC85/1, KC87 und Z9001)
</li>
<li>
Volker Pohlers (Demos, Treiber und Softwareanpassungen für
KC85/1, KC87 und Z9001)
</li>
</ul>
<br/><br/>
<h2>5. Installation</h2>
<ol>
<li>
Installieren Sie die Java Runtime Environment (JRE)
der Java Standard Edition (Java SE) Version 7 oder höher.
Alternativ können Sie auch das Java Developmenmt Kit installieren.
Überprüfen Sie die installierte Java-Version durch den
Kommandozeilenaufruf: <tt>java -version</tt>
Für Java 7 muss die Versionsnummer 1.7.x erscheinen.
</li>
<li>
Laden Sie die Datei <em>jkcemu-<Version>.jar</em> von
<a href="http://www.jens-mueller.org/jkcemu">www.jens-mueller.org/jkcemu</a>
herunter.
<em><Version></em> ist dabei durch die konkrete Versionsnummer
zu ersetzen.
Die Datei darf nicht als ZIP-Datei entpackt werden!
</li>
<li>
Kopieren Sie die Datei <em>jkcemu-<Version>.jar</em>
in ein beliebiges Verzeichnis auf die Festplatte ihres Computers,
z.B. unter Linux/Unix nach <tt>/tmp</tt>
oder unter Windows nach <tt>C:\Temp\</tt>
</li>
<li>
Starten Sie JKCEMU
<ul>
<li>
unter Linux/Unix mit: <tt>java -jar /tmp/jkcemu-<Version>.jar</tt>
</li>
<li>
unter Windows in der Eingabeaufforderung mit:
<tt>javaw.exe -jar C:\Temp\jkcemu-<Version>.jar</tt>
</li>
</ul>
</li>
<li>
Legen Sie auf dem Desktop eine
<em>Verknüpfung zu einem Programm</em> an,
und tragen dort die in der Console bzw. Eingabeaufforderung
erfolgreich verwendete Kommandozeile ein.
</li>
<li>
Auf manchen Systemen funktioniert der Start von JKCEMU auch,
indem Sie in einem Datei Manager (z.B. Windows Explorer) einfach
auf die JAR-Datei (doppelt) klicken.
</li>
</ol>
<br/><br/>
<h2>6. Compilieren</h2>
Möchten Sie den Quelltext compilieren,
sind folgende Schritte notwendig:
<ol>
<li>
Stellen Sie sicher, dass das Java Development Kit (JDK)
der Java Standard Edition (Java SE) Version 7 oder höher
installiert ist.
</li>
<li>
Wechseln Sie in das <em>cmd</em>-Verzeichnis des JKCEMU-Quelltextes
</li>
<li>Compilieren Sie
<ul>
<li>unter Linux/Unix mit: <tt>./compile</tt></li>
<li>
unter Windows in der Eingabeaufforderung mit:
<tt>compile.cmd</tt>
</li>
</ul>
</li>
</ol>
Alternativ können Sie auch mit <em>ant</em> compilieren.
Die dazu notwendige Datei <a href="build.xml">build.xml</a> finden Sie
im Wurzelverzeichnis des Quelltextes.
<br/><br/>
<h2>7. Dank</h2>
Die Entwicklung des Emulators war nur möglich durch
die Zuarbeit anderer, vorallem durch Bereitstellung
von Dokumenten und Software.
Dabei hat so mancher ganz unbewusst seinen Anteil an JKCEMU beigetragen,
indem er auf seiner Homepage wichtige Informationen bereithält.
Besonders bedanken möchte ich mich bei:
<br/>
<ul>
<li>
Prof. Dr. Albrecht Mugler für die freundliche Genehmigung
zur Integration der PC/M-Systemsoftware
(BIOS, V-Tape, Debugger, CCP und BDOS) in JKCEMU
</li>
<li>
Dr. Dieter Scheuschner für die Bereitstellung
des ROM-Inhalts des SLC1 und für die freundliche Genehmigung,
diesen in JKCEMU integrieren zu dürfen
</li>
<li>
Dr. Gerd Maudrich für die freundliche Genehmigung zur Integration
des LLC1-ROM-Images (Monitorprogramm und Tiny-BASIC-Interpreter)
in JKCEMU
</li>
<li>
Dr. Hans-Jürgen Gatsche für die freundliche Genehmigung,
von ihm entwickelte RBASIC-Programme für den A5105
in JKCEMU integrieren zu dürfen
</li>
<li>André Schenk für das ANT-Skript</li>
<li>
Andreas Suske für die freundliche Genehmigung
zur Integration seiner AC1-2010-Software
(Monitorprogramm, FDC-Programm und ROM-Bank-Verwaltung)
in JKCEMU sowie für seine Hilfe bei der AC1-Emulation
</li>
<li>
Claus-Peter Fischer für die Bereitstellung
eines ROM-Images zum PC/M
</li>
<li>
Cliff Lawson (Amstrad plc) für die allgemeine Erlaubnis
zur Integration der unter dem Urheberrecht von Amstrad stehenden ROMs
in Emulatoren.
</li>
<li>
Eckhard Schiller für die freundliche Genehmigung
zur Integration des VCS80- und der BCS3-ROM-Images in JKCEMU
</li>
<li>
Enrico Grämer für die Bereitstellung von Material
zum KC compact
</li>
<li>
Frank Ludwig für die freundliche Genehmigung
zur Integration der von ihm entwickelten bzw. mitentwickelten
KC85/5-Software in JKCEMU
</li>
<li>
Frank Prüfer für die freundliche Genehmigung
zur Integration von S/P-BASIC 3.3 in JKCEMU
sowie für die Unterstützung bei der BCS3-Emulation
</li>
<li>
Gunar Hänke für seine Hilfe bei der AC1-
und Diskettenemulation
</li>
<li>
Heiko Poppe für die freundliche Genehmigung
zur Integration des CP/M File-Commanders in JKCEMU
sowie für seine Hilfe bei der AC1-,
K1520-Farbgrafikkarten- und USB-Emulation
</li>
<li>
Herbert Mathes für die freundliche Genehmigung
zur Integration der PC/M-Systemsoftware
(BIOS, V-Tape, Debugger, CCP und BDOS) in JKCEMU
</li>
<li>
Holger Bretfeld für die leihweise Bereitstellung eines KC85/5
mit D004
</li>
<li>Jan Kuhnert für das intensive Testen des Emulators</li>
<li>
Johann Spannenkrebs für seine Homepage
<a href="http://www.ac1-info.de">www.ac1-info.de</a>
sowie für seine Hilfe bei der AC1- und Poly880-Emulation
</li>
<li>
John Elliott für die freundliche Genehmigung,
Programmcodeteile aus dem Projekt LIBDSK übernehmen
zu dürfen (CRC-Berechnung für das CopyQM-Dateiformat)
</li>
<li>
Jörg Felgentreu für seine Unterstützung
bei der A5105-Emulation
</li>
<li>
Jürgen Helas für das intensive Testen
des Assemblers und Reassemblers
</li>
<li>
Klaus Junge für die Unterstützung bei der NANOS-Emulation
</li>
<li>
Klaus Wilfling für die freundliche Genehmigung zur Integration
des von Ihm um Farbfunktionalität erweiterten EPOS
sowie für die Unterstützung bei der K1520-Sound-
und NANOS-Emulation
</li>
<li>
Manfred Kramer für die freundliche Genehmigung zur Integration
der Systemsoftware des Kramer-MC in JKCEMU
</li>
<li>
Mario Leubner für die freundliche Genehmigung
zur Integration der von ihm entwickelten und weiterentwickelten
CAOS-, EDAS-, D004-, D008- und USB-Software in JKCEMU
sowie für seine sehr aktive und umfangreiche Hilfe im KC85/2..5-,
USB-, Disketten- und Festplattenumfeld
</li>
<li>
Matthias Haustein für die Hilfe bei der Emulation
von Z1013-128-Funktionalitäten
</li>
<li>
Norbert Richter für die Bereitstellung von Informationen
und Software zum AC1
</li>
<li>
Peter Salomon für seine Homepage
<a href="http://www.robotron-net.de">www.robotron-net.de</a>
</li>
<li>
Ralf Däubner für seine Hilfe bei der A5105-Emulation
</li>
<li>
Ralf Kästner für die freundliche Genehmigung
zur Integration der von ihm entwickelten KCNet-Software in JKCEMU,
für seine Homepage <a href="http://kc85.info">kc85.info</a>
sowie für die Hilfe bei der KC85/2..5- und Netzwerk-Emulation
</li>
<li>
Ralph Hänsel für seine umfangreiche Hilfe
bei der AC1-, Disketten-, Festplatten- und USB-Emulation
</li>
<li>
René Nitzsche für die leihweise Bereitstellung eines KC85/5
sowie für das Testen des BASIC-Compilers
</li>
<li>
Rolf Weidlich für die freundliche Genehmigung zur Integration
seiner LC-80ex-Software (LCTools und BASIC-Adaption)
sowie für die intensive Unterstützung bei der AC1-, LC-80-,
LLC1- und LLC2-Emulation und der Emulation des KC85/2..5-Moduls M066
</li>
<li>
Siegfried Schenk für die Bereitstellung von Informationen
und Software zum LLC2 und zu den SCCH-Modulen
</li>
<li>
Steffen Gruhn für seine Hilfe bei der A5105-
und KC-compact-Emulation
</li>
<li>
Stephan Linz für seine Hilfe bei der PC/M-Emulation,
der Bereitstellung von Disketten-Images und PC/M-Systemprogrammen
sowie für seine Homepage
<a href="http://www.li-pro.net">www.li-pro.net</a>
</li>
<li>
Thomas Scherrer für seine Z80-Seite
<a href="http://www.z80.info">www.z80.info</a>
</li>
<li>
Torsten Paul für seinen Emulator
<a href="http://kcemu.sourceforge.net">KCemu</a>
und für die Bereitstellung von Informationen und ROM-Images
zu diversen Computern
</li>
<li>
Ulrich Zander für seine Homepage
<a href="http://www.sax.de/~zander">www.sax.de/~zander</a>
und für seine Unterstützung bei der A5105-,
KC85/1-, KC87- und Z9001-Emulation
</li>
<li>
Volker Pohlers für seine Homepage
<a href="https://hc-ddr.hucki.net">hc-ddr.hucki.net</a>
sowie für seine vielseitige Unterstützung
</li>
<li>all denen, die Fehler gefunden und gemeldet haben</li>
<li>den aktiven Mitgliedern im Robotrontechnikforum</li>
</ul>
<br/><br/>
<h2>8. Kontakt</h2>
<table border="0">
<tr><td>Autor:</td><td>Jens Müller</td></tr>
<tr>
<td>E-Mail</td>
<td><a href="mailto:[email protected]">[email protected]</a></td>
</tr>
</table>
<br/>
Ihre Mail muss im Betreff das Wort <em>JKCEMU</em> enthalten.
Anderenfalls wird sie möglicherweise vom Spam-Filter
zurückgehalten.
<br/><br/>
</body>
</html>