Test software for TTXHelper module v0.01
==================================

Required:
  _testmod            The test software
  _testfrmcv          Test frame with characters and mosiacs
  _testfrmfl          Test frame with flashing characters

  A compatible teletext receiver connected via IIC, tuned into a channel.


Created:
  _chapfour, _chaprgrd, _chapzero, _cnvisogb, _cnvisoit, _flash, _lineext,
  _readwrite, _tsdptest



Test methodogy:

  Run "_testmod".

  Some junk should appear on the screen, finishing with the message:
                             ** TESTS COMPLETE **

  Any other response is a fault.


The tests in detail:

  1. Flash detection
     "_testfrmfl" is loaded and de-flashed. This is saved as "_flash".
     Examine "_flash" and observe that the part "ADJUST" has been removed.

  2. Character set tests
     Using undocumented calls, we provide a few quick tests to ensure that
     the ISO lookup character set is changing correctly.

  3. Teletext -> ISO conversion
     "_testfrmcv" is loaded and output in an ISO format using the English
     character set ("_cnvisogb") and the Italian character set ("_cnvisoit").
     Load both and observe that the characters have all been de-munged,
     converted to the correct character set, and mosiac characters have been
     removed along with all control codes.
     This command is intended to be used in conjunction with ExtractLine.

  4. Line extraction
     "_testfrmcv" is loaded, converted to ISO English, and then each line is
     extracted to the file "_lineext". Observe the trailing-space suppression
     and the 'next' line counter.

  5. Raw access
     We build a shifting character test pattern, and patch in line numbers.
     This pattern is written into the decoder's internal memory. This is then
     read back and saved as "_readwrite".
     If this fails, disconnect the aerial lead and try again. :-)

  6. Chapter read
     We read chapter zero (the page data) and chapter four (the extension
     data) at a low level.
     The files "_chapzero" and "_chapfour" are created respectively.

  7. Harder chapter read
     We read chapter zero by poking values into the teletext decoder's
     internal registers, then reading them back. This is about as low level
     as you can get without using IIC calls directly. The file "_chaprgrd" is
     created, which should be identical to the file "_chapzero".

  8. TSDP clearing test
     Assuming an aerial is connected to a channel that broadcasts a
     television service data packet; you should examine the files "_chapfour"
     and the newly created file "_tsdptest" and observe that the data packet
     at file offset +920 is missing in the "_tsdptest" file.

  9. Invalid device ID tests
     This tests the sanity checking of SWI call inputs.
     The valid device is '0' (system IIC). We first attempt to set RiscTV
     (which should be an successful error); then we attempt to set device
     123 (which is also a successful error).
     Obviously, you will need to alter this if you are using TTXHelper with
     a different interface!

 10. Invalid byteread tests
     This tests the sanity checking of SWI call inputs.
     We try transferring -1 bytes, then we try row 123 and column 123. All of
     which should be invalid.
     Note that we DO NOT look up the memory address we've been asked to write
     to/read from. There *is* a limit, and that's it! :-)

 11. Invalid chapter test
     This tests the sanity checking of SWI call inputs.
     We try transferring from chapter 8, which should return an error.


A complete successful run should look like the following...


  TESTMOD test software for TTXHelper v0.01
  =====================

  This teletext device is compatible with the GC UTA-3.
  It has 2048 bytes of memory, and is connected via system IIC.
  This TTXHelper module is version '0.01'.


  Testing flash detection
  There was one flash code encountered.

  Character set test:
  English...pass.
  French...pass.
  Swedish...pass.
  Invalid (3)...pass.
  German...pass.
  Spanish...pass.
  Italian...pass.
  Invalid (7)...pass.

  Testing ttx to ISO conversion, english...italian...done.

  Testing line extraction code

  Raw memory read/write test
  Writing...reading...done.

  Chapter read test, reading chapter zero...and four...done.

  Chapter read test, using register read/write.
  Setting up...reading...done.

  TSDP clearing test, clearing...reading back...done.

  Testing invalid device response:
  In-range ID...passed.
  Out-of-range ID...passed.

  Testing invalid byteread response:
  Transfer -1 bytes...passed.
  Invalid row (123)...passed.
  Invalid column (0)...passed.

  Testing invalid bytewrite response:
  Transfer -1 bytes...passed.
  Invalid row (123)...passed.
  Invalid column (0)...passed.

  Testing invalid chapter response:
  Trying chapter 8...passed.

  ** TESTS COMPLETE **


[end of document]
