+-----------------+
| CP/M 3.1 README |
+-----------------+

ORIGIN

The files on this set of disk images were obtained from the archive
apl2cpm3.zip which can be found here: http://cpm.z80.de/download/apl2cpm3.zip

I also borrowed some files from the YAZE CP/M 3 distribution (to replace some
German language programs with English language versions.)

HARDWARE REQUIREMENTS

The system runs on an Apple ][, ][+ or /e with Microsoft Z80 Softcard (or
compatible), with 80 column card.  Only disk ][ floppy drives are supported -
there is no support for 3.5" drives.  It has been tested on an Apple //e
Enhanced with extended 80 column card.

The system is not very flexible with regard to hardware configuration.  It
requires a 64K Apple II (either a Language Card in slot 0 or a //e, //c).  The
Z80 card must be in slot 4, and the Disk ][ controller in slot 6.

The CP/M TPA is 46K.  This version of CP/M 3 does not support banked memory.

PATCH

I have patched CPM3.SYS so that it no longer reinitializes the 80 column card on
every warm boot.  This fixes the issue where the screen clears after running any
transient command on Apple IIe.

The patch overwrites the instruction CALL DC21 at memory location 0xd9ab with
three NOP (00) instructions.  This prevent the warm start routine from calling
'icrt' which reinitializes the 80 column card.

HISTORY

The original disks contain a port of CP/M 3.1 to the Apple II which was done by
Werner K.G. Muenchheimer in Germany in 1989.  It consists of the generic CPM 3
distribution from Digital Research together with the system-specific files for
adapting it to the Apple II Softcard environment.  8080 macro assembler source
code is provided for the all the system-specific parts. The system appears to
support MFM hard drives using a Western Digital 1002 controller, but I have no
way to test this.  Some parts seem to have been taken from CP/M 3 for the
Amstrad/Schneider CPC464 and 664.

The port to the Apple II works, but it is a little bit unpolished.

DISKETTES

Disk 1: Boot disk with almost all the standard CP/M 3 user utilities.  This
        disk is intended to be the day-to-day boot disk, and has everything
        needed to run the system as a user.
Disk 2: All of the development tools (assemblers, linker, debugger) are here.
        I also added Microsoft M80 (the version that can handle 8080 and 6502
        code) which is needed to build the source code.
Disk 3: Less frequently-used standard CP/M 3 utilities.
Disk 4: Help system and documents.  I replaced the German language help system
        with an English language version.  The file CPM3.DOC is the original
        German language release notes.

Disk 4 contains some random utilities that were found on the original
disk images.  Some of these were developed by Herr Muenchheimer, and others
are public domain.

HINTS AND TIPS

Before running any program that attempts to use advanced terminal features (such
as moving the cursor, or inverse video) such as Wordstar, be sure to run
EMULA.COM.

NEWMD.COM on disk 1 sets up a RAM disk M: using the banked memory of the
extended 80 column card.

The following utilities are all found on disk 3:

CACHE.COM is a Disk ][ caching program.

LINBUF.COM provides a simple command line history function.  Press ^W to recall
the previous command line.

PARK.COM is a head parking program (presumably for an MFM drive on a WD1002
controller.

PRO10.COM patches the running system to change the 6502 code that is used for
handing over between the Z80 and 6502.  The purpose of this program is currently
unclear to me, but it is probably debug code / an experiment.

Bobbi
September 29, 2019
bobbi.manners@gmail.com