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