The Osborne 1 Compendium
A complete reference, assembled from the project's own research
Nobody should have to reverse-engineer an Osborne 1 twice. This book is the project’s attempt to write down everything we have worked out about the machine — the ROM, the schematics, the memory and I/O map, every peripheral protocol, the third-party upgrade boards and the disk library — in one place, with the evidence attached and the unknowns named.
It is assembled, not written: each chapter is one of the project’s working
documents in docs/, and the repository stays the single source of truth. If you
want to check a claim, follow it back to the source file — every chapter names
its source, and the cross-references link straight to it on GitHub.
Contents
- I · The machine
- Overview and history — not yet written
- Mainboard and the schematic set
- Memory and I/O map
- ROM and firmware
- ROM variants and third-party ROMs
- ROM 1.3: the source disk, and what is left — partially solved
- Reading the monitor ROM off a real machine — reference
- OZROM 1E: a third-party monitor ROM
- ROM 2.0: CP/M resident in the ROM — partially solved
- Video and the character generator — partially solved
- II · Interfaces
- The floppy subsystem and its formats
- The floppy adapter design — design
- Serial and the modem
- The IEEE-488 port
- Keyboard and printer — not yet written
- III · Peripherals and storage
- Drive C: the IEEE-488 RAM disk
- The Drive C reproduction: hw + firmware — design
- The Drive C's Executive variant
- The hard-disk products
- The hard-disk decision: the ACB-4000 — decided
- The RT-60A real-time clock — partially solved
- CoPower-88: the host protocol — partially solved
- CoPower-88: the schematics
- 80-column boards: SCREEN-PAC to TRA — partially solved
- IV · Software
- The software library — not yet written
- Boot disks — not yet written
- V · The project
- Emulation and testing
- The interposer and its virtual peripherals — design
- Prior art: Z80 bus interposers — partially solved
- Open questions — living document
- VI · Appendices
- Archive provenance — living document
- The machines: a photographic survey — reference
- The Portable Companion extract index — not yet written
Download
Download the PDF — the whole book in one file, rendered with pandoc from the same sources.
How it is put together
book/manifest.txtis the table of contents — one line per chapter, naming its source document and its status. Editing the manifest changes the book.tools/build_book.pyreads the manifest and generates this page’s table of contents, the chapter pages, and the PDF. It never writes intodocs/.- Nothing is duplicated. A chapter is a view of a working document, so a
correction made in
docs/shows up here on the next build rather than drifting.
That structure is deliberate: a book that copies its sources is a book that goes quietly out of date.
What is missing
Three kinds of gap, all visible in the contents above rather than hidden:
- Chapters with no source yet — the overview, the keyboard and printer chapter, the software library, boot disks, and the Portable Companion extract index. These are book-only writing, and they are marked.
- Chapters that are partial — Drive C’s command set, the hard-disk controller comparison, the RT-60A contract. The chapter says what is unknown and which issue closes it.
- Diagrams — the working documents use Mermaid, which pandoc does not render without extra tooling. In the PDF they appear as code blocks; in the HTML they render properly.