|ee5fbeda2d||4 weeks ago|
|.github/workflows||4 weeks ago|
|clocks||2 months ago|
|inc||2 months ago|
|ram.drv||2 months ago|
|selectors||7 months ago|
|textcolors||1 year ago|
|util||1 year ago|
|.gitignore||4 years ago|
|Makefile||4 months ago|
|README.md||4 months ago|
|package.sh||4 months ago|
Build with ca65
What are ProDOS "drivers"?
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 (
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.
What is present here?
This repo includes the following drivers/modifications:
- Real-time Clock drivers
- No-Slot Clock
- Applied Engineering DClock
- ROMX Real-Time Clock
- FujiNet Clock
- A "jumbo" driver that includes all of the above (just called
- RAM Disk drivers
- RAMWorks Driver by Glen E. Bredon
- Quit dispatcher/selector (
- 40-column Selector (from ProDOS)
- 80-column menu-driven Selector (from ProDOS 1.9 and 2.x)
- Bird's Better Bye (a 40-column menu-driven selector)
- Buh-Bye (an enhanced version of the ProDOS 80-column, menu-driven selector)
- Text color themes
- These set the IIgs (or VidHD) text/background/border colors
QUIT.SYSTEM is present which isn't a driver but which immediately invokes the QUIT handler (a.k.a. program selector). This will happen automatically if the last driver can't find another
.SYSTEM file, but
QUIT.SYSTEM can be used to stop the chain.
PAUSE.SYSTEM which just waits for a fraction of a second before invoking the next driver file. (Why? In case the log messages from the other installers goes by too fast!)
Non-drivers that are included:
DATEbinary file can be
-DATE) to show the current ProDOS Date/Time, to verify that the clock driver is working.
- Some utilities for The Cricket! clock are also included.
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. A boot disk image catalog that is used on multiple different hardware configurations might include:
PRODOS- the operating system, e.g. ProDOS 2.4
NS.CLOCK.SYSTEM- install No-Slot clock driver, if present
ROMXRTC.SYSTEM- install ROMX clock driver, if present
FN.CLOCK.SYSTEM- install FujiNet clock driver, if present
DCLOCK.SYSTEM- install DClock 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
PAUSE.SYSTEM- pause for a moment, so that you can inspect the output of the above
QUIT.SYSTEM- invoke the Quit handler immediately, as a program selector
BASIC.SYSTEM- which will not be automatically invoked, but is available to manually invoke
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