home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / cdrom / cdt / cdt.doc < prev    next >
Text File  |  1995-11-24  |  5KB  |  175 lines
  1.  
  2. INTRODUCTION
  3.  
  4.     CDT is a small shell utility to cope with SCSI devices, but mainly with
  5.     a CD-ROM. It has been written to be able to start audio playback with
  6.     "stupid" drives that do support an advanced audio command as eg. used by
  7.     SCSIutil. Its also possible to issue a load or eject command as well as 
  8.     to lock or unlock a drive.
  9.  
  10. LEGAL
  11.  
  12.     CDT is Copyright © 1995 by Gunther Nikl, All Rights Reserved.
  13.     Permission granted to distribute free of charge, in unchanged form,
  14.     provided this documentation file is accompanied with the program.
  15.     Permission granted to include on freely distributable software
  16.     libraries such as Fred Fish's software library and the Aminet CD-ROM.
  17.  
  18.     CDT is provided as is, without any kind of warranty. By using CDT, the
  19.     user accepts full responsibility for possible damage or data loss that
  20.     might occur, directly or indirectly, from using CDT.
  21.  
  22.     CDT is GIFTWARE. If you use CDT, send me a gift (your own program, beer,
  23.     chocolate, a new computer, a money donation, etc.), the address is in
  24.     the end of this document.
  25.  
  26. FEATURES
  27.  
  28.     - supports any CD-ROM that has a SCSI-2 compliant device driver
  29.       (thus also atapi drives)
  30.     - can start/stop/pause/resume audio playback
  31.     - written in C (and compiled with GCC 2.7.0 ;-)
  32.     - 100% pure, can be made resident
  33.  
  34. INSTALLATION
  35.  
  36.     Installing CDT is fairly easy. Copy it to a location on you harddisk
  37.     (preferable in the search path, eg. C:). Thats all :-).
  38.     I would recommend to create aliases to avoid 
  39.  
  40. USAGE
  41.  
  42.     CDT can only be started from CLI! Do NOT try to start the program from
  43.     Workbench since this will lead to a system crash!
  44.  
  45.     CDTs shell template:
  46.  
  47.     D=DEVICE,U=UNIT/K/N,STARTTRACK/N,STARTINDEX/N,LASTTRACK/N,LASTINDEX/N,
  48.     LOAD/S,EJECT/S,LOCK/S,UNLOCK/S,PLAY/S,STOP/S,PAUSE/S,RESUME/S,INFO/S
  49.  
  50.     Detailed explanation:
  51.  
  52.     - D=DEVICE
  53.  
  54.       used to specify the lowlevel device driver to access the SCSI drive.
  55.       Usual names are: scsi.device, atapi.device, etc.
  56.       Alternative you can also specify a DOS-device. That means the name
  57.       the drive is accessed from DOS, eg. "CD0:". CDT will try to get the
  58.       name of the device driver and the device unit from DOS. If that fails
  59.       it will use its internal defaults. An error message of the form:
  60.  
  61.         "couldn't open `scsi.device' unit `4'
  62.  
  63.       can be a hint that the information searched for wasn't available.
  64.  
  65.       Default device driver is `scsi.device'.
  66.  
  67.     - U=UNIT/K/N
  68.  
  69.       used to specify the driver number. If as device a DOS-device was
  70.       specified this option will be ignored but only if all required
  71.       information from the dos-device could be retrieved.
  72.  
  73.       Default unit is `4' (do not ask why ;-)
  74.  
  75.      - STARTTRACK/N
  76.  
  77.        first title to play (starts with 1)
  78.  
  79.        defaults to 1.
  80.  
  81.      - STARTINDEX/N
  82.  
  83.        which start index but can usually be omitted
  84.  
  85.        defaults to 0.
  86.  
  87.      - LASTTRACK/N
  88.  
  89.        last title to play (max. 99)
  90.  
  91.        defaults to 99.
  92.  
  93.      - LASTINDEX/N
  94.  
  95.        which end index but can usually be omitted
  96.  
  97.        defaults to 0.
  98.  
  99.      - PLAY/S
  100.  
  101.        starts the audio playback with the parameters above. First CDT will
  102.        use an `intelligent' command to start the audio playback. If this
  103.        fails CDT will try a more generic command to play an audio cd. This
  104.        shall make CDT work with every CD-ROM drive, at least I hope so ...
  105.  
  106.        Some examples:
  107.  
  108.         - play
  109.           will play the complete cd
  110.  
  111.         - play 5
  112.           starts audio playback with title number 5
  113.  
  114.         - play 5 0 9
  115.           will play from title number 5 to 9 (0 is the startindex, required)
  116.  
  117.      - PAUSE/S
  118.  
  119.        pauses audio playback (if its playing ignored otherwise)
  120.  
  121.      - RESUME/S
  122.  
  123.        resumes audio playback (if its paused ignored otherwise)
  124.  
  125.      - LOAD/S
  126.  
  127.        will close the drive's tray (if it was open)
  128.  
  129.      - EJECT/S
  130.  
  131.        will open the drive's tray (if it was closed)
  132.  
  133.      - LOCK/S
  134.  
  135.        prevents the opening of the tray
  136.  
  137.      - UNLOCK/S
  138.  
  139.        allows the opening of the tray
  140.  
  141.      - INFO/S
  142.  
  143.        prints information about the drive. This works also for harddisks.
  144.  
  145. BUGS
  146.  
  147.     This program has only be tested with IDE drives that device drivers
  148.     emulate a SCSI-2 environment. The two tested drives had some problems:
  149.  
  150.       - playing only parts of an audio cd doesn't work (not quite true,
  151.         if only the last title was requested it works :-)
  152.         (Toshiba XM-5302B, Sony CDU-77E)
  153.       - `pause' option does not work with Sony CDU-77E, the drive aborts
  154.         the audio playback completely
  155.       - closing the drive tray without inserted medium will give an error
  156.         message
  157.  
  158. HISTORY
  159.  
  160.     1.0 - initial release
  161.  
  162. AUTHOR
  163.  
  164.     CDT is written by Gunther Nikl.  You can reach me by email at the address
  165.  
  166.     gnikl@informmatik.uni-rostock.de
  167.  
  168.     or by snailmail (for the time being, anyway) at the address
  169.  
  170.     Gunther Nikl
  171.     Ziegendorfer Chaussee 96
  172.     Parchim
  173.     19370
  174.     Germany
  175.