This file describes how to set up your sound card to work with TuneBuilder.
Even though the installation program will make all necessary changes for you,
the information is provided here so that you can change your system settings
later if you wish.

Sound cards:
--------------
 1. Sound Blaster
 2. Adlib
 3. Media Vision
 4. Covox
 5. Advanced Gravis UltraSound
 6. (others)

(Note: The list of sound cards supported by TuneBuilder is subject to change.)


Before Installing TuneBuilder:
------------------------------
- If you have a SoundBlaster card, make sure it is installed and working
  properly. The installation software for your Sound Blaster card should
  automatically set an environment variable called BLASTER in your
  AUTOEXEC.BAT file.

- If you have a Media Vision card, the installation software for your sound
  card should automatically put a device called MVSOUND.SYS in your CONFIG.SYS
  file. You should check that your sound card in working properly

- For Covox cards, no action is required other than making sure your sound
  card works properly

- For Adlib cards, the installation software for your sound card should
  automatically set up the environment variables GOLD and GOLDPATH in your
  AUTOEXEC.BAT file.


Detailed Setup information
----------------------------
1. For Sound Blaster cards, you will need 2 of the following drivers:

    CTMMSYS.SYS         - Creative Multimedia System driver.
    CTSB16.SYS          - SB16 hardware dependent driver.
    CTSBPRO.SYS         - SBPRO and SBPRO2 hardware dependent driver.
    CTSB2.SYS           - SB2.0 hardware dependent driver.
    CTSB.SYS            - SB or lower version hardware dependent driver.

 * If you use the Sound Blaster AWE-32, use the version of CTMMSYS.SYS,
   CSP.SYS, and CTSB16.SYS that came with your card rather the SB16 versions
   listed above. They should have been automatically installed when you
   installed your sound card.

   Add the appropriate lines to your CONFIG.SYS file based on your card
   type. Of course, if your settings are not at the factory defaults given
   in the examples below, change the appropriate values in the lines you
   add to your CONFIG.SYS file to match your actual hardware settings.

   For Sound Blaster 16 card :
   DEVICE=C:\TBUILDER\DRV\CTSB16.SYS /UNIT=0 /BLASTER=A:220 I:5 D:1 H:5
   DEVICE=C:\TBUILDER\DRV\CTMMSYS.SYS

   For Sound Blaster Pro and Pro 2 cards :
   DEVICE=C:\TBUILDER\DRV\CTSBPRO.SYS /UNIT=0 /BLASTER=A:220 I:5 D:1
   DEVICE=C:\TBUILDER\DRV\CTMMSYS.SYS

   For Sound Blaster 2.0 card :
   DEVICE=C:\TBUILDER\DRV\CTSB2.SYS /UNIT=0 /BLASTER=A:220 I:5 D:1
   DEVICE=C:\TBUILDER\DRV\CTMMSYS.SYS

   For Sound Blaster 1.0 and below cards :
   DEVICE=C:\TBUILDER\DRV\CTSB.SYS /UNIT=0 /BLASTER=A:220 I:5 D:1
   DEVICE=C:\TBUILDER\DRV\CTMMSYS.SYS

   Note that this /BLASTER= setting and the BLASTER= environment
   string in your AUTOEXEC.BAT file must match. For the /UNIT=x
   setting, you should increase x by one if you have another hardware
   dependent driver (e.g., CTSBPRO.SYS) installed. The BLASTER environment
   variable is set automatically when you install your Sound Blaster card
   software. For further information, refer to your sound card user's
   manual.

   If you run DOS 5.0 or higher, the drivers can be safely loaded into
   upper memory. If you have MS-DOS 6.x, then you can use the MEMMAKER
   utility to automatically optimize your memory for you.

   There are several programs supplied with the Sound Blaster cards that you
   can use to make sure your card is installed and working properly, such
   as TEST-SBP.EXE, TESTSB16.EXE, WPLAY.EXE, VPLAY.EXE, PLAY.EXE, etc.

   Also, for non-Sound Blaster sound cards that provide "Sound Blaster
   Compatibility", this usually means that they emulate a Sound Blaster 1.5,
   or in some cases Sound Blaster 2.0 or Sound Blaster Pro. Some cards emulate
   a Sound Blaster card in hardware, while others emulate it in software only.
   Depending on the degree of compatibility, TuneBuilder may not work properly
   or at all with some of these cards if a Sound Blaster sound card is chosen
   under the 'Preferences' window in TuneBuilder.

2. For Adlib Gold 1000/2000 cards:

   Before running TuneBuilder, the following drivers must be loaded. They
   can be run either from the command line, or can be put in your AUTOEXEC.BAT
   file. You should also have a copy of the same drivers in your \GOLD\DRIVERS
   directory that was created when you installed your sound card software.
   Example:

   C:\TBUILDER\DRV\CTRLDRV.EXE
   C:\TBUILDER\DRV\WAVEDRV.EXE

   If you get a warning message from EMM386 while running TuneBuilder,
   you may need to add the option D=64 on the line for EMM386.EXE in your
   CONFIG.SYS file. Example:

   DEVICE=C:\MSDOS\EMM386.EXE D=64

   You can use the programs PLAYDIGI.EXE and TESTGOLD.EXE supplied with
   your sound card to make sure your card is working properly.

3. For Media Vision cards, make sure the MVSOUND.SYS driver supplied
   with your card is installed in your CONFIG.SYS file. For example, for
   a Media Vision Pro AudioSpectrum 16 card, set at DMA 5, IRQ 5, with
   Sound Blaster emulation, MIDI port, and joystick disabled:

   DEVICE=C:\PROAUDIO\MVSOUND.SYS d:5 q:5 s:0 m:0 j:0

 * Note: If you have a Pro AudioSpectrum 16 or Spectrum/CDPC, TuneBuilder will
   use 16-bit sound data. In order for your card to be able to play 16-bit
   data correctly, you must have your card set to use DMA channel 5,6, or 7.
   Otherwise, you will not hear anything. For 8-bit sound, use DMA channels
   1,3, or 5. Refer to the user manual for your card for more specific
   information. You can use the programs PLAYFILE.EXE, CUSDIAG.EXE, etc.
   supplied with your card to make sure your sound card is working properly.

4. For Covox Sound Master II and Voice Master Key (internal) cards, no
   external drivers are required. Use the SAY.EXE program supplied with your
   card to make sure it is working properly. TuneBuilder requires you to
   set an environment variable specifying the address, IRQ, and DMA channel
   that your card is set to. For example, with a Covox card set to digitizer
   port 220h, using IRQ 5 and DMA channel 1, you would set the envirmonent
   variable COVOX by adding the following line to your AUTOEXEC.BAT file:

   SET COVOX=A220 D1 I5

   Note that there are no spaces around the equals sign.

5. For Advanced Gravis UltraSound cards, the following lines must be added
   to your AUTOEXEC.BAT file. For example, for a card set to address 220h,
   IRQ 12, DMA 5, the entries would be similar to:

   SET ULTRASND=220,5,5,12,5
   SET ULTRADIR=C:\ULTRASND
   SET GUSMOD=C:\ULTRASND\MOD
   C:\ULTRASND\ULTRINIT.EXE -dj

   For more detailed information, refer to the owners manual for your sound
   card. You can use the program PLAYFILE.EXE in the ULTRASND directory
   to make sure your card is working properly.

6. Any other sound cards in the list of supported sound cards use the drivers
   HMIDET.DRV and HMIDRV.DRV. TuneBuilder will load them automatically
   and you do not need to worry about them.
