home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / mmpm_mpu.zip / read.me < prev    next >
Text File  |  1995-10-03  |  7KB  |  198 lines
  1.  
  2.    OS/2* DEVICE DRIVER FOR MMPM/2 MPU-401 SUPPORT
  3.  
  4.      This package contains the following:
  5.  
  6.   o    MPU401.SYS        The actual device driver
  7.   o    TIMER0.SYS        The highres timer driver
  8.   o    CLOCK01.SYS       New ISA clock driver that supports the highres timer
  9.   o    CLOCK02.SYS       New MCA clock driver that supports the highres timer
  10.   o    MPU401.SCR        MMPM/2 Install script
  11.   o    MPURES.DLL        MMPM/2 Resource DLL
  12.   o    CARDINFO.DLL      MMPM/2 Resource DLL
  13.   o    CONTROL.SCR       MMPM/2 Install script
  14.   o    MIDIPLAY.ICO      MMPM/2 installation icon
  15.   o   This README file, which is formatted for viewing
  16.       on your screen.  You can:
  17.  
  18.       -   Use the Table of Contents to
  19.           help you locate specific topics.
  20.       -   Use the Find option in the Edit menu of the
  21.           OS/2 System Editor to help you locate
  22.           specific information.
  23.       -   Print the file.
  24.  
  25.  
  26.   IMPORTANT
  27.  
  28.   PLEASE READ THE FOLLOWING TERMS AND CONDITIONS.  YOUR
  29.   USE OF THE OS/2 DEVICE DRIVER FOR MMPM/2 MPU-401 SUPPORT
  30.   INDICATES YOUR ACCEPTANCE OF THE FOLLOWING
  31.   TERMS AND CONDITIONS:
  32.  
  33.   o   YOU MUST BE A LICENSEE OF OS/2.
  34.   o   YOU MAY MAKE COPIES OF THE OS/2 DEVICE DRIVER FOR
  35.       MMPM/2 MPU-401 SUPPORT EQUAL TO THE
  36.       NUMBER OF LICENSED COPIES OF OS/2 YOU POSSESS.
  37.   o   ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2
  38.       LICENSE AGREEMENT APPLY TO THIS OS/2 DEVICE
  39.       DRIVER FOR MMPM/2 MPU-401 SUPPORT;
  40.       HOWEVER, THIS DOES NOT EXTEND ANY WARRANTY
  41.       OUTLINED IN SUCH AGREEMENT.
  42.  
  43.  
  44.   CONTENTS
  45.   ________
  46.  
  47.  
  48.            1.0  Supported Features
  49.  
  50.            2.0  Compatibility
  51.  
  52.            3.0  Preliminary Steps
  53.  
  54.            4.0  Installation from Diskette
  55.  
  56.            5.0  Optional Command-line Parameters
  57.  
  58.            6.0  Bugs
  59.  
  60.            7.0  Trademarks
  61.  
  62.  
  63.  1.0  SUPPORTED FEATURES
  64.   __________________
  65.  
  66.       This file describes the installation of the MMPM/2 MPU-401 device 
  67.       driver, MPU401.SYS, and related files.  This driver uses the new 
  68.       highres timer driver, TIMER0.SYS.
  69.  
  70.       The MPU-401 driver is actually a dual-function driver, as it supports 
  71.       both MMPM/2 and the new real-time MIDI subsystem.  Therefore, some of 
  72.       the command-line parameters may have limited or no functionality when 
  73.       taken in the context of MMPM/2 only.
  74.  
  75.    The MMPM/2 MPU-401 driver has the following functions:
  76.  
  77.  
  78.      1. Uses the highres timer driver to provide 1-millisecond accuracy, the
  79.         highest of any MMPM/2 MIDI driver.  A command-line parameter allows
  80.         selecting a lower frequency if necessary.
  81.  
  82.      2. Supports up to 8 events independent events, including the new
  83.         recurring events.
  84.  
  85.      3. Performs autodetection of MPU-401 hardware.  Can support up to 9
  86.         MPU-401's (although MMPM/2 only recognizes 1)
  87.  
  88.      4. Automatically uses the 32ms system timer if the highres timer driver
  89.         is not found.  Timing is reasonably accurate at 32ms.
  90.  
  91.  
  92.  2.0 COMPATIBILITY
  93.   _____________
  94.  
  95.   This graphics accelerator driver is compatible with
  96.   OS/2 Warp 3.
  97.  
  98.  3.0  PRELIMINARY STEPS
  99.   _________________
  100.  
  101.   If there are any copies of CLOCK01.SYS and CLOCK02.SYS in the 
  102.   x:\os2 (where x is the boot drive) directory, delete them.
  103.  
  104.   Be sure that CLOCK01.SYS and CLOCK02.SYS are not marked as READONLY.
  105.   To remove the READONLY attributes, use the attrib command such as 
  106.   attrib -r x:\os2\boot\clock0*.sys, where x is the boot drive.
  107.  
  108.  
  109.  4.0 INSTALLATION
  110.   _________________
  111.  
  112.   Unzip the files (or insert the disk), run MINSTALL, and change the directory
  113.   to point to where the files are located.
  114.  
  115.   MINSTALL will ask how many MPU-401's are installed.  Always answer with 1.
  116.  
  117.   5.0 Optional Command-line Parameters
  118.   _________________
  119.  
  120.   The driver attempts to detect the base I/O ports and IRQ's during boot
  121.   time.  The first valid port that it finds is the one that it uses.  In
  122.   most cases, command-line parameters will not be required.  The driver
  123.   currently only supports one MPU-401 when used with MMPM/2.
  124.  
  125.   Autodetect first looks at address 0x330 and then 0x300.  If used on a
  126.   Microchannel machine, 0x1330 is also checked.
  127.  
  128.   Alternatively, command-line parameters can be used to tell the driver to
  129.   skip the autodetect and use given I/O ports and IRQ's instead.  Up to
  130.   9 MPU-401's, numbered 1 to 9, can be supported this way.  MPU-401 #1
  131.   is the one that MMPM/2 uses.
  132.  
  133.   Parameters are in the format of:
  134.  
  135.        DEVICE=MPU401.SYS /xn:yyy /xn:yyy ...
  136.  
  137.         Where 'x' is a single capital letter, 'n' is from 1 to 9, and 'yyy' is 
  138.         the option.
  139.  
  140.         /Pn:yyy  Base I/O: Sets the base I/O address for port n, usually 300 
  141.                  or 330 (# is in hex)
  142.  
  143.         /In:yyy  IRQ level: Sets the IRQ level for port n.  yyy is a decimal 
  144.                  number from 1 to 15.  If the base I/O address for a given 
  145.                  port is specified (e.g. /P1:300), but the IRQ is _not_ 
  146.                  specified, the driver will attempt to autodetect the IRQ.  
  147.                  Note that an IRQ is not used for MMPM/2 playback anyway.
  148.  
  149.         /N:sss   Driver name, an 8-character length string, ending in a $.  
  150.                  Do not specify a port number.  Default is "MPU401$".
  151.  
  152.         /R:yyy   Resolution of MMPM/2 timing.  If the highres timer 
  153.                  (TIMER0.SYS) is installed, this parameter tells the MPU-401 
  154.                  driver what resolution to use (where yyy is the number of 
  155.                  milliseconds) when playing MMPM/2 MIDI streams.  Default is 
  156.                  one millisecond.
  157.  
  158.         /V       Verbose output during boot.  If used, this should be the 
  159.                  first parameter.
  160.  
  161.  
  162.  6.0 Bugs
  163.  _______
  164.  
  165.   The Resource Manager is not used, and therefore autodetect could trample
  166.   on other hardware.
  167.  
  168.   There seems to be a bug in MMPM/2's AUDIO_CAPABILITY code, and therefore
  169.   this driver doesn't use that feature.
  170.      
  171.  
  172.  
  173.  7.0  TRADEMARKS
  174.    __________
  175.  
  176.   The following terms, denoted by an asterisk (*) in
  177.   this file, are trademarks or registered trademarks of
  178.   IBM Corporation in the United States and/or other
  179.   countries:
  180.  
  181.     IBM
  182.     OS/2
  183.  
  184.      
  185.   IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR
  186.   IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED
  187.   WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
  188.   MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN
  189.   THIS DOCUMENT.  BY FURNISHING THIS DOCUMENT, IBM
  190.   GRANTS NO LICENSES TO ANY RELATED PATENTS OR
  191.   COPYRIGHTS.
  192.      
  193.   THIS DRIVER IS COPYRIGHTED BY INTERNATIONAL BUSINESS
  194.   MACHINES CORPORATION.  ALL APPROPRIATE RESTRICTIONS
  195.   APPLY.
  196.      
  197.                                 (End of Document)
  198.