Repository files navigation

JKCEMU is a software emulator primarily developed in Java thatmimics the most of the "Heim- und Kleincomputer" produced inthe GDR as well as most of already published self-made computer.

The emulation supports a number of additional hardware, e.g.floppy disk drives, extended graphic modules, Joysticks andspecific network and USB adapters.

Emulated computers:

A5105 (BIC, ALBA PC 1505), AC1 and AC1-2010, BCS3, C-80, HC900,Huebler/Evert-MC, Huebler-Grafik-MC, KC85/1, KC85/2, KC85/3,KC85/4, KC85/5, KC87, KC compact, Kramer-MC, LC-80 and LC-80ex,LLC1, LLC2, NANOS, PC/M (Mugler/Mathes-PC), Poly-Computer 880,Schachcomputer SC2, Schach- und Lerncomputer SLC1, VCS80, Z1013,Z9001, ZX-Spectrum,user customizable system

Integrated Tools:

Assembler, Disassembler (Reassembler), BASIC Compiler, Debugger,Audio Recorder, Floppy Disk Image Inspector, Calculator, FileBrowser, File Converter, File Search Engine, Image Viewer, MemoryEditor, Text-File Editor, Hex-File Editor, Hex-File Comparison,Checksum and Hash Value Calculation

Special Features:

Network Emulation, USB Emulation, Floppy Disk Emulation, Hard DiskEmulation (GIDE), CP/M Floppy Disk Image creation, CP/M FloppyDisk (Image) packaging, Files and Programs stored on AudioCompact Casset, Joysticks, ZEXALL and ZEXDOC

You will need the Java Development Kit (JDK) Version 7 or laterandANT. You can also easily use theOpenJDK.

git clone https://github.com/lipro-cpm4l/jkcemu.gitcd jkcemu

ant jarjava -jar jkcemu.jar

Original written by Jens Müllerjens@mueller-franke.de anddistributed under the GNU General Public License version 3.

Primary-site:http://www.jens-mueller.org/jkcemu/

At least, you have to read the origin author's hints athttp://www.jens-mueller.org/jkcemu/forks.html (German). Hereyou will see a short and may be incomplete translation.

I have independently extended the section "ROM and floppy diskcontent" to clarify the authorship and licensing of CP/M.

Primary-site:http://www.jens-mueller.org/jkcemu/license.html (German)

The software JKCEMU may be used and passed on by everyone, alsofor commercial purposes, in accordance with the provisions of theGNU General Public License (GNU-GPL) Version 3. Other rights thatare not listed in the GNU-GPL are expressly not granted. If theprogram is developed further or the source text is used in partor in full in other programs, the software that has been createdfrom this must also be published under the GNU-GPL and mustcontain a copyright notice with all, including the original,rights holders. You can find the original wording of the GNU-GPLin the fileLICENSE.txt or on the originalGNU-Homepage. Thereis also aGerman translationfor better understanding. However, this is not an official orlegally binding replacement for the original English languagewording! If you have problems understanding the English languagewording and the unofficial translation is not enough for you,you have to make a legally secure translation yourself beforeyou use, pass on or modify JKCEMU.

The author provides the software in accordance with the terms ofthe GNU-GPL. The use of the software is free of charge and istherefore only at your own risk!No warranty or liability!

Any guarantee and liability is excluded!

If you intend to modify JKCEMU and publish modified versions (e.g.by creating a fork on a public server), then please read the"Instructions for modifying JKCEMU (German)"!

ROM images of the emulated computers are required to operateJKCEMU. You can find this in the directorysrc/rom.Furthermore JKCEMU also contains some floppy disk content imagesin thesrc/disks directory. The ROM and floppydisk images are not subject to the GNU-GPL, this means that:The rights granted by the GNU-GPL regarding the use,modification and distribution of JKCEMU do not apply to thecontents of the ROM and floppy disk images! Any use of theseROM and floppy disk images outside of JKCEMU or outside of apurely private, non-commercial environment must be clarifiedwith the respective original authors or their legal successors.

Primary-site:http://www.jens-mueller.org/jkcemu/license.html (German)

Jens Müller is the originator of the Java and C source codeas well as the associated scripts, descriptions, help files andpictures. This part is released and distributed under the GNUGeneral Public License (GNU-GPL) Version 3.

A few parts of the source code are based on the work of otherauthors:

