Skip to content

About

A commodity patched kernel and distribution from source of CP/M-86 1.1 that makes it a bit more usable for retro computing

Topics

Resources

Stars

20 stars

Watchers

2 watching

Forks

Latest commit

 

History

252 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CP/M-86 Kernel and Base Tools

CP/M-86 1.1 kernel and commands for IBM PC/XT, emulators, V20 MBC and the AD8088 Card for Apple II. The project contains a full distribution of CP/M-86 1.1, patched, y2k compliant, enhanced and complete, for PC and PC XT built entirely from source.

It is build with cpm86-crossdev.

CP/M-86

Kernels

Kernel source sets

The PC kernel was recovered by disassembly. Maintained and experimental builds have separate baselines; they intentionally differ from the frozen reference.

Output CCP / BDOS / BIOS sources Purpose
cpm.sys ccp.a86, bdos.a86, pcbios.a86 Maintained PC kernel
cpmorg.sys ccporg.a86, bdosorg.a86, pcbioorg.a86 Frozen patched reference; do not edit
cpmexp.sys ccpexp.a86, bdosexp.a86, pcbioexp.a86 Experimental PC kernel
mbcv20.sys ccp.a86, bdos.a86, mbcv20.a86 V20 MBC, 8088 mode; segment 0040h; (source)
mbc816.sys ccp.a86, bdos.a86, mbc816.a86 V20 MBC, mixed 8080/8088 mode; segment 0040h; (source)
ad88.sys ccp.a86, bdos.a86, ad88bios.a86 AD8088 / Apple II; segment 4000h; (source)

Kernel patches

Patch history is in patching/; addresses and reserved-space use are in mapping.md. Fixed interfaces and external consumers are listed in api.md. Local edits are marked Ts:. Public entry points and existing system-data addresses are preserved.

DR patch Area Fix
01 Chain (MCHAIN) Stop at the terminating zero; store the command length correctly
06 Search (DRCOPY) Copy directory records to the user's DMA segment
07 Version (BDOSB) Clear BH on return
08 Load (MLOADP, MLOADK) Preserve the FCB offset and segment; prevent memory corruption
10 Dispatch (BDOSBC) Return FFFFh for invalid function numbers
11 Load (MLOADQ) Return FFFFh when absolute memory is denied
13 Internal calls (PATCH13) Preserve AFWFCB and FLOMOD during loads
15 Load (PATCH15) Honour absolute data-group bases

These patches are present in the frozen and maintained BDOS sets. The original PC/XT release lacks patch 15 and places patches 08, 10 and 11 at different addresses. Its free-memory patch at 0A3Ah is absent here.

Other change Effect
CCP DIRPAT Two-column DIR on screens narrower than 60 columns
CCP submit handling Use the current drive; prevent key presses from cancelling submit files
Reference IDs Align OEM, version and serial bytes with the recovered reference
Console abort Match the XT call order in CONSTA
User 0 system files Remove the erroneous S1 test in SRDRNZ; retain instruction offsets with NOPs
PC BIOS AT interrupt-vector fix, year-2000 fix and 80-column colour fallback
PC BIOS RTC date Standard and EXP read the initial date via INT 1Ah/AH=04h when supported. Stock XT or invalid replies retain the default; time initialization and fixed addresses are unchanged. See mapping.
PC BIOS Y2K leap-year patch Standard and EXP recognize year 00 as leap (2000); four-byte in-place fix preserves addresses. The existing four-year rule is not Gregorian century handling for 2100.
PC BIOS displayed century Display 00–79 as 2000–2079 and 80–99 as 1980–1999. Clock storage and tools are unchanged; all existing addresses are preserved.
Maintained PC hard disks Support partitions up to 31.5 MiB; see HDMAINT compatibility notes

Tool patches: 03 GENDEF, 04–05 ED, 09 PIP and 12 SUBMIT. Patches 02 (LDCOPY) and 14 (sample BIOS TRACK.A86) are outside this kernel.

Tools

Original/patched binaries live in base/; source builds live in commands/. Imported CCP/M commands are adapted for this kernel's BDOS 2.2 interface (BH=0).

