Update readme and audit/build script

This commit is contained in:
Zellyn Hunter 2017-01-24 12:06:20 -06:00
parent 0f8d0b1790
commit f291ff20e2
2 changed files with 56 additions and 20 deletions

View File

@ -1,23 +1,37 @@
# 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.
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 an emulator test suite, enabling
emulator writers to systematically identify and eliminate perceptible
differences from real hardware. If a difference visible to code can be
found, a test should be added to this suite.
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).
## Status
I'm just getting started, currently working on:
### Done
- experimenting with toolchains for automation
- preliminary floating-bus vsync examples
- sha1sum assembly code
- [x] toolchain for automation ([diskii](github.com/zellyn/diskii))
- [x] sha1sum assembly code (currently not used yet because it's slow)
- [x] language card tests
- [x] main/auxiliary memory softswitch behavior tests
### TODO
- [ ] floating-bus tests
## Raison d'être
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.

View File

@ -23,14 +23,36 @@ grep -h '+prerra\? .*;;' *.asm | awk -F' ;; ' '{print $2}' | sort | sed 's|\(E..
# Also run mame? (set ROMPATH to your local variant)
[[ -z "${ROMPATH-}" ]] && ROMPATH=~/mame/roms/
[[ "${1-}" == '2ee' ]] && mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo
[[ "${1-}" == '2e' ]] && mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo
[[ "${1-}" == '2p' ]] && mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo
[[ "${1-}" == '2' ]] && mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo
[[ "${1-}" == '2ee-d' ]] && mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo -debug
[[ "${1-}" == '2e-d' ]] && mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo -debug
[[ "${1-}" == '2p-d' ]] && mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo -debug
[[ "${1-}" == '2-d' ]] && mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo -debug
case "${1-none}" in
"2ee")
mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo
;;
"2e")
mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo
;;
"2p")
mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo
;;
"2")
mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo
;;
"2ee-d")
mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo -debug
;;
"2e-d")
mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo -debug
;;
"2p-d")
mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo -debug
;;
"2-d")
mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo -debug
;;
"none")
;;
*)
echo Options: 2ee, 2e, 2p, 2, 2ee-d, 2e-d, 2p-d, 2-d
esac
true # Signal success (since we had a bunch of conditionals that can return false status).