• John Elliott,Per Ola Ingvarsson:CRC calculation for the CopyQM file format(taken over from theLIBDSKproject and ported to Java)
• Spencer W. Thomas,Jim McKie,Steve Davies,Ken Turkowski,James A. Woods,Joe Orost,David Rowley:Authors of the source filescompress.candgifcompr.con which the implementation of the LZW encoder contained in theJKCEMU is based (is required for creating animated GIF files,video screen recording, and also ported to Java)

The authorship of the ROM and floppy disk content are:

• Akademie der Wissenschaften der DDR (Academy of Science of GDR),Berlin (CP/A)
• Amstrad plc (KC compact, ZX Spectrum)

Amstrad have kindly given their permission for theredistribution of their copyrighted material but retainthat copyright.

• Ingenieurhochschule für Seefahrt (College of engineering for marinetraffic) Warnemünde/Wustrow (NANOS 2.2)
• International Research Institute for Management Sciences (IRIMS),Moskau (MicroDOS)
• University Rostock (MicroDOS)
• VEB Datenverarbeitungszentrum Rostock (EPOS)
• VEB Messelektronik Dresden (A5105, KC85/1, KC87, Z9001)
• VEB Mikroelektronik Erfurt (LC80, SC2)
• VEB Mikroelektronik Muehlhausen (HC900, KC85/2...5, KC-compact,MicroDOS)
• VEB Polytechnik Karl-Marx-Stadt (Poly-Computer 880)
• VEB Robotron-Elektronik Riesa (Z1013)
• Prof. Dr. Albrecht Mugler (PC/M)
• Dr. Dieter Scheuschner (SLC1)
• Dr. Frank Schwarzenberg (CP/A for KC85/1, KC87 and Z9001)
• Dr. Gerd Maudrich (LLC1)
• Dr. Hans-Jürgen Gatsche (RBASIC programs for A5105)
• Dr. Rainer Brosig (extended Z1013 monitor program and CP/M for Z1013)
• Andreas Suske (FDC program and ROM bank management for AC1-2010)
• Bernd Hübler (Hübler/Evert-MC, Hübler-Grafik-MC)
• Christian Schiewe (80 character driver for KC85/1, KC87 and Z9001)
• Eckart Buschendorf (LC-80.2 monitor program)
• Eckhard Ludwig (SCCH software for AC1 and LLC2)
• Eckhard Schiller (BCS3 and VCS80)
• Frank Heyder (monitor program 3.1 und MiniBASIC for AC1)
• Frank Prüfer (S/P-BASIC V3.3 for BCS3)
• Harald Saegert (RBASIC programs for A5105)
• Herbert Mathes (PC/M)
• Joachim Czepa (C-80)
• Klaus Wilfling (EPOS adaption)
• Klaus-Peter Evert † (Hübler/Evert-MC)
• Manfred Kramer (Kramer-MC)
• Mario Leubner (CAOS 4.5 and EDAS for KC85/5, D004 ROM versions 3.2and 3.3 and USB software)
• Ralf Kästner (KCNet software)
• Rolf Weidlich (LCTools and BASIC adaption for LC-80ex)
• Torsten Musiol (maschine code editor for BCS3)
• Ulrich Zander (driver adaption for A5105, KC81/1, KC87 and Z9001)
• Volker Pohlers (demos, drivers and software adaptions for KC85/1,KC87 and Z9001)

Additionals about CP/M source and program code legalization:

From Wikipedia"Source code releases"(Jan 2020):In 1997 and 1998 Caldera released some CP/M 2.2 binaries and sourcecode under anopen source license[FOR NON-COMMERCIAL USE ONLY], alsoallowing the redistributionand modification of further collected Digital Research files relatedto the CP/M and MP/M familiesthrough Tim Olmstead's"The Unofficial CP/M Web site"since 1997. After Olmstead's death on 12 September 2001, thedistributionlicense was refreshed and expanded by Lineo,who had meanwhile become the owner of those Digital Research assets,on 19 October 2001. In October 2014, to mark the 40th anniversary ofthe first presentation of CP/M, the Computer History Museumreleased early source code versions of CP/M[PROVIDED AS IS FOR NON-COMMERCIAL USE ONLY].

• Lineo, Inc. as legal successor ofCaldera, Inc. andDigital Research, Inc. (CP/M)

[…] Letthis emailrepresent a right to use, distribute, modify, enhance andotherwise make available in a nonexclusive manner the CP/Mtechnology as part of the "Unofficial CP/M Web Site" withits maintainers, developers and community. I further statethat as Chairman and CEO of Lineo, Inc. that I have theright to do offer such a license. […] Bryan Sparks […]