Tool Binary (base/) Source (commands/)
asm86 Original CCP/M-86 3.1 port
assign Original Reconstructed CP/M-86 source
chkcpmfs — New shared PL/M-86 CP/M checker with confirmed metadata repair
config Original Reconstructed CP/M-86 source
dcomp — Compare 160/180/320/360K CP/M or FAT media
dcopy — Copy 160/180/320/360K CP/M or FAT media
ddt86 Original CCP/M-86 3.1 port
dform — Command-line formatter using DSKMAINT's boot sector and loader
dskmaint Updated 1.0→1.2 Reconstructed CP/M-86 source
ed DR-patched CCP/M-86 3.1 port
function Original Reconstructed CP/M-86 source
gencmd Original CCP/M-86 3.1 port
gendef DR-patched Adapted from MP/M-86 PL/M sources; CP/M final-record fix; output checked against original
hdmaint Updated 1.0→1.2N Shared maintained formatter; optional MBR preservation
help Original CCP/M-86 3.1 port
help.hlp Original Rebuilt for every core distribution; includes new tools too
mform Original Reconstructed CP/M-86 source
pip DR-patched CCP/M-86 3.1 port
print Original Labelled assembly reconstruction; maintained and frozen builds match the original exactly
setup Updated 1.0→1.2 Reconstructed CP/M-86 source
stat Original Adapted from CP/M-80 2.2
submit DR-patched Adapted from CP/M-80 2.2
tod — (superseded) New, CP/M-86 rewrite
atinit Imported from cpm86-hacking —
asm80 — Adapted from CP/M-80 2.2 and translated using XLT86
hexcom — HEXCOM 3.00-compatible C from tpzasm

MSUB provides a configurable menu-based and reentrant replacement for SUBMIT.

DCOPY/DCOMP derive from the PC DOS 1.10 disassemblies. They detect geometry and accept [8] / [9] overrides. See disk tools.

Mixed 8080/8086 support

asm80 (DR CP/M-80 assembler translated with XLT86) and hexcom (ANSI C HEXCOM 3.00 reimplementation) provide a native 8080 development chain. For emulation, see Z80 and VCPM in cpm86-ports.

Extended hard-disk sizes

The maintained PC kernels and HDMAINT support new native CP/M partitions beyond the original 8 MiB limit.

Feature Support
Volume size Variable, including 20 and 30 MiB; up to 31.5 MiB allocation space, less metadata
Sizing Whole cylinders; actual capacity depends on geometry
Requirements Updated kernel and HDMAINT; newly created partition, no in-place migration
Interchange Allocation layout compatible with maintained CCP/M-86 and CDOS 4.1; boot and controller compatibility depend on geometry

See HDMAINT for limits and format details.

HDMAINT's F8 selects replace (default) or preserve for the MBR bootstrap. It applies to creation, deletion and F4 boot-partition changes. To renew only the MBR, select replace, then F4 → F10 without cycling the active partition.

CP/M-86 emulator regressions use --personality pc (cpm.sys) or --personality experimental (cpmexp.sys):

make -C commands/hdmaint check
python3 tools/hdmaint_live_check.py --emulator pce --personality pc --layout dos-cpm
python3 tools/hdmaint_mbr_check.py --emulator qemu --personality pc --dos-source /path/to/ibm-dos33.img

Fixtures use 615/4/17 geometry and 640 KiB RAM (the hard-disk loader uses 3000:0000). Repeat with the other emulator/personality. The MBR test exercises both policies, F4 renewal/switching, cancelled/confirmed deletion and DOS/CP/M hard-disk boots. The shared HDMAINT notes describe the corresponding CCP/M harness; this project's scripts use CP/M media and kernels. Fixtures stay in ignored local/hdmaint-tests/; successful runs remove images and retain diagnostics. Manual --prepare-only fixtures are retained until removed after inspection.

1.44 MB Feature

Freek Heite's "1.44 MB Feature" adds 720K, 1.2M and 1.44M diskette support. Built from source by make -C extra using MASM 5.10 and LINK 5.13 under DOS emulation. The rebuilt 144pat2.cmd is byte-identical to the binary originally shipped here.

Output Role
144bldr2.cmd Secondary loader; patches the kernel in memory at boot
144pat2.cmd Applies the same patches to an already-running system
144prep2.cmd Prepares a diskette (boot sector + loader appended)

Development toolchains

Included in dev/.

Tool Product Version Vendor
rasm86.cmd RASM-86 Relocating Assembler 1.2 Digital Research
link86.cmd LINK86 Linkage Editor 2.02 Digital Research
lib86.cmd LIB-86 Library Manager 1.3 Digital Research
xref86.cmd XREF-86 Cross Reference 1.1 Digital Research
sid86.cmd SID-86 with 286 Disassembler 2.4 Digital Research
cbas86.cmd CBAS86 CBASIC Compiler 1.4 Digital Research
crun86.cmd CRUN86 CBASIC Runtime 1.4 Digital Research
pbasic.cmd Personal BASIC 1.2N (Supports command line) Digital Research
mbasic86.cmd BASIC-86 (Imported from cpm86-msbasic) Rev. 5.50 Microsoft

