home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol062 / dtst.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  11.9 KB  |  243 lines
  1. Z-80 Floppy Disk Test
  2.  
  3. Copyright (c) 1980 by Laboratory Microsystems
  4.                       4147 Beethoven Street
  5.                       Los Angeles, California 90066
  6.  
  7.  
  8.  
  9. 1.0  General description
  10.  
  11. The  Z-80 Floppy Disk Test is a general purpose utility for testing or
  12. initializing a diskette.  It requires a Z-80 microprocessor, at  least
  13. 16  kbytes  of random access memory, two flexible disk drives, and the
  14. Digital Research CP/M 2.x operating system.  Program mode and area  of
  15. diskette to be tested are controlled from the keyboard.  Errors may be
  16. audited on the console or the line printer.  
  17.  
  18. As supplied on the distribution diskette, the program is configured to
  19. test  a  soft-sectored, single density disk with 77 tracks, 26 sectors
  20. per track, and 128 byte sectors.  If you are using a different type of
  21. disk drive, the number of tracks  and/or  sectors  per  track  may  be
  22. specified during the initialization dialogue.
  23.  
  24. The program does not exhaustively check out the disk  drive,  and  any
  25. errors  detected  by  the  program  must  be  interpreted  with  care.
  26. Intermittent  errors  occurring  throughout  a  broad  range  of  disk
  27. addresses  probably  indicate  a  problem  with  the  disk drive unit.
  28. Errors indicated at consistent addresses within  adjacent  tracks  may
  29. result  from a worn or damaged flexible disk.  Error free execution of
  30. the test certainly indicates an intact and usable diskette,  and  also
  31. is  fairly good evidence of proper operation of your disk drive.  Note
  32. that the program is rather insensitive to drive  problems  related  to
  33. head  movement, since the diskette is addressed in a smooth sequential
  34. manner.
  35.  
  36.  
  37. 2.0  Installation
  38.  
  39. Mount  your system disk in drive A, and the distribution disk in drive
  40. B.  Use the PIP utility to transfer the test program onto  the  system
  41. disk:
  42.  
  43.         A>pip a:=b:dtst.com [v]
  44.  
  45. Now  remove  the  distribution  disk  from drive B and store it as the
  46. backup copy.
  47.  
  48.  
  49. 3.0  Using the Test Program
  50.  
  51. Put your system disk in drive A, boot up the CP/M operating system, and
  52. type:
  53.  
  54.         A>dtst
  55.  
  56. The test program will load  into  memory  and  print  the  identifying
  57. message:
  58.  
  59.         Laboratory Microsystems Disk Test version 1.0
  60.  
  61. If there is inadequate memory in the transient program area, or if the
  62. operating  system is not CP/M version 2.0 or greater, the program will
  63. immediately print a warning message and  exit.   Otherwise,  the  test
  64. proceeds  to  the initialization dialogue.  The test mode is set via a
  65. series of questions presented on the system console.  Answers  calling
  66. for  an  alphabetic  character  may be upper or lower case; a carriage
  67. return is not required.  Answers calling for  a  number  must  be  two
  68. digits, or one digit followed by a carriage return.
  69.  
  70. query                   responses       explanation
  71. -----                   ---------       -----------
  72.  
  73. Itemize errors?         Y or N          If   answered  y,  each  error
  74.                                         detected  is  audited  on  the
  75.                                         selected  device.  If answered
  76.                                         N, only the total error  count
  77.                                         is  printed at the end of each
  78.                                         pass.
  79.  
  80. Console or Printer?     C or P          If  itemizing  errors,  select
  81.                                         the   device   on   which  the
  82.                                         itemized error listing will be
  83.                                         printed.
  84.  
  85. Lock on read or write?  N, R, or W      N = no locks.   R  =  lock  on
  86.                                         read  mode (no data is written
  87.                                         to the  disk  ---  useful  for
  88.                                         detecting any damaged areas on
  89.                                         the media).  W = lock on write
  90.                                         (all   data  on  the  disk  is
  91.                                         destroyed --- this may be used
  92.                                         to erase a  diskette  by  also
  93.                                         locking on pattern)
  94.  
  95. Restore original data?  Y or N          Y  =  restore existing data on
  96.                                         diskette  after  testing  each
  97.                                         sector.   N  =  do not restore
  98.                                         existing data.  Test runs much
  99.                                         faster when  restore  mode  is
  100.                                         not used.
  101.  
  102. Lock on data pattern?   Y or N          Y  =  user  wishes  to specify
  103.                                         specific data to  be  used  as
  104.                                         the  test pattern.  N = random
  105.                                         data pattern is  generated  by
  106.                                         the test program.
  107.  
  108. Enter data pattern      hex 00-FF       If  you  answered Y to Lock On
  109.                                         Pattern, enter the  eight  bit
  110.                                         data pattern to be used during
  111.                                         disk testing.  If you answered
  112.                                         N, this question is bypassed.
  113.  
  114. Drive to be tested      B, C, or D      Specify  disk drive to be used
  115.                                         for  diskette   testing.    In
  116.                                         order  to  prevent  accidental
  117.                                         destruction  of   the   system
  118.                                         disk,  the  use  of drive A is
  119.                                         not allowed.
  120.  
  121. Test all tracks?        Y or N          Y = test all tracks (00-76) in
  122.                                         sequence.  N = user wishes  to
  123.                                         specify  range  of tracks (may
  124.                                         be used to test only part of a
  125.                                         diskette, or if disk drive  is
  126.                                         other  than  standard  8  inch
  127.                                         single density).
  128.  
  129. First track to test     decimal 00-76   If you answered N to Test  All
  130.                                         Tracks,   specify   here   the
  131.                                         number of the first  track  to
  132.                                         test.
  133.  
  134. Last track to test      decimal 00-76   If  you answered N to Test All
  135.                                         Tracks,   specify   here   the
  136.                                         number  of  the  last track to
  137.                                         test.  Must  be  the  same  or
  138.                                         greater than the number of the
  139.                                         first track to test.
  140.  
  141. Test all sectors?       Y or N          Y = test all sectors (1-26) in
  142.                                         sequence.   N = user wishes to
  143.                                         specify range of sectors  (may
  144.                                         be  used  to test only part of
  145.                                         each track, or if  disk  drive
  146.                                         is  other than standard 8 inch
  147.                                         single density).
  148.  
  149. First sector to test    decimal 01-26   If you answered N to Test  All
  150.                                         Sectors,   specify   here  the
  151.                                         number of the first sector  to
  152.                                         test on each track.
  153.  
  154. Last sector to test     decimal 01-26   If  you answered N to Test All
  155.                                         Sectors,  specify   here   the
  156.                                         number  of  the last sector to
  157.                                         test on each track.   Must  be
  158.                                         the  same  or greater than the
  159.                                         number of the first sector  to
  160.                                         test.
  161.  
  162. How many test passes?   decimal 01-99   Enter   the   number  of  test
  163.                                         passes  to  be  made  on   the
  164.                                         diskette.   At  least one pass
  165.                                         is always  made  even  if  you
  166.                                         enter zero.
  167.  
  168. After entry of the number of  test  passes,  the  program  immediately
  169. begins  executing.  The program may be interrupted by pushing any key,
  170. however response may be delayed for several seconds depending  on  the
  171. speed  of  the  processor  and  disk  drive.   Do not stop the test by
  172. resetting the computer system  if  you  are  using  restore  mode,  or
  173. unpredictable amounts of data may be lost.
  174.  
  175.  
  176. 4.0  Error Listing
  177.  
  178. Errors  detected  by the program may be itemized on the system console
  179. or the line printer.  The pass, drive name, track,  and  sector  where
  180. the error occurred are listed.  All numbers are in decimal.  The error
  181. type is designated at the right.  In the explanations below, "hardware
  182. error" signifies an error status code returned from the low level disk
  183. driver, and usually means a CRC fault or seek incomplete.
  184.  
  185.  
  186. error type                      explanation
  187. ----------                      -----------
  188.  
  189. read error - original data      If  running  in restore mode, hardware
  190.                                 read error noted as the original  data
  191.                                 was being loaded into memory.
  192.  
  193. write error - test data         Hardware  error noted as the test data
  194.                                 pattern  was  being  written  on   the
  195.                                 diskette.
  196.  
  197. read error - test data          Hardware  error noted as the test data
  198.                                 pattern was being read back  from  the
  199.                                 diskette.
  200.  
  201. compare error - test data       Difference  was found between the data
  202.                                 pattern  that  was  written   to   the
  203.                                 diskette  and  the  data that was read
  204.                                 back.
  205.  
  206. write error - restore phase     Hardware error noted as  the  original
  207.                                 data  was  being  written  back to the
  208.                                 diskette.
  209.  
  210. read error - restore phase      Hardware error noted as  the  restored
  211.                                 original  data was being read back for
  212.                                 verification.
  213.  
  214. data cannot be restored         Compare  error   found   between   the
  215.                                 original   data   rewritten   to   the
  216.                                 diskette and  the  same  sectors  read
  217.                                 back for verification.
  218.  
  219.  
  220. 5.0  Program areas of interest to users
  221.  
  222. To  use  the  program  on  other  types  of disk drives, it may become
  223. necessary to change the first two locations given below.  This may  be
  224. done  be  reading  in  the  COM  file  with  DDT, patching the desired
  225. location, and SAVEing a new COM file.
  226.  
  227. 0119H   (8  bits)  Sector skew flag.  If byte=0, skew is not used.  If
  228.         byte=1,  remap  sector  numbers  as  given   in   the   sector
  229.         translation  table.   On  Z-80  systems  at 4 mhz, skew is not
  230.         needed and this byte may be left zero.  On systems with slower
  231.         processors, test speed may be improved by use of skew.
  232.  
  233. 0121H   (8  bits)  Contains the number of digits to be accepted by the
  234.         numeric input routines during the initialization dialogue, the
  235.         value is two in the distributed version.  If test is to run on
  236.         a drive with greater than 99 tracks, change the value of  this
  237.         byte to three.
  238.  
  239. 0122H   (16  bits)  Contains  the  address  of  the sector translation
  240.         table.  In the distributed program, the table is built with  a
  241.         skew factor of three, and is 26 bytes long.
  242.  
  243.