Apple-2-SW/prodos-drivers
1
0
Fork 0
mirror of https://github.com/a2stuff/prodos-drivers.git synced 2024-06-14 19:29:31 +00:00
Code Issues Projects Releases Wiki Activity
ed2fa6e7d2
prodos-drivers/clocks
History
Joshua Bell ed2fa6e7d2 No-Slot Clock: Hit PTRIG to slow ZIP/IIc+ accelerator before reading 
This appears to improve reliability when reading the NSC on the
IIc+. More data is probably needed before declaring this a really
good solution, but "it works on my machine!"
2023-10-06 22:11:36 -07:00
..
cricket Cricket: Make SET.TIME/SET.DATETIME time inputs 24-hour by default 2023-07-17 08:11:50 -07:00
dclock Add build options to suppress success and/or failure logging 2023-05-01 19:47:10 -07:00
fujinet Add build options to suppress success and/or failure logging 2023-05-01 19:47:10 -07:00
jumbo Add build options to suppress success and/or failure logging 2023-05-01 19:47:10 -07:00
ns.clock No-Slot Clock: Hit PTRIG to slow ZIP/IIc+ accelerator before reading 2023-10-06 22:11:36 -07:00
romx Add build options to suppress success and/or failure logging 2023-05-01 19:47:10 -07:00
Makefile Add build options to suppress success and/or failure logging 2023-05-01 19:47:10 -07:00
README.md Add "jumbo" clock driver, an amalgamation of the others 2022-11-26 20:29:38 -08:00

README.md

ProDOS Clock Drivers

Other than the Apple IIgs model, the Apple II did not ship with a real-time system clock. Many third party Apple II system clocks were produced in the 1980s, and many new system clocks are available, either as entirely new designs or recreations.

The ProDOS operating system for the Apple II personal computer line natively supports the Thunderclock real-time clock card, but there is a protocol for custom clock drivers to be installed:

  • Check MACHID bit 0 to see if a clock is already active; abort if so.
  • Optional: Probe hardware to determine if the clock is present; abort if not.
  • Relocate the clock driver to LC bank 1, at the address at DATETIME+1
  • Update DATETIME to be a JMP instruction.
  • Optional: Chain to the next .SYSTEM file.

In addition:

  • The clock driver must fit into 125 bytes.
  • The driver may dirty $200-$207 but other memory must be restored if modified.
  • When invoked, the clock driver should read the clock hardware and encode the date and time into DATELO/DATEHI and TIMELO/TIMEHI.
  • ProDOS calls the clock driver when GET_TIME is called, and on every call (CREATE, RENAME, etc) that might need the date and time.

See https://prodos8.com/docs/techref/adding-routines-to-prodos/ for more information.

Included drivers

This directory includes drivers for the following real-time clocks:

All follow the above protocol: install only if there is not already a clock, probe for the clock before installing, and chain to the next driver.

In addition, the "jumbo" directory combines the other driver installers to create a single unified clock driver installer. See its README for more details.