a2audit/README.md

47 lines
1.5 KiB
Markdown
Raw Normal View History

# 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-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
## 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
- [x] duplicate HOME and COUT routines from AppleII, so IIe tests
don't depend on Cxxx ROM working
2016-09-13 02:06:45 +00:00
2017-01-24 18:06:20 +00:00
### TODO
- [ ] 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
## Raison d'être
2016-09-13 02:06:45 +00:00
This test suite is a step on the way to implementing Apple IIe
(enhanced) support in
[OpenEmulator](http://openemulatorproject.github.io/): I may alternate
adding tests here and features there.
2017-01-24 18:06:20 +00:00