home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / cdactrl.lha / CDDACtrlDocs next >
Text File  |  1990-12-11  |  8KB  |  347 lines
  1.  
  2.  
  3.  
  4.                               CDDA Controller
  5.                               ===============
  6.  
  7.                 Copyright ©1990 Canadian Prototype Replicas
  8.  
  9.                                   PO Box 8,
  10.                                Breslau,Ontario
  11.                                    CANADA
  12.  
  13.                                   N0B  1M0
  14.  
  15.                                (519) 884-4412
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                           KNOW PROBLEMS Beta V0.268
  27.                           =========================
  28.  
  29.  
  30.     1.) The track number display is not updated continually.
  31.         To reset the track number display, click on the large
  32.         Manufacturers name gadget.
  33.  
  34.     2.) The "?" or "Sequence" gadget is not fully functional.
  35.         You may click on it to get a list of tracks for the disk,
  36.         and then select ONE track to be played.
  37.  
  38.     3.) UPC numbers are not yet available for the Hitachi CDR 3650.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                           
  49.                           ==================
  50.  
  51.  
  52.     This version requires and includes the new "scsidirect.library".
  53.  
  54.     This library takes care of all SCSI I/O and provides a set of
  55.     high level functions to interface with SCSI devices.
  56.  
  57.     A seperate Developers disk for scsidirect.library will be available
  58.     early in 1991.
  59.  
  60.     There are now two seperate controller programs, one for NEC drives
  61.     and one for HITACHI 1650/3650 drives.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                           HARD DRIVE INSTALLATION
  71.                           =======================
  72.  
  73.  
  74.     Simply drag the CDDACtrl icon for either the NEC or HITACHI player
  75.     from the floppy disk to your hard drive.
  76.  
  77.     Then, from the CLI issue the following command.
  78.  
  79.         Copy CDDACtrl:Libs/scsidirect.library TO LIBS:
  80.  
  81.  
  82.     Optionally, there is an HDInstall icon that you can double-click to
  83.     copy the library for you.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                               USING CDDACtrl
  93.                               ==============
  94.  
  95.  
  96.     To run the CDDACtrl program from Workbench, just double click on the
  97.     CDDACtrl icon.
  98.  
  99.     To run CDDACtrl from the CLI, type "CDDACtrl <device> <unit> [nowindow]"
  100.     and then the return/enter key.
  101.  
  102.     Device represents the device name of the host adapter and unit is the
  103.     SCSI ID that the drive is set to. The keyword 'nowindow' will instruct
  104.     CDDACtrl NOT to open it's window.  This is usefull when launching from
  105.     AmigaVision and/or ARexx or other scripts.
  106.  
  107.     NOTE:   CDDACtrl will detach from a launching CLI.
  108.             There will be a short delay before the window actually opens
  109.             while CDDACtrl does it's initializations.
  110.  
  111.  
  112.  
  113.  
  114.                                   TOOLTYPES
  115.                                   =========
  116.  
  117.     The device driver is controlled through the ToolTypes in the CDDACtrl
  118.     icon.  There are two tooltypes that MUST be set as follows:
  119.  
  120.  
  121.         DEVICE= This is the device driver name for the host adapter to
  122.                 which the drive is connected.  The default is set to
  123.                 "DEVICE=scsi.device".
  124.  
  125.         UNIT=   This is the SCSI ID number that the drive has been set to.
  126.                 The default is set to "UNIT=5" but it is almost certain
  127.                 that you will have to change this.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                               OPTIONAL TOOLTYPES
  137.                               ==================
  138.  
  139.  
  140.         LEFT=   Defines the LeftEdge or X co-ordinate for the display
  141.                 window.
  142.  
  143.         TOP=    Defines the TopEdge or Y co-ordinate for the display
  144.                 window.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.                                   AREXX COMMANDS
  159.                                   ==============
  160.  
  161.  
  162.     The following ARexx Commands are available and should be sent to the
  163.     ARexx port named `CDDACtrl?.rexx', where ? is the SCSI ID number of
  164.     the device you wish to control.     ie. `CDDACtrl5.rexx'
  165.  
  166.     This allows you to have a CDDACtrl program running for each physical
  167.     CD-Rom drive connected to your system.
  168.  
  169.     NOTE:   Only one CDDACtrl is allowed per physical device.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.     DATABASE      NOT USED
  181.     ----------------------
  182.  
  183.             Not available from ARexx at this time.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.     BACK    <Tracks>
  203.     ----------------------
  204.             Back up the specified number of tracks.
  205.  
  206.  
  207.     PLAY    <Start Track Number> <Stop Track Number>
  208.     ---------------------------------------------------
  209.             Plays the disc starting at the specified track.  If Stop track
  210.             is given, the play will be discontinued after the stop track
  211.             has been played.  If stop track is zero, play will continue to
  212.             the end of the disc.
  213.  
  214.  
  215.     FORWARD <Tracks>
  216.     ----------------------
  217.             Move Forward the specified number of tracks.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.     PAUSE
  225.     ----------------------
  226.             Toggles the pause function
  227.             The default is NOT paused.
  228.  
  229.  
  230.     STOP
  231.     ----------------------
  232.             Turns the CD Drive off.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.     SEQUENCE     NOT USED
  247.     ----------------------
  248.  
  249.             Not available from ARexx at this time.
  250.  
  251.  
  252.  
  253.     EJECT
  254.     ----------------------
  255.             Ejects the disc from the drive.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.     LEFT
  269.     ----------------------
  270.             Changes playback status to left channel only.
  271.  
  272.  
  273.     RIGHT
  274.     ----------------------
  275.             Changes playback status to right channel only.
  276.  
  277.  
  278.  
  279.     STEREO
  280.     ----------------------
  281.             Changes playback status to both left and right channels.
  282.             This is the default.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.     PLAYTIME <AMin> <ASec> <AFrame> <BMin> <BSec> <BFrame>
  291.     -----------------------------------------------------------
  292.             Play starting at AMin ASec AFrame and stop at
  293.             BMin BSec BFrame.  These TimeCodes correspond to the
  294.             `TIMECODE' display mode.
  295.  
  296.             Valid Ranges: AMin   BMin   00-60
  297.                           ASec   BSec   00-60
  298.                           AFrame BFrame 00-75
  299.  
  300.             NOTE:   You must supply both start times and stop times, or
  301.                     the previously used stop time will be used.
  302.                     You must also supply times that are actually on
  303.                     the audio portion of a track. If you miss, the command
  304.                     will not take effect.  Leadin and leadout areas of the
  305.                     audio track are considered a miss.
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.     QUIT
  313.     ----------------------
  314.             Ends the session and closes down the CDDACtrl Program.
  315.  
  316.  
  317.     TOC
  318.     ----------------------
  319.             Reads the Table of Contents for the disc inserted.
  320.  
  321.             This sets up the necessary parameters within the Player
  322.             Program and is performed automatically on first startup.
  323.  
  324.             Typically this would be called when a disc is changed.
  325.  
  326.             NOTE:   Automatic disc change is under investigation and
  327.                     will obsolete this call in the release version.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.     OPENWIN
  335.     ----------------------
  336.  
  337.             This command will instruct CDDACtrl to open it's controller
  338.             window so that gadgets and displays are available on screen.
  339.  
  340.  
  341.     CLOSEWIN
  342.     ----------------------
  343.             This command instructs CDDACtrl to close its window, but continue
  344.             to run in the background.  CDDACtrl will still accept ARexx
  345.             commands until the "QUIT" command is issued.
  346.  
  347.