Disk images

Images use source-built tools. Experimental images boot cpmexp.sys; other bootable images use cpm.sys.

320K double-sided

Image Contents
cpm86-320.img Bootable core + assembler tools + DCOPY/DCOMP/DFORM
cpm86-320-at.img Same commands, AT-compatible clock
cpm86-320-dev.img Digital Research dev tools + BASIC development
cpm86-chkcpmfs.img Bootable CP/M-86 checker disk with PIP, STAT and CHKCPMFS

720K / 1.44M with 144FEAT

Image Contents
cpm86-720-at.img Full command set including DCOPY/DCOMP/DFORM + dev toolchain, AT-compatible clock
cpm86-1440-at.img Same content on 1.44M media

Experimental

Image Contents
cpm86-exp-720-at.img cpmexp.sys + full reconstruction + dev toolchain
cpm86-exp-1440-at.img Same content on 1.44M media
Image constraint Detail

PCE launchers: ./cpm86-320, ./cpm86-720, ./cpm86-1440, ./cpm86-exp, ./cpm86-exp-720, ./cpm86-exp-1440. Shortcuts: make test, make test-320, make test-exp.

cpmtools formats

Use cpmtools 2.23 with libdsk, available through Homebrew. Run it from the repository root to use ./diskdefs; local definitions replace the system file.

All formats use os 2.2. Using os 3 adds an unwanted CP/M Plus label to the directory.

Format Geometry Block Dir Reserved
ibmpc-514ss 40 × 8 × 512 (160K SS) 1K 64 1 track
cpm86-320 80 × 8 × 512 (320K DS) 2K 64 1 track
cpm86-720feat 160 × 9 × 512 (720K) 2K 256 2 tracks
cpm86-144feat 160 × 18 × 512 (1.44M) 4K 256 2 tracks
cpm86-xt-hd 272 × 63 × 512 (8M partition) 4K 2048 16 tracks
Format note Detail
144FEAT DPBs are documented in extra/144tech.md
Hard disk The table describes one image. BIOS reads each drive's actual parameters from its DR partition label
320K Head 1 stores cylinders in reverse order. Use cpm86-320 with tools/cpm86twist.py; Makefile image targets handle this automatically. The stock cpmtools ibmpc-514ds definition corrupts these raw images

Playing with CP/M-86

Use PCE with cpmtools for testing, or try the 160K images in QEMU. Hardware option: V20 MBC (shop).

V20 MBC CP/M-86 Menu
V20 MBC hardware  ·  CP/M-86 running in PCE
BIOS Setup 1.2 Disk Maintenance 1.2
BIOS Setup 1.2  ·  Disk Maintenance 1.2


Companion projects

Project Description
cpm86-kernel CP/M-86 1.1 distribution rebuilt from patched and reconstituted sources
ccpm86-kernel CCP/M-86 3.1 distribution rebuilt from patched and reconstituted sources
cdos41-kernel Concurrent DOS 4.1 distribution rebuilt from patched and reconstituted sources
cpm86-crossdev Unix CP/M-86 cross development project (compilers, emulation and tools)
cpm86-hacking CP/M-86 miscellaneous tools and PCE emulator helpers
cpm86-cmdtools CP/M-86 .cmd file manipulation tools
cpm86-ports CP/M-86 application ports in C and assembler
cpm86-vi STevie vi port for CP/M-86 and PC-DOS
cpm86-msbasic A recreation of MSBASIC-86 for CP/M-86 and PC-DOS 1.1 from gwbasic sources
cpm86-menu A submit replacement and a menu system for submit orchestration for CP/M-86 1.1
cpm86-make A simple submit based make tool for CP/M-86
pcdos11-hacking PC-DOS 1.1 distribution, tools and notes

Pedigree

Primary source: http://www.cpm.z80.de

Resource URL
Baseline sources http://www.cpm.z80.de/download/cpm86src.zip
Dev tools baseline http://www.cpm.z80.de/download/cpmdev.zip
Patch annotations http://www.cpm.z80.de/download/cpm86ann.zip
Bug patches http://www.cpm.z80.de/download/cpm86bug.zip
144FEAT2 Freek Heite
hexcom https://github.com/johnsonjh/tpzasm

License

CP/M-derived material is covered by the CP/M license; other material uses the MIT license, unless specified otherwise in a subdirectory.

About

A commodity patched kernel and distribution from source of CP/M-86 1.1 that makes it a bit more usable for retro computing

Topics

Resources

Stars

20 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages