a2audit/README.md
Zellyn Hunter 2a0b0da1b2 Duplicated the redbook monitor routines we use
IIe machines jump to Cxxx ROM for initialization and HOME (and
probably other things too). This change makes the audit tests more
self-contained, for when you're trying to test an emulator that's not
really working yet.
2017-02-02 22:33:53 -05:00

1.5 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
  • Incorporate Cxxx testing into data-driven test
  • Add testcases for Cxxx testing
  • duplicate HOME and COUT routines from AppleII, so IIe tests don't depend on Cxxx ROM working

TODO

  • IIe: check that we really have 128K (aux switching actually does anything)
  • IIe: don't test auxmem softswitches if we only have 64k
  • 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.