Yet Another Atari RAM Test - v.0.2.3
(C) 2016-2021 Christian Zietz, CHZ-Soft
https://www.chzsoft.de/ - czietz@gmx.net

YAART (Yet Another Atari RAM Test) brings a selection of high-coverage RAM
testing algorithms to the Atari. With these algorithms -- proven for many
years by Memtest86 on the PC -- YAART is much more suitable to find
especially subtle RAM faults than most other RAM test software for Atari.

YAART may be distributed freely, as long as it is unmodified and
accompanied by this text.

YAART comes in two flavors:

YAART.TOS only runs on ST-type machines (ST, STE, MegaST, MegaSTE). It
directly accesses the hardware and can test almost all (ST-)RAM, including
screen memory and -- to a lesser extent -- also memory already in use by
TOS. However, I still recommend a clean boot from a floppy disk without
drivers or AUTO-start programs. If YAART finds a system configuration that
it cannot work with, it will print an error message.

YAARTTT.TOS should run on any Atari machine, from ST to Falcon. It can
test ST-RAM and Alternate RAM/TT-RAM, but only memory that is currently
unused and can be allocated by GEMDOS. So a clean boot is even more
important here to maximize coverage.

YAARTTT.TOS has a "hidden feature": Pressing 'M' at the prompt right after
startup will switch to manual address entry mode. You can then enter any
start and end address, e.g., to test memory that is not registered with
GEMDOS. However, testing allocated or non-existing memory will crash the
system or cause data corruption!

After start, YAART/YAARTTT will repeatedly test memory and print the
current iteration, the number of errors, and -- in case an error is found
-- its address and the read data vs. the expected data. This information
allows isolating the location of the fault.

Press and hold ALT to terminate the program.
Press and hold SHIFT to pause after an error message.

Using a shell that supports output redirection, you can write the messages
of YAART and YAARTTT into a file, e.g., for automated testing.

When prompted at the start of YAART/YAARTTT, you can optionally enable
serial output of the status messages in addition to printing to the screen
by pressing 'S'. The serial port is set to 9600 bit/s, 8 data bits, 1 stop
bit, no parity, no flow control. For machines with multiple serial ports,
the default port is used. If needed, change the default port using an
appropriate utility or CPX before starting YAART/YAARTTT.
