a2audit/README.md
2017-01-24 23:28:19 -06:00

1.3 KiB

Apple II Audit

This repository contains routines to audit Apple II computers (II, II+, IIe, IIc), providing information about hardware, ROM versions, RAM configuration, and behavior.

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 or on github.

Status

Done

  • toolchain for automation (diskii)
  • sha1sum assembly code (currently not used yet because it's slow)
  • language card tests
  • main/auxiliary memory softswitch behavior tests
  • softswitch reading tests

TODO

  • Incorporate Cxxx testing into data-driven test
  • Add testcases for Cxxx testing
  • weirder softswitch behavior corner cases
  • floating-bus tests

Raison d'être

This test suite is a step on the way to implementing Apple IIe (enhanced) support in OpenEmulator: I may alternate adding tests here and features there.