Apple-2-SW/prodos-drivers
1
0
Fork 0
mirror of https://github.com/a2stuff/prodos-drivers.git synced 2024-06-17 23:29:28 +00:00
Code Issues Projects Releases Wiki Activity

Update README.md

Browse Source
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
README.md
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. 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 ## 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. * `/CRICKET/PRODOS.MOD` which can be BRUN to patch ProDOS in memory with a clock driver.
* A modified version of ProDOS * A modified version of ProDOS
* A utility to patch ProDOS on disk * 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: Like the `NS.CLOCK.SYSTEM` (by "CAP") ideally we would have:
* [x] A ProDOS `.SYSTEM` file * [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] Installs a driver in memory following the ProDOS clock driver protocol
* [x] Chains to the next `.SYSTEM` file (e.g. `BASIC.SYSTEM`) * [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 ## Build
@ -32,13 +32,12 @@ Requires [cc65](https://github.com/cc65/cc65). The included `Makefile` is very s
## Notes ## 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: Other files:
* [GET.TIME](get.time.s) just prints the current ProDOS date/time, to verify the time is set and updating. * [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. * [TEST](test.s) attempts to identify an SSC in Slot 2 and the Cricket via the ID sequence, to test routines.
## Resources ## Resources
Cricket disks on Asimov: Cricket disks on Asimov: