This project brings CP/M Plus (or CP/M Version 3.0) to the Research Machines 480Z computer, which was originally supplied with CP/M 2.2. I have written both banked and non banked versions of the BIOS from scratch in Z80 assembly language, which when linked with the original Digital Research BDOS produces a working OS. The banked version requires additional memory (at least 96K), but provides more memory for resident programs (53K rather than 47K) and includes additional operating system features such as password protection for files and more helpful error messages.
The project is still at an early beta release stage, but basic functionality has been successfully tested under emulation using the unreleased 480Z MAME driver that I have also written (mamedev/mame#12576).
- The 480Z floppy disc format reserves 3 tracks for the operating system and these are used as follows:
- Track 0 contains my cold boot loader which is responsible for running the actual CP/M loader.
- Track 1 contains the CP/M loader written by Digital Research (linked against a cut down version of my nonbanked BIOS) which is responsible for loading CPM3.SYS and starting the OS.
- Track 2 contains CCP.COM (the Console Command Processor) written by Digital Research, which is loaded by my BIOS in the cold boot routine.
- The CCP is initially loaded from disc and then copied to an area of RAM normally hidden by ROM (at 0xE800), so that it can quickly be restored during a warm boot (which occurs whenever a program returns to CP/M). To access this area the memory layout is switched to all RAM (Page 3) after first disabling interrupts.
- In the banked bios the lower 32K address space is banked and the upper 32K is common.
- BANK0 is the system bank only accessible by the BDOS and BIOS. This is stored in expansion ram (using two 16K blocks - blocks 4 and 5).
- BANK1 is the TPA bank that running programs see. This is stored in normal RAM (blocks 1 and 2).
- When the BIOS needs to call Firmware routines BANK1 is selected and interrupts are enabled as the Firmware expects this layout.
- Whenever BANK0 is active interrupts are disabled to prevent the Firmware interfering with the memory layout.
- A buffer in common memory is used whenever data needs to be transferred between banks.
All code is assembled and linked using original CP/M tools available in 1983!
- The Research Machine's assembler (
zasm.com) is used to produce .REL (relocatable object) and .COM (executable) files from Z80 assembler source. - The Digital Research linker (
link.com) is used to produce .SPR (System Page Relocatable) object files from .REL files. - Finally GENCCPM (
gencpm.com) is used to combine the BDOS and BIOS .SPR files into CPM3.SYS, thus generating the operating system.
To speed up the development process these tools are executed under Linux using the tnylpo command line CP/M emulator.
The following third party (Digital Research) CP/M binary files are required:
- ccp.com
- cpmldr.rel
- bdos3.spr
- bnkbdos3.spr
- resbdos3.spr
As CP/M is now open source these can be freely obtained (http://www.cpm.z80.de/binary.html).
My .zsm source files are prefixed with an underscore to indicate that they are in UNIX text file format. To be understood by CP/M tools they must be converted to CP/M text file format, which can be done using tnylpo-convert.
Make can be used to build everything under Linux (using the above mentioned tools).
Use make banked or make nonbanked to produce the desired GENCPM config file. After this settings that effect the generation of CPM3.SYS can be tweaked further by running GENCPM manually to override the defaults I have chosen.
Use make all to generate all the required target files and make install to copy these to a disc image file named test.imd (this blank IMD disc image must already exist).
On the 480Z run install.com under CP/M 2.2 to write the system tracks and reboot to start CP/M Plus!
The original system guide explains how to construct a new BIOS and produce the OS, and this is what I followed:
Details about the 480Z and it's firmware are given by these documents: