2016-12-10 04:10:25 +00:00
|
|
|
# Apple II Audit
|
2016-09-13 02:06:45 +00:00
|
|
|
|
2017-01-24 18:06:20 +00:00
|
|
|
This repository contains routines to audit Apple II computers (II,
|
|
|
|
|
II+, IIe, IIc), providing information about hardware, ROM versions,
|
|
|
|
|
RAM configuration, and behavior.
|
2016-09-13 02:06:45 +00:00
|
|
|
|
2017-02-20 01:55:26 +00:00
|
|
|
The file to download and try is
|
|
|
|
|
[audit/audit.dsk](https://github.com/zellyn/a2audit/blob/master/audit/audit.dsk).
|
|
|
|
|
|
2017-03-18 02:15:20 +00:00
|
|
|
|
|
|
|
|
|
2017-01-24 18:06:20 +00:00
|
|
|
Eventually, it should comprise a complete emulator test suite,
|
|
|
|
|
enabling emulator writers to systematically identify and eliminate
|
|
|
|
|
software-testable differences from real hardware. If a difference
|
|
|
|
|
visible to code can be found, a test should be added to this suite.
|
|
|
|
|
|
|
|
|
|
# Error messages
|
|
|
|
|
|
|
|
|
|
Error messages can be viewed at
|
|
|
|
|
[zellyn.com/a2audit/a2audit/v0](http://zellyn.com/a2audit/v0/) or
|
|
|
|
|
[on github](https://github.com/zellyn/a2audit/blob/master/v0/index.md).
|
2016-09-13 02:06:45 +00:00
|
|
|
|
2016-12-10 04:10:25 +00:00
|
|
|
## Status
|
2016-09-13 02:06:45 +00:00
|
|
|
|
2017-01-24 18:06:20 +00:00
|
|
|
### Done
|
|
|
|
|
|
2017-01-25 05:29:15 +00:00
|
|
|
- [x] toolchain for automation ([diskii](https://github.com/zellyn/diskii))
|
2017-01-24 18:06:20 +00:00
|
|
|
- [x] sha1sum assembly code (currently not used yet because it's slow)
|
|
|
|
|
- [x] language card tests
|
|
|
|
|
- [x] main/auxiliary memory softswitch behavior tests
|
2017-01-25 05:28:19 +00:00
|
|
|
- [x] softswitch reading tests
|
2017-01-27 02:46:38 +00:00
|
|
|
- [x] Incorporate Cxxx testing into data-driven test
|
|
|
|
|
- [x] Add testcases for Cxxx testing
|
2017-02-03 03:33:53 +00:00
|
|
|
- [x] duplicate HOME and COUT routines from AppleII, so IIe tests
|
|
|
|
|
don't depend on Cxxx ROM working
|
2017-02-20 01:55:26 +00:00
|
|
|
- [x] Some simple "same result from two different modes" graphics tests
|
2016-09-13 02:06:45 +00:00
|
|
|
|
2017-01-24 18:06:20 +00:00
|
|
|
### TODO
|
|
|
|
|
|
2017-02-03 03:33:53 +00:00
|
|
|
- [ ] IIe: check that we really have 128K (aux switching actually does
|
|
|
|
|
anything)
|
|
|
|
|
- [ ] IIe: don't test auxmem softswitches if we only have 64k
|
2017-01-25 05:28:19 +00:00
|
|
|
- [ ] weirder softswitch behavior corner cases
|
2017-01-24 18:06:20 +00:00
|
|
|
- [ ] floating-bus tests
|
2017-02-20 01:55:26 +00:00
|
|
|
- [ ] dbl lores tests
|
|
|
|
|
- [ ] weird lores tests
|
|
|
|
|
- [ ] undelayed hires tests
|
2017-01-24 18:06:20 +00:00
|
|
|
|
|
|
|
|
## Raison d'être
|
2016-09-13 02:06:45 +00:00
|
|
|
|
|
|
|
|
This test suite is a step on the way to implementing Apple IIe
|
2016-12-10 04:10:25 +00:00
|
|
|
(enhanced) support in
|
|
|
|
|
[OpenEmulator](http://openemulatorproject.github.io/): I may alternate
|
|
|
|
|
adding tests here and features there.
|
2017-02-25 02:17:08 +00:00
|
|
|
|
2022-03-08 19:20:36 +00:00
|
|
|
## See also
|
|
|
|
|
|
|
|
|
|
- Tom Charlesworth's [mb-audit](https://github.com/tomcw/mb-audit), a similar tests for MockingBoard sound cards.
|
|
|
|
|
|
2017-02-25 02:17:08 +00:00
|
|
|
## Contributors
|
|
|
|
|
|
|
|
|
|
- [Zellyn Hunter](https://github.com/zellyn)
|
|
|
|
|
- [Peter Ferrie ("qkumba")](https://github.com/peterferrie)
|
2020-09-21 18:14:40 +00:00
|
|
|
- [Cedric Beust](https://github.com/cbeust)
|
|
|
|
|
|
