Update README.md

This commit is contained in:
Joshua Bell 2017-12-03 14:39:39 -08:00 committed by GitHub
parent b53a9ca897
commit 8e599eaed6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 7 deletions

View File

@ -1,4 +1,4 @@
# The Cricket - ProDOS Clock Driver
# 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.
@ -6,9 +6,9 @@ I acquired a Cricket sound/clock peripheral on eBay. Therefore it is now critica
## 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 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 included disks include:
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
@ -18,11 +18,11 @@ The included disks include:
Like the `NS.CLOCK.SYSTEM` (by "CAP") ideally we would have:
* [x] A ProDOS `.SYSTEM` file
* [X] Detects the presence of a Cricket
* [x] Detects the presence of a Cricket
* [x] Installs a driver in memory following the ProDOS clock driver protocol
* [x] Chains to the next `.SYSTEM` file (e.g. `BASIC.SYSTEM`)
Successfully tested on real hardware. (Laser 128EX, including at 3x speed.)
Successfully tested on real hardware. (Laser 128EX, an Apple //c clone — including at 3x speed!)
## Build
@ -32,13 +32,12 @@ Requires [cc65](https://github.com/cc65/cc65). The included `Makefile` is very s
## Notes
I ended up disassembling both [NS.CLOCK.SYSTEM](ns.clock.system.s) (to understand the SYSTEM chaining - what a pain!) and The Cricket's [PRODOS.MOD](prodos.mod.s) and melding them together, adding in the detection routine following the protocol in the manual.
I ended up disassembling both [NS.CLOCK.SYSTEM](ns.clock.system.s) (to understand the SYSTEM chaining - what a pain!) and The Cricket!'s [PRODOS.MOD](prodos.mod.s) and melding them together, adding in the detection routine following the protocol in the manual.
Other files:
* [GET.TIME](get.time.s) just prints the current ProDOS date/time, to verify the time is set and updating.
* [TEST](test.s) attempts to identify an SSC in Slot 2 and the Cricket via the ID sequence, to test routines.
## Resources
Cricket disks on Asimov: