home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 035 / ultra06a.zip / ultradd.doc < prev    next >
Text File  |  1994-11-18  |  11KB  |  298 lines
  1. Unofficial Advanced Gravis Ultrasound Drivers #2 ("Manley Drivers")
  2. Copyright 1994 Robert J. Manley and Multi-Player Computer Adventures
  3. Version 0.6a - SHAREWARE - please read the REGISTRATION section for details
  4.  
  5. FEATURES
  6.  
  7.     - basic GUS rev 3.7 and MAX/daughtercard mixer support
  8.     - 8 or 16 bit wavefile playback
  9.     - mono or stereo
  10.     - hardware MIDI playback (to an external synth or synth module)
  11.     - volume and balance control
  12.     - multi-session (many registered streams - one active)
  13.     - Ultrasound specific OS/2 VDD giving DOS sessions:
  14.       - reduced interrupt latency
  15.       - hardware virtualization
  16.       - MIDI port emulation of Roland MPU-401 in UART mode
  17.         (allowing WinOS2 to load and use those drivers - hooray!)
  18.       - GM emulation for DOS and Windows sessions under OS/2 with
  19.         the goody pack which is only sent to registered users
  20.     - absolute lowest system overhead possible
  21.     - rigorous testing
  22.  
  23.  
  24. Here is what it has been tested and known to work with:
  25.  
  26.     - OS/2 2.1 with MMOS2 CSD, OS/2 2.11 (with its MMOS2 CSD), Warp!
  27.     - system sounds
  28.     - digital audio applet
  29.     - MIDI applet
  30.     - compact disc applet and CD explorer (bug in version 2.3 hangs
  31.       PM message queue when using digital transfer)
  32.     - bigben2
  33.     - dmplayer 1.01
  34.     - video player / Ultimotion
  35.     - wave doctor
  36.     - multimedia mahjongg
  37.     - GUSmixer (even while the device is in use!)
  38.     - play.cmd (thanks to TFS for reminding me about this one)
  39.     - WinOS2 apps
  40.       - media player
  41.       - Cakewalk Pro
  42.       - Midisoft Recording studio
  43.  
  44.  
  45. INSTALLATION
  46.  
  47. *** STEP #1 ***
  48. This driver requires one of the following to be installed:
  49.  
  50.     - OS/2 Warp (with MMOS2 installed) Beta I, Beta II, or GA
  51.     - OS/2 2.11 MMOS2 from either
  52.         - OS/2 2.11 refresh package
  53.         - OS/2 2.1 + Feb '94 Service Pack (== OS/2 2.11)
  54.     - OS/2 2.1 MMOS2 + November '93 MMOS2 CSD
  55.       (ftp-os2 in pub/os2/ibm/os2fixes as MMPMCS.DSK)
  56.  
  57. If neither of these versions of MMOS2 can be found, the installation will
  58. fail and nothing will be added to your CONFIG.SYS.
  59.  
  60. *** STEP #2 ***
  61. Use an OS/2 based unzip program (e.g. Info-Zip's) to unpack ULTRA05E.ZIP to a
  62. directory on your hard disk or floppy.  From that directory, run "MINSTALL",
  63. accept it as the source, and then proceed with the installation.  The following
  64. lines will be appended to your CONFIG.SYS:
  65.  
  66.     DEVICE=<drive>:\MMOS2\ULTRADD.SYS /B:b /C:c /D:d /U:u /M:m /V
  67.     DEVICE=<drive>:\MMOS2\ULTRAVDD.SYS
  68.  
  69. where (with defaults):
  70.  
  71.     b - base I/O address of Ultrasound (220)
  72.     c - base address of 16-bit CODEC (32C)
  73.     d - DMA channel for playback (7)
  74.     u - GF1 IRQ (12)
  75.     m - MIDI IRQ (5)
  76.  
  77. If you have a 16-bit daughtercard, you must manually change the address (in
  78. hex) following the /C: switch to the base address for that board.  The valid
  79. addresses for the daughtercard are: 530, 604, E80, and F40.  You may install
  80. this software over a previous version without first uninstalling.  Also note
  81. that the driver can be UNINSTALLED by selecting the number of Ultrasounds to
  82. install as zero.
  83.  
  84. *** IMPORTANT STEP #3 (NEW) ***
  85. If you have previously installed an earlier version of this driver since
  86. installing your current system, you must read this step carefully and follow
  87. all instructions.  There is a limitation in the MMOS2 installation program
  88. which forces the user to manually edit the CONFIG.SYS.  After installing this
  89. software, search for a line containing the token "AUDIOVDD" such as the
  90. following:
  91.  
  92.     DEVICE=<drive>:\MMOS2\AUDIOVDD.SYS ULTRA1$
  93.  
  94. If this line is present as shown here, comment it out with a REM statement at
  95. the beginning.  If you have another OS/2 supported soundcard installed and
  96. this line contains other tokens (e.g. "PAS161$"), try these two things in
  97. order of preference:
  98.  
  99.     1. delete just the "ULTRA1$" token from this line and install
  100.     2. after installing this software and experiencing problems with
  101.        GUS sound in DOS boxes, put back the "ULTRA1$" token and REM
  102.        out the ULTRAVDD.SYS line.  Sorry, no emulations for you.
  103.  
  104. If I had more than one soundcard installed, I could check this but I don't :(.
  105.  
  106.  
  107. HARDWARE EMULATIONS
  108.  
  109. In addition to virtualizing the Ultrasound I/O ports to DOS sessions, the
  110. supplied OS/2 virtual device driver (VDD) ULTRAVDD.SYS also emulates the
  111. following devices when selected in the AUDIO_ADAPTER_EMULATION DOS setting:
  112.  
  113.     - Roland MPU-401 MIDI interface in UART mode (e.g. Windows).
  114.       Select I/O address of 0x330 and IRQ of 2/9 (not used yet).
  115.       MIDI is re-routed through the GUS MIDI port to an external synth
  116.       (not played natively as in MegaEm).
  117.  
  118. **** NOTE: native DOS GM emulation is now done! (like MegaEm for OS/2)
  119. **** Register this software and get the files required to enable this
  120. **** functionality by e-mail or if neccessary, ground mail
  121.  
  122. Future directions are to add Sound Blaster and enhance Roland emulation.
  123.  
  124. Please note that neither SBOS or MegaEm should be run under an OS/2 DOS
  125. box.  These programs require features of the 386 that cannot be granted
  126. to a VDM under a protect mode OS without comprimising system integrity.
  127.  
  128.     UNDER NO CIRCUMSTANCES SHOULD SBOS or MEGAEM BE RUN!
  129.  
  130.  
  131. WinOS2 CONFIGURATION
  132.  
  133. It is recommended that all WinOS2 users keep a separate copy of their
  134. SYSTEM.INI and CONTROL.INI files for real Windows and WinOS2.  Doing this
  135. will allow the Gravis supplied Windows drivers to work while under real
  136. Windows and these drivers to provide MPU-401 emulation under WinOS2.  A
  137. good system to use is to copy each of these files to another with the same
  138. filename root but with the extension ".DOS" after a successful run of real
  139. Windows.  Do the same with the extension ".OS2" after running this
  140. setup without problems.  Before starting either system, copy the OS specific
  141. versions over their proper files.  PLEASE BE CAREFUL with this and take the
  142. time to understand what you are actually doing!
  143.  
  144. These are the lines in your real Windows SYSTEM.INI to comment out with a
  145. ';' character at the beginning to disable Gravis' drivers and avoid that
  146. stupid error message listed in the QUESTIONS section below:
  147.  
  148.     device=grvsultr.386
  149.     midi=ultrasnd.drv
  150.     ...
  151.     midi1=ultmport.drv
  152.     wave=ultrasnd.drv
  153.     AUX=ultrasnd.drv
  154.     mixer=ultrasnd.drv
  155.  
  156. These are the lines in your CONTROL.INI file to do the same with:
  157.  
  158.     ultmport.drv=UltraSound MIDI Port
  159.     ultrasnd.drv=Ultra Wave and MIDI Synth
  160.     ...
  161.     midi=ultrasnd.drv
  162.     midi1=ultmport.drv
  163.     wave=ultrasnd.drv
  164.     AUX=ultrasnd.drv
  165.  
  166. After installing the Roland drivers (inside WinOS2), create a new MIDI
  167. Mapper setup called "UltraVDD" by selecting "New" inside that application.
  168. Now select the newly installed Roland MPU-401 device as the destination
  169. port for all MIDI channels and then click on "OK" to complete the setup.
  170.  
  171. If you are running full OS/2 (with IBM's WinOS2), you may wish to copy
  172. the TIMER.DRV from your real Windows SYSTEM directory to the equivalent
  173. WinOS2 directory after renaming the original.  This driver seems to give
  174. more accurate MIDI timing for Windows based MIDI sequencers.
  175.  
  176.  
  177. KNOWN BUGS AND LIMITATIONS
  178.  
  179.  - moving Ultimotion window can generate noise or loss of sound
  180.    (this seems to be fixed in Warp)
  181.  - the Digital Audio, MIDI, and Digital Video icons in the multimedia folder
  182.    are replaced with incorrect versions (these can be easily changed back
  183.    manually)
  184.  - the installation program is lacking in functionality (see STEP #3 in the
  185.    INSTALLATION section)
  186.  - MPU-401 interrupt driven recording isn't working yet (booo, hiss)
  187.  - no text in Description field for AUDIO_ADAPTER_EMULATION property
  188.    (this is a VDM limitation of OS/2 on Intel platform)
  189.  
  190.  
  191. MOST COMMONLY ASKED QUESTIONS
  192.  
  193. Q. Why don't I hear anything when using the MIDI applet?
  194. A. If you don't have a MIDI synth connected, you won't.
  195.  
  196. A. Why don't I hear anything when using WinOS2 MIDI applications?
  197. A. If you don't have a MIDI synth connected, you won't.
  198. A. If you do, check the WinOS2 CONFIGURATION section above.
  199.  
  200. Q. Why is there a delay before hearing a system sound?
  201. A. OS/2 must swap out blocks of memory to give the MMOS2 subsystem the
  202.    storage that it needs for holding the sound sample.  When enough memory
  203.    is already free (such as immediately after a system sound), the delay
  204.    should be almost unnoticeable.
  205.  
  206. Q. Why do I get the error message "The Ultrasound driver requires enhanced
  207.    mode to run" when trying to start a full-screen WinOS2 session?
  208. A. Gravis' drivers include a Windows Virtual Device Driver (VxD != OS/2 VDD)
  209.    which cannot be loaded by OS/2 for system integrity reasons.  When the
  210.    load fails, WinOS2 (and Windows) interpret this error as the system not
  211.    running in 386 enhanced mode since that is the mode required for loading
  212.    and using VxDs.
  213.  
  214. Q. Why do my seamless WinOS2 sessions just sit there and never start?
  215. A. See Q and A above.  When the VxD load fails, WinOS2 can't continue nor
  216.    can it properly exit.  Use a session killer like Watchcat to kill it.
  217.  
  218. Q. Why doesn't SBOS or MegaEm work?
  219. A. Please read the HARDWARE EMULATIONS section.
  220.  
  221.  
  222. LEGALESE
  223.  
  224. This software is provided AS IS.  No warranty of any kind, expressed or
  225. implied, is granted including any warranties of quality or fitness for
  226. a particular purpose.  Under no circumstances will either Robert J. Manley
  227. or Multi-Player Computer Adventures be held responsible for any damage
  228. that results directly or indirectly from the use of this product.
  229.  
  230.  
  231. REGISTRATION
  232.  
  233. Please fill in the following information and send it along with a cheque
  234. or money order for $25.00 US or CAN (we need the break) to:
  235.  
  236.     Multi-Player Computer Adventures
  237.     14845-6 Yonge Street, Box 314
  238.     Aurora, Ontario, Canada
  239.     L4G 6H8
  240.  
  241.    Name: __________________________________________________
  242.  
  243. Company: __________________________________________________
  244.  
  245. Address: __________________________________________________
  246.  
  247.        : __________________________________________________
  248.  
  249.        : __________________________________________________
  250.  
  251.  e-mail: __________________________________________________
  252.  
  253.   phone: __________________________________________________
  254.  
  255. Price includes 7% GST for Canadians and 8% PST for residents of Ontario.
  256. Some future versions of this product may only be distributed commercially
  257. but will be sent free to all registered users.
  258.  
  259.  
  260. BUG REPORTS
  261.  
  262. Please send all bug reports, gratuitous worship, whatever, to me through
  263. e-mail at: rjm@dretor.dciem.dnd.ca.  I enjoy hearing from all users.
  264.  
  265.       Problem symptom: _____________________________________________
  266.  
  267.     Fix or workaround: _____________________________________________
  268.  
  269.          OS/2 version: ______
  270.  
  271. GUS hardware revision: ___
  272.  
  273.   Daughtercard? (y/n): _
  274.  
  275.  External MIDI? (y/n): _
  276.  
  277.            GUS memory: ____ K
  278.  
  279.         System memory: __ M
  280.  
  281.  
  282. WHAT'S NEXT
  283.  
  284.     - Roland GM emulation to DOS sessions
  285.     - Sound Blaster emulation to DOS sessions
  286.     - MIDI synth
  287.     - Digital Audio recording
  288.     - multi-track mod support at the driver level (need help here)
  289.     - getting Advanced Gravis to licence this software from me
  290.  
  291.  
  292. FINALLY
  293.  
  294. I cannot emphasize enough my thanks to Brent Davis and especially Linden
  295. deCarmo who have provided invaluable information when I needed it most.
  296.  
  297. Enjoy.  Robert.
  298.