Primary-site:http://www.jens-mueller.org/jkcemu/thanks.html (German)

The development of the emulator was only possible by supportof so many other people, especially by supply of documents andsoftware. Thus, some have contributed their share of JKCEMUquite unconsciously by providing important information ontheir homepage.

Special thanks goes to:

• Prof. Dr. Albrecht Mugler:for the kindly permission to integrate the PC/M systemsoftware (BIOS, V-tape, Debugger, CCP and BDOS) in JKCEMU
• Dr. Dieter Scheuschner:for the provision of all ROM content of the SLC1 and thekindly permission to may integrate this in JKCEMU
• Dr. Gerd Maudrich:for the kindly permission to integrate the LLC1 ROM images(monitor program and BASIC interpreter) in JKCEMU
• Dr. Hans-Jürgen Gatsche:for the kindly permission to may integrate the RBASICprograms for the A5105 in JKCEMU he developed
• André Schenk:for ANT script
• Andreas Suske:for the kindly permission to may integrate his AC1-2010software (monitor program, FDC program and ROM bankmanagement) in JKCEMU and for his help with AC1 emulation
• Claus-Peter Fischer:for the provision of his ROM images of the PC/M
• Cliff Lawson (Amstrad plc):for general permission to integrate Amstrad's copyrighted ROMsinto emulators
• Eckhard Schiller:for the kindly permission to integrate the VCS80 andthe BCS3 ROM images in JKCEMU
• Enrico Grämer:for the provision of material about the KC compact
• Frank Prüfer:for the kindly permission to integrate S/P-BASIC 3.3in JKCEMU and the support with the BCS3 emulation
• Gunar Hänke:for his help with AC1 and floppy disk emulation
• Heiko Poppefor the kindly permission to integrate the CP/M File-Commanderin JKCEMU and his help with AC1, K1520 graphic and USB emulation
• Herbert Mathes:for the kindly permission to integrate the PC/M systemsoftware (BIOS, V-tape, Debugger, CCP and BDOS) in JKCEMU
• Holger Bretfeld:for the loan of a KC85/5 with D004
• Jan Kuhnert:for intensive testing of the emulator
• Johann Spannenkrebs:for his homepagewww.ac1-info.deand his help with AC1 and Poly-Computer 880 emulation
• John Elliott:for the kindly permission to take over parts of source codefrom the LIBDSK project (CRC calculation for the CopyQM fileformat)
• Jörg Felgentreu:for his support with the A5105 emulation
• Jürgen Helas:for intensive testing of the assembler and reassembler
• Klaus Wilfling:for the kindly permission to integrate EPOS in JKCEMUhe extend with color functionality and the supportwith the NANOS emulation
• Klaus Junge:for the support with the NANOS emulation
• Manfred Kramer:for the kindly permission to integrate the Kramer-MCsystem software in JKCEMU
• Mario Leubner:for the kindly permission to integrate the CAOS, EDAS,D004, and USB software in JKCEMU he developed and hisvery active and comprehensive help in the KC85/2..5,USB, floppy and hard disks environment
• Norbert Richter:for the provision of information and software for the AC1
• Peter Salomon:for his homepagewww.robotron-net.de
• Ralf Däubner:for his help with the A5105 emulation
• Ralf Kästner:for the kindly permission to integrate the KCNet softwarein JKCEMU he developed, for his homepagesusowa.homeftp.net and forthe help with the KC85/2..5 and network emulation
• Ralph Hänsel:for his comprehensive help with the AC1, floppy and harddisk, and USB emulation
• René Nitzsche:for the loan of a KC85/5
• Rolf Weidlich:for the support with the AC1, LLC1, and LLC2 emulation
• Siegfried Schenk:for the provision of information and software for the LLC2and the SCCH modules
• Steffen Gruhn:for his help with the A5105 and KC compact emulation
• Stephan Linz:for his help with the PC/M emulation, the provision offloppy disk images and the PC/M system software and hishomepagewww.li-pro.net
• Thomas Scherrer:for his Z80 web sidewww.z80.info
• Torsten Paul:for his emulatorKCemu (http://kcemu.sourceforge.net/)and for the provision of informations and ROM imagesof various computers
• Ulrich Zander:for his homepagewww.sax.deand his support with the A5105, KC85/1, KC87,and Z9001 emulation
• Volker Pohlers:for his homepagehc-ddr.hucki.netand his versatile support and inspirations
• to everyone who found and reported bugs
• to the many active members in theRobotrontechnik-Forum