Skip to content

Latest commit

 

History

History
200 lines (149 loc) · 8.33 KB

README.md

File metadata and controls

200 lines (149 loc) · 8.33 KB
Raw

CP/Mish

What?

CP/Mish is an open source CP/M distribution for the 8080 and Z80 architectures.

It contains a collection of software, some from Digital Research and some not, all with proper open source licenses, integrated into a build system which lets you build everything into proper disk images at a moment's notice.

What you get is a working CP/M 2.2 clone consisting of:

  • ZSDOS as the BDOS
  • ZCPR1 as the CCP
  • open source BIOSes for the supported platforms
  • various Digital Research programs from the original CP/M (I'm slowly importing them and integrating them into the build system)
  • various tools copying the functionality of the standard CP/M tools (some of them written by me
  • R.T. Russell's superb BBC Basic, Z80 edition (with integrated assembler)
  • Richard Surwilo's Z8E full-screen symbolic debugger
  • B. J. Rodriguez's CamelForth
  • a build system which provides a turnkey cross-compilation system for producing bootable disk images for any of the supported platforms
  • a classic CP/M syntax assembler and linker for cross-compiling ancient source
  • a simple but useful vi-adjacent editor called qe (written by myself)
  • an emulator for testing CP/M binaries
  • source for everything; no binaries are in this distribution
  • other things which I may well have forgotten to document
  • bugs

Currently it supports these platforms:

(Some of these are pretty stale due to difficulty of testing and may not work. Later entries are newer! If you have any problems, please report bugs.)

If anyone wants to contribute any more BIOSes, I'd love pull requests!

Why?

CP/M is Digital Research's seminal desktop operating system from 1977 that for a decade dominated the personal computer market. It's of enormous historical value and there's a vast wealth of programs written for it. It's even useful today: both to study (as aa superb example of sheer minimalism) but also to use; the Z80 is a common target for homebrew computers, and CP/M is the obvious operating system to run on one.

Don't believe me? Watch this:

Video of me doing stuff on an NC200

The source and binaries have long been available via the (the amazing) Unofficial CP/M Web Site, but the license had a bug in it which meant they couldn't be distributed anywhere else; this was recently fixed so it's now properly open source.

How?

From binaries: precompiled disk images are available as part of the current development release. This are built automatically and aren't tested in any way.

From source: you pretty much need a Unix --- I developed it on Linux. You'll need to install the dependencies. These are the names of the Debian packages:

  • cpmtools
  • libz80ex-dev
  • libreadline-dev

You also need to install the Amsterdam Compiler Kit, which is used as the C compiler (yes, some of the tools are written in C). You'll have to install it from source yourself as it's not in Debian.

Once in place, just do:

make

...and it should build. You'll end up with some .img files in the project directory which are the bootable disk images.

If you want more detailed build instructions, try the script used for automatic builds, which has got the exact commands needed buried inside it. This also has the instructions for OSX.

For information on what to do with these, look in the READMEs in the individual arch/* directories.

Where?

Who?

There's a lot of stuff here, and while I assembled it, I didn't write all of it. See the licensing section below for the full list.

For the distribution work and the bits I did write --- I am David Given. Feel free to send me email at [email protected]. You may also like to visit my website; there may or may not be something interesting there.

License?

This is a big aggregation of software, all with its own licensing. It contains GPLv2-licensed code, so as a whole it must be distributed under the terms of the GPL version 2 (because complying with the GPL also complies with the license of everything else). See the COPYING.gpl2 file for more details.

Specifically:

  • Everything not in arch or third_party is © 2018-2019 David Given and is distributable under the terms of the 2-clause BSD license. See the COPYING.cpmish file for more details.

  • arch/nc200 and arch/kayproii were written by me and are covered by the main CP/Mish license.

  • third_party/bbcbasic contains a copy of R.T.Russell's Z80 BBC Basic, which is distributable under the terms of the zlib license. See the third_party/bbcbasic/COPYING file for more details.

  • third_party/libstb contains a copy of Sean Barrett's stb library, which is partially in the public domain and partially distributable under the Expat license. See the third_party/libstb/COPYING file for more details.

  • third_party/zcpr1 contains a (modified) copy of the ZCPR1 CCP replacement, written by the CCP-GROUP, which is in the public domain. See the third_party/zcpr1/COPYING file for more details.

  • third_party/zmac contains a (modified) copy of the ZMAC macro assembler, written by George Phillips, Thierry Join, Mark Rison, Russell Marks, Colin Kelley, John Providenza and Bruce Norskog (some time in 1978!) --- and probably others. To the best of my knowledge this is in the public domain. See the third_party/zmac/COPYING file for more details.

  • third_party/ld80 contains a (modified) copy of the LD80 macro assembler, written by (as far as I know) George Philips and Gabor Kiss. It is in the public domain.

  • third_party/zsdos contains a (modified) copy of the ZSDOS CP/M BDOS clone, written by lots of people but mainly Cameron W. Cotrill and Harold F. Bower. This is available under the terms of the General Public License version 2. See the third_party/zsdos/COPYING file for more details.

  • third_party/z8e contains a (modified) copy of the Z8E symbolic debugger, mostly written by Richard Surwilo and Jon Saxton. It is in the public domain.

  • third_party/libz80ex contains a copy of the libz80ex Z80 emulation library, mostly written by Pigmaker57. It is distributable under the terms of the General Public license version 2. See the third_party/libz80ex/COPYING file for the full text.

  • third_party/camelforth contains a copy of CamelForth for the Z80, written by B. J. Rodriguez. It is distributable under the terms of the General Public License version 3. See third_party/camelforth/COPYING for the full text.

  • third_party/dr contains a variety of software, all by Digital Research. It is distributable under a rather complicated license which kind of accreted over the years but is mostly a do-what-thou-wilt license equivalent to 2-clause BSD. See third_party/dr/COPYING.md for more information.