Apple II ProDOS-8 system files that run on startup and install clock drivers, ramdisks, and other utilities
Go to file
Joshua Bell cc49835c9f RAM.DRV.SYSTEM: Show block count. Resolves #2 2020-12-21 13:27:54 -08:00
bbb Add package script 2020-03-12 20:15:18 -07:00
cricket Add package script 2020-03-12 20:15:18 -07:00
inc RAM.DRV.SYSTEM: Show block count. Resolves #2 2020-12-21 13:27:54 -08:00
ns.clock Add package script 2020-03-12 20:15:18 -07:00
quit Add package script 2020-03-12 20:15:18 -07:00
ram.drv RAM.DRV.SYSTEM: Show block count. Resolves #2 2020-12-21 13:27:54 -08:00
selector Add SELECTOR.SYSTEM capturing the behavior of ProDOS 1.x. Fixes #5 2020-12-21 10:50:54 -08:00
.gitignore Combine preamble files, .gitignore, and split out ns.clock 2019-10-03 21:49:53 -07:00
.travis.yml Add Travis-CI config, add README 2019-10-03 21:36:01 -07:00
Makefile Add SELECTOR.SYSTEM capturing the behavior of ProDOS 1.x. Fixes #5 2020-12-21 10:50:54 -08:00
README.md Add SELECTOR.SYSTEM capturing the behavior of ProDOS 1.x. Fixes #5 2020-12-21 10:50:54 -08:00
package.sh Add SELECTOR.SYSTEM capturing the behavior of ProDOS 1.x. Fixes #5 2020-12-21 10:50:54 -08:00

README.md

ProDOS Drivers

Build Status

What are ProDOS drivers/modifications?

The ProDOS operating system for the Apple II executes the first .SYSTEM file found in the boot directory on startup. A common pattern is to have the boot directory contain several "driver" files that customize ProDOS by installing drivers for hardware or modify specific parts of the operating system. These include:

  • Real-time Clock drivers (e.g. No-Slot Clock, Cricket!, AE DClock, etc)
    • In ProDOS 1.x, 2.0 and 2.4 the Thunderclock driver is built-in.
  • RAM Disk drivers (e.g. RamWorks)
    • In ProDOS 1.x, 2.0 and 2.4 only a 64K driver for /RAM is built-in.
  • Quit dispatcher/selector (BYE routines)
    • In ProDOS 1.0 through 1.7 a simple selector prompting ENTER PREFIX (PRESS "RETURN" TO ACCEPT) asked for a path.
    • In ProDOS 1.9 and 2.0 Bird's Better Bye is built-in.
    • In ProDOS 2.4 Bitsy Bye is built-in.

Early versions of these drivers would often invoke a specific file on completion, sometimes user-configurable. The best versions of these drivers simply execute the following .SYSTEM file, although this is non-trivial code and often did not work with network drives.

This repository collects several drivers and uses common code to chain to the next .SYSTEM file, suporting network drives.

How do you use these?

The intent is that you use a tool like Copy II Plus or Apple II DeskTop to copy and arrange the SYSTEM files on your boot disk as you see fit. An example boot disk catalog might include:

  • PRODOS - the operating system, e.g. ProDOS 2.4
  • NS.CLOCK.SYSTEM - install No-Slot Clock driver, if present
  • CRICKET.SYSTEM - install Cricket! clock driver, if present
  • RAM.DRV.SYSTEM - install RamWorks RAM disk driver, if present
  • BUHBYE.SYSTEM - install a customized Quit handler to replace the built-in one
  • QUIT.SYSTEM - invoke the Quit handler immediately, as a program selector

Alternately, you might want to install some drivers then immediately launch into BASIC. In that case, put BASIC.SYSTEM after the drivers in place of QUIT.SYSTEM.