home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d552 / tsfsuite.lha / TSFSuite / docs / Overview.doc < prev    next >
Text File  |  1991-10-28  |  8KB  |  267 lines
  1.  
  2.     TEAC SCSI FLOPPY OVERVIEW DOC            July 2/91
  3.  
  4.     Overview.doc
  5.  
  6.     Index
  7.     -----
  8.     0) What it is
  9.     1) Command Lines
  10.     2) Setting up the device
  11.     3) Mountlist Entries
  12.     4) Using the Device
  13.     5) Gotchas
  14.     6) Getting SCSI floppies & docs
  15.     7) SCSI Direct
  16.     8) Included files
  17.     9) Caveats, Disclaimers etc.
  18.        10) Email addr
  19.  
  20.  
  21.     What it is
  22.     ----------
  23.     The TEAC SCSI Floppy (hereafter TSF) [FD-235JS] needs to have its
  24.     floppies formatted by the SCSI controller. This is accomplished by
  25.     sending an appropriate MODE_SELECT and then a FORMAT command via SCSI
  26.     Direct. SCSI Direct is an Amiga method of piggybacking raw SCSI
  27.     commands on a hard disk device (see include.i/scsidisk.i).
  28.     Every time you put a disk of different capacity, you need to change
  29.     the mode of the controller. This is done by sending an appropriate
  30.     MODE_SELECT command via SCSI Direct. You also need to send a DiskChange
  31.     to the handlers involved. If you put in a disk of the same capacity,
  32.     you still need to send a DiskChange command.
  33.     The different capacities and filesystems are reflected in a series of
  34.     devices.
  35.     SD4:    4 Meg AmigaDOS
  36.     SD2:    2 Meg AmigaDOS
  37.     SD1:    1 Meg AmigaDOS
  38.     SI4:    4 Meg MSDOS
  39.     SI2:    2 Meg MSDOS
  40.     SI1:    1 Meg MSDOS
  41.     In an ideal world, none of this would be necessary. One filesystem
  42.     could control the various capacities taking note when disks &
  43.     capacities are changed. But the FastFileSystem knows nothing about
  44.     changing the SCSI controller's various modes. Neither does it know when
  45.     disks are changed. Neither does it have the ability to change the
  46.     capacity of devices once mounted. One solution would be to write a
  47.     special filesystem, a challenging enterprise which I may attempt.
  48.     In the meanwhile, this is a suite of programs for dealing with TEAC
  49.     SCSI floppy drives. The suite includes:
  50.  
  51.     TEAC SCSI FLOPPY MODE_SELECT        TSFM1, TSFM2, TSFM4
  52.  
  53.     TEAC SCSI FLOPPY FORMAT         TSFF1, TSFF2, TSFF4
  54.  
  55.     TEAC SCSI FLOPPY AUTODISKCHANGE     TSFADC
  56.  
  57.     TEAC SCSI FLOPPY EXERCISER        TSX
  58.  
  59.  
  60.  
  61.     Command Lines
  62.     -------------
  63.     The TSF suite expects to be run from the CLI. Except for TSX, the
  64.     general template is
  65.  
  66.     TSFxxx [xxx.device scsi_id]
  67.  
  68.     The .device and scsi id are optional, depending on your hardware.
  69.     The defaults are harddisk.device and 1.
  70.     For TSX you do not need to worry about passing the .device and scsi
  71.     id as parameters, because there are menu items which allow one to set
  72.     these.
  73.  
  74.     Examples:
  75.  
  76.     TSFF4 ?                 /* Prints format */
  77.     TSFF2                    /* USES DEFAULTS */
  78.  
  79.     TSFM2 ?                 /* Prints format */
  80.     TSFM1                    /* USES DEFAULTS */
  81.     TSFM4 scsi.device 3
  82.  
  83.     TSFADC                     /* USES DEFAULTS */
  84.     TSFADC scsi.device 3
  85.  
  86.     TSX
  87.  
  88.     There is more detailed info regarding command lines in each of
  89.     the TSxxxx.docs.
  90.  
  91.  
  92.  
  93.     Setting up the device
  94.     ---------------------
  95.     The FC-1 has a 50 pin standard scsi connector so it is straight
  96.     forward if your controller uses the 50 pin connector as well. If your
  97.     controller uses the CBM A2090x which has a Mac style 25 pin connector
  98.     you will need a special cable. These are usually available from Mac
  99.     dealers.
  100.     At the back of the TSF, there are pins for the SCSI ID. See the
  101.     Teac docs for more info on setting the SCSI ID. As far as I know the
  102.     LUN is fixed at zero. Once you have the drive connected (with the power
  103.     off, yes?) the mountlist entries below need to be added to your
  104.     mountlist.
  105.  
  106.  
  107.     Mountlist Entries
  108.     -----------------
  109. /*
  110.  *
  111.  * SCSI Floppy under the Xetec driver 720K, 1.44M, 2.88M
  112.  *     BlocksPerTrack = 36  (for 2.88M)       SD4:
  113.  *     BlocksPerTrack = 18  (for 1.44M)       SD2:
  114.  *     BlocksPerTrack = 9   (for  .72M)       SD1:
  115.  */
  116.  
  117. SD1:     Device = harddisk.device
  118.      FileSystem = l:FastFileSystem
  119.      Unit = 1
  120.      Surfaces = 2
  121.      LowCyl = 0
  122.      HighCyl = 79
  123.      Reserved = 2
  124.      BlocksPerTrack = 9
  125.      Buffers = 10
  126.      BufMemType = 3
  127.      Stacksize = 6000
  128.      Priority = 10
  129.      GlobVec = -1
  130.      MaxTransfer = 0x0001FE00
  131.      Mask = 0x00FFFFFE
  132.      DosType = 0x444F5301
  133. #
  134.  
  135. /*
  136.  *
  137.  * SCSI Floppy under the Xetec driver .72M
  138.  *     Using MSDOS File System
  139.  *     BlocksPerTrack = 36  (for 2.88M)       SI4:
  140.  *     BlocksPerTrack = 18  (for 1.44M)       SI2:
  141.  *     BlocksPerTrack = 9   (for  .72M)       SI1:
  142.  */
  143.  
  144. SI1:     Device = harddisk.device
  145.      FileSystem = l:MSDOSFileSystem
  146.      Unit = 1
  147.      Surfaces = 2
  148.      LowCyl = 0
  149.      HighCyl = 79
  150.      Reserved = 2
  151.      BlocksPerTrack = 9
  152.      Buffers = 5
  153.      BufMemType = 5
  154.      Stacksize = 6000
  155.      Priority = 10
  156.      GlobVec = -1
  157.      MaxTransfer = 0x0001FE00
  158.      Mask = 0x00FFFFFE
  159.      DosType = 0x4D534400
  160.      Mount = 0;
  161. #
  162.  
  163.  
  164.     Using the device
  165.     ----------------
  166.     Once you have mounted the capacity device which you are going to
  167.     use, the general sequence is to scsi format [TSFFx] the disk, then to
  168.     AmigaDOS format the disk.
  169.  
  170.     For example, to use the drive with a 2 Meg AmigaDOS disk
  171.  
  172.     1) Mount SD2:
  173.         eg. use the command line
  174.         1> Mount SD2:
  175.     2) SCSI Format with TSFF2
  176.         eg. use the command line
  177.         1> TSFF2
  178.     3) AmigaDOS Format
  179.         eg. use the command line
  180.         1> Format drive SD2: name Test.0 noicons quick
  181.     4) Test if the system sees it
  182.         eg. use the command line
  183.         1> info
  184.         1> list sd2:
  185.  
  186.     There are more detailed examples in each of the TSxxxx.docs.
  187.  
  188.  
  189.     Gotchas
  190.     ----
  191.     It is very easy to corrupt disks because the FastFileSystem [or the
  192.     MSDOSFileSystem] has no way of knowing if you have changed disks. You
  193.     either have to be very careful about doing DISKCHANGEs or use TSFADC.
  194.     This is a daemon which does occasional Test Unit Readys. If there is a
  195.     change in the SCSI status, it sends a disk change packet to the
  196.     handler.
  197.  
  198.  
  199.     Getting SCSI floppies & docs
  200.     ----------------------------
  201.     There are several different TEAC SCSI JS floppies available. The
  202.     names are of the form FD-235JS-xxx. The xxx in the name designates the
  203.     model of drive which the FC-1 controller board is strapped to. I have
  204.     seen mention of 300/302/401/650 & I have the 660-U.
  205.  
  206.     FD-235HS-302    3.5" 1.44Mb SCSI floppy (using FC-1)
  207.     FD-235JS-401    3.5" 2.88Mb SCSI floppy (using FC-1)
  208.     FD-55GS-704    5.25" SCSI floppy (using FC-1)
  209.  
  210.     I have used this software only on my FD-235JS-660U model. There are
  211.     different versions of the FC-1 around, which TSX will show you with the
  212.     INQUIRY command. There are also other programs around such as Xetec's
  213.     SCSI_LISTER which will tell you the version you have.
  214.     The TEAC drive documentation available is:
  215.  
  216.     FC-1 Spec        Part number 10530468-01 @ US$20.00
  217.     FD235J-650 Spec Part number 10530403-50 @ US$ 7.00
  218.     FD235HS-300Spec Part number 10530472-02 @ US$ 7.00
  219.     FD235JS-   Spec Part number  ?        @ US$ 7.00
  220.  
  221.     They also want $4.00 shipping & handling per item. (My copy of the
  222.     FC-1 docs was missing pages & had pages out of order, but there was
  223.     enough info there to get the thing working.)
  224.  
  225.     The SCSI specs are available from the ISO rep in each country. See
  226.     the file SCSI.docs for more info.
  227.     The easiest & most useful way for a hacker to get hold of the SCSI
  228.     specs is downloading from the SCSI BBS. As far as I know, there is no
  229.     internet site which carries these docs.
  230.     SCSI BBS  (316)-636-8700.
  231.  
  232.     SCSI Direct
  233.     -----------
  234.     If you are bit banging on a SCSI Controller chip, normally you set
  235.     up your CDB and then diddle the status/control of the chip until you
  236.     can send your commands to the target. Then you send your commands and
  237.     monitor the chip for various responses.
  238.     On the Amiga, you set up your CDB, you set up a SCSI_CMD to point
  239.     to the CDB and you set up a standard IO Request Block to point to the
  240.     SCSI_CMD. You then issue a HD_SCSICMD to the device using that IO
  241.     Request Block. This method allows one to send any SCSI CDB to any
  242.     device, a harddisk laser printer, or whatever.
  243.     For more info on SCSI Direct see devices/scsidisk.i|h.
  244.  
  245.     Included files
  246.     --------------
  247.     If you want a look at the source (in assembly) drop me a line.
  248.  
  249.     Caveats, Disclaimers etc.
  250.     -------------------------
  251.     This software is provided for testing purposes only.
  252.     I cannot be held reponsible for what you do on your computer.
  253.     Under no circumstances will I or MetaMedia Productions be held
  254.     reponsible for any damage problems etc. which may arise as a result
  255.     of running this Beta software.
  256.  
  257.  
  258.     Email Addr
  259.     ----------
  260.     Harvey Taylor      Meta Media Productions
  261.     uunet!van-bc!rsoft!mindlink!Harvey_Taylor
  262.         a186@mindlink.bc.ca
  263.  
  264.  
  265.     The TSF suite and documentation is all Copyright   1991    by Harvey Taylor
  266.  
  267.