Apple-2-SW/prodos-drivers
1
0
Fork 0
mirror of https://github.com/a2stuff/prodos-drivers.git synced 2024-12-21 14:29:18 +00:00
Code Issues Projects Releases Wiki Activity
Apple II ProDOS-8 system files that run on startup and install clock drivers, ramdisks, and other utilities
33 Commits 1 Branch 9 Tags 574 KiB
Assembly 84.8%
Makefile 5.9%
PHP 5.6%
C++ 1.4%
HTML 1.3%
Other 1%
b204ea7f2f
Go to file
Joshua Bell b204ea7f2f Rename GET.TIME to DATE, single line
2017-12-07 20:49:53 -08:00
release disk image 2017-12-03 17:29:11 -08:00
.gitignore Add separate sys source; resolves #1, #2 2017-11-24 23:12:12 -08:00
common.inc Add set.date/set.time helpers for Cricket 2017-12-07 19:54:55 -08:00
cricket.system.s Increase read delay. Resolves #4 2017-12-02 21:35:50 -08:00
date.s Rename GET.TIME to DATE, single line 2017-12-07 20:49:53 -08:00
Makefile Rename GET.TIME to DATE, single line 2017-12-07 20:49:53 -08:00
ns.clock.system.s Increase read delay. Resolves #4 2017-12-02 21:35:50 -08:00
prodos.mod.s Document SSC command register usage 2017-12-02 09:56:13 -08:00
README.md Update README.md 2017-12-03 14:39:39 -08:00
set.date.s Add set.date/set.time helpers for Cricket 2017-12-07 19:54:55 -08:00
set.time.s Add set.date/set.time helpers for Cricket 2017-12-07 19:54:55 -08:00
test.s Increase read delay. Resolves #4 2017-12-02 21:35:50 -08:00

README.md

The Cricket! - ProDOS Clock Driver

I acquired a Cricket sound/clock peripheral on eBay. Therefore it is now critical that we have a conforming ProDOS clock driver for it.

STATUS: Works on my machine!

Background

"The Cricket!" by Street Electronics Corporation, released in 1984, is a hardware peripheral for the Apple //c computer. It plugs into the serial port and offers a multi-voice sound synthesizer, a speech synthesizer, and a real-time clock.

The disks supplied with the device include:

  • /CRICKET/PRODOS.MOD which can be BRUN to patch ProDOS in memory with a clock driver.
  • A modified version of ProDOS
  • A utility to patch ProDOS on disk

Goals

Like the NS.CLOCK.SYSTEM (by "CAP") ideally we would have:

  • A ProDOS .SYSTEM file
  • Detects the presence of a Cricket
  • Installs a driver in memory following the ProDOS clock driver protocol
  • Chains to the next .SYSTEM file (e.g. BASIC.SYSTEM)

Successfully tested on real hardware. (Laser 128EX, an Apple //c clone — including at 3x speed!)

Build

Requires cc65. The included Makefile is very specific to my machine - sorry about that.

CRICKET.SYSTEM is the result of the build.

Notes

I ended up disassembling both NS.CLOCK.SYSTEM (to understand the SYSTEM chaining - what a pain!) and The Cricket!'s PRODOS.MOD and melding them together, adding in the detection routine following the protocol in the manual.

Other files:

  • GET.TIME just prints the current ProDOS date/time, to verify the time is set and updating.
  • TEST attempts to identify an SSC in Slot 2 and the Cricket via the ID sequence, to test routines.

Resources

Cricket disks on Asimov:

  • ftp://ftp.apple.asimov.net/pub/apple_II/images/hardware/sound/cricket_disk1.po
  • ftp://ftp.apple.asimov.net/pub/apple_II/images/hardware/sound/cricket_disk2.po

Cricket Manual on Asimov:

  • ftp://ftp.apple.asimov.net/pub/apple_II/documentation/hardware/sound/Street%20Electronics%20The%20Cricket.pdf