home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / a / dskdrv16.lzh / DSKDRIVE.DOC < prev    next >
Encoding:
Text File  |  1991-01-16  |  4.6 KB  |  79 lines
  1.                DSKDRIVE documentation (85/1/30) C.B.Falconer
  2.                =============================================
  3.                               revised 85/5/15
  4.  
  5. Copyright (c) 1985 by C.B.  Falconer.  This program may not be SOLD without 
  6. express written permission.  It may be copied and used as desired.
  7.  
  8. As presently configured this program allows read/write of IBMPC CPM86 DSDD, 
  9. HP125 (DSDD),  Televideo TS802 (DSDD), and KAYPRO II (SSDD) format disks on 
  10. the Kaypro 4 (at least the 1983 version Kaypro).   The Kaypro II format  is 
  11. included  because the Kaypro native disk sensing system cannot  distinguish 
  12. between  double  sided  disks  and double side disks  that  have  been  re-
  13. formatted  to  single  sided.   The program is designed to  be  dynamically 
  14. alterable  to other disk configurations,  and can also read  Kaypro  format 
  15. disks. (see source annotation).
  16.  
  17. The various alternate configurations are specified by executing
  18.  
  19.      d>DSKDRIVE A   (or B or C).  omitting a parameter used the default.
  20.  
  21. The separate program ALTDRIVE allows configuration to a wide range of  disk 
  22. formats,  through  menus  or direct specification.   This has not yet  been 
  23. released,  but will work with your revised version if you follow the stated 
  24. rules, and above all do not alter the "info" vector format.
  25.  
  26. You  will  require RSX.DOC for documentation on installation and  protocol.  
  27. To  customize to your own system you must build the host driver (rdhst  and 
  28. wthst),  and  customize  the  "seek"  procedure  to  your  hardware  (which 
  29. hopefully uses the WD 179x series of disk controller chips).  I suggest you 
  30. first get the program to read your own disks.   A "marked" disk, containing 
  31. full  128  byte  records (including cr and lf)  which  specify  the  track, 
  32. sector,  and physical sector (agreeing with DU),  and write protected, will 
  33. be very helpful.   DU will be useful to check the configuration parameters, 
  34. located at label "info".   (this is the run-time memory address returned by 
  35. the RSX system for parameter = 1.  READ THE RSX DOCUMENTATION).
  36.  
  37. The non-cpm standard values specified in the "info" data are:
  38.  
  39.      hstblk    number of CPM sectors per physical sector.  1, 2, 4 or 8
  40.      modrv     Which drive to alter.  0 is A, 1 is B, etc.
  41.      dskod     Handy coding for controller to select that disk
  42.      chgsid    Handy value for configuring side change commands
  43.      sec1st    How is the first physical sector labelled. Some systems
  44.                start at 1, others at 0.  This is not the CPM sector,
  45.                but has to do with how the disk is formatted.
  46.      invert    boolean allowing for controller inversion of data bits
  47.      config    a strategy for converting "host" addresses from the
  48.                Digital Research deblocking algorithm into actual 
  49.                physical addresses on the 2 sides of the disk.
  50.      ntrks     How many physical tracks on 1 side of a disk
  51.      nsecs     A constant that allows modification of the physical
  52.                sector address on side 1.  Used with config.
  53.  
  54. As  this  program  is  used I hope more useful  configuration  values  will 
  55. appear,  and  possibly  "include"  files to configure the  host  driver  to 
  56. various  machines.   This documentation needs clarification  also,  but  at 
  57. least it is a start.  You will need to read the source to adapt to machines 
  58. other  than  Kaypro.    Kaypro users should only need to alter  the  "info" 
  59. vector  to read any disk (except Apples,  which are a world to themselves).  
  60. BE WARNED:  later version Kaypro's use at least a different port for system 
  61. control (bitpt),  interchange drive select codes,  and invert the sense  of 
  62. several bits (motor on, side select).
  63.  
  64. I suggest that when first adapting this program to other hosts, you set the 
  65. "driver"  equate to false.   This will allow the program to load in a  non-
  66. standard  CPM  environment (such as under DDT),  but will prevent the  BDOS 
  67. ever  accessing  the  revised drivers.   However the  system  can  then  be 
  68. exercized by DU, which performs direct BIOS access via the pointer at (1),
  69. and  will thus use the test system.   IN THIS CASE BE CAREFUL NOT TO ACCESS 
  70. THE TEST DRIVE THROUGH BDOS, e.g. by DIR, STAT, logins, or other such.  USE 
  71. WRITE  PROTECTED  DISKS.    At  the  same  time  try  to  set  the  default 
  72. configuration to your own machine.   Once DSKDRIVE can read and write  your 
  73. own disks the rest will be easy.  If your system cannot handle double sided 
  74. disk you are severely handicapped in the formats available to you.
  75.  
  76. The driver system can also serve as a model for native code drivers for any 
  77. machine.
  78.  Q    
  79.