$Id: README.txt,v 1.2 2003/09/22 02:14:36 jerry Exp $
$Source: /home/cvsroot/qwikloader/test/README.txt,v $

The files in this directory were used to test QwikLoader v1.1.

POSITIVE TESTS:
---------------
The following files should load without error. When run (using the 'q'
command, or after reset) these programs will flash an LED connected to
C0). The .HEX files have been manually edited to add a version string to
the end of the file. These files include extended address records (type
04h) and configuration setttings (hex file address 400Eb), so QuikLoader
should report two skipped lines in each file.

        goto1.HEX       There is a goto instruction at location 0000h. The
                        source code for this file is goto1.asm.

        goto3.HEX       On reset, the PCLATH register is set and then a
                        goto instruction is exectuted (3 instructions
                        total. The source code for this file is
                        goto3.asm

        nogoto.HEX      The program exectutes directly from location
                        0000h. This file as an extended version string
                        at the end that overflows both the line input
                        buffer and the version storage area. QwikLoader
                        should handle this without error (though the end
                        of the line will be treated as a new command and
                        thereby produce a syntax error when the user
                        tries to enter the next command). The source
                        code for this file is nogoto.asm.


NEGATIVE TESTS:
---------------
The following lines should produce error messages unless noted. All
lines in the file (bad_data.HEX is fairly long) should be consumed. A 'q' or
'v' command should report that there is no user program present.
These files were created by hand edits and can not be directly recreated
from source files.

        bad_data.HEX    "Checksum error" on line 4 (the download will
                        appear to hang after printing the "Checksum
                        error" message while the remainder of the file
                        is read and discarded- just wait).

        bad_type.HEX    "Invalid record type error" on line 1

        badconfig.HEX   "Non-HEX char error" on line 6 (because the
                        config line is actually short a character.)

        missingEOF.HEX  Download will hang- press reset.