SCI0 - SOUNDBLASTER SETUP TOOLS
================================
Copyright (c) 2026 Calderona Games.


OVERVIEW
--------
This package contains two utilities for configuring the SoundBlaster
driver used by SCI0. Before playing the game for the first time you
must run SETUP.COM to configure the driver for your sound card.


FILES INCLUDED
--------------
SETUP.COM     - SoundBlaster configuration utility. Run this before
                playing the game. Must be in the same directory as
                SNDBLAST.DRV.

DETECT.COM    - Standalone SoundBlaster detection utility. Run this
                to identify your card type, IO base, IRQ and DMA
                channel without making any changes to the driver.

README.TXT    - This file.

SNDBLAST.DRV  - SCI0 SoundBlaster Driver


REQUIREMENTS
------------
  DOS 3.0 or later
  8086 processor or better
  A SoundBlaster compatible sound card


SETUP INSTRUCTIONS
------------------
1. Copy SETUP.COM and SNDBLAST.DRV to the same directory.

2. Run SETUP.COM:

     SETUP

3. SETUP will automatically scan IO ports 210h through 270h for
   a SoundBlaster card and detect its IO base address, IRQ and
   DMA channel.

4. The detected settings will be displayed:

     SoundBlaster detected!
     IO Base  : 220
     IRQ      : 5
     DMA      : 1
     Card     : Sound Blaster 2.0 (Enhanced)

5. If the settings are correct press Y to apply them.

6. If the settings are wrong press N to enter them manually.
   Valid IO base values  : 210, 220, 230, 240, 250, 260, 270
   Valid IRQ values      : 2, 3, 5, 7, 10, 11, 12
   Valid DMA values      : 0, 1, 3

7. SETUP will patch SNDBLAST.DRV with your settings and display:

     Done! SNDBLAST.DRV has been updated.
     Restart the game for changes to take effect.

8. SETUP.COM can be run multiple times. If you change your sound
   card configuration simply run SETUP again and it will update
   SNDBLAST.DRV with the new settings.


SUPPORTED SOUND CARDS
---------------------
  Sound Blaster 1.x / 1.5
  Sound Blaster 2.0
  Sound Blaster 2.0 Enhanced
  Sound Blaster Pro
  Sound Blaster 16
  Sound Blaster AWE32
  Sound Blaster AWE64


IMPORTANT - IRQ 11 AND IRQ 12 LIMITATION
-----------------------------------------
The Sound Blaster 16, AWE32 and AWE64 use a hardware chip called
the CT1745 mixer to store their IRQ setting. This chip only supports
four IRQ values:

  IRQ 2, IRQ 5, IRQ 7, IRQ 10

IRQ 11 and IRQ 12 are not standard Sound Blaster 16 IRQ settings.
The CT1745 mixer chip cannot report these IRQ values and therefore
SETUP cannot auto-detect them.

If your Sound Blaster 16 is configured for IRQ 11 or IRQ 12 you
will see:

  IRQ : Not detected

In this case press N at the confirmation prompt and enter your IRQ
manually. SETUP will accept IRQ 11 and IRQ 12 as manual entries
and will patch the driver correctly.

Creative Labs document IRQ 2, 5, 7 and 10 as the recommended IRQ
settings for the Sound Blaster 16. If you continue to have problems
with IRQ 11 or 12 consider reconfiguring your card to use IRQ 5 or
IRQ 10 using your Plug and Play configuration utility.


NO SOUND CARD DETECTED
-----------------------
If SETUP cannot find a SoundBlaster card it will display:

  WARNING: No SoundBlaster detected.
  Patching is not recommended without a detected card.

This can happen if:
  - No SoundBlaster card is installed
  - The card is configured for a non-standard IO address
  - The card drivers have not been loaded
  - The BLASTER environment variable is not set

If you know your card settings you may still press N to enter them
manually, but this is not recommended unless you are certain the
settings are correct.


DETECT.COM USAGE
----------------
DETECT.COM scans for SoundBlaster hardware and displays what it
finds without making any changes to SNDBLAST.DRV. Run it to
verify your card is being detected correctly before running SETUP.

     DETECT

DETECT supports the same IRQ limitation as SETUP described above.
IRQ 11 and 12 will show as Not detected on Sound Blaster 16 cards
unless the card has been initialised by DIAGNOSE.EXE or CTCU.EXE.


TROUBLESHOOTING
---------------
Game has no sound after running SETUP:
  - Verify your BLASTER environment variable matches your card
    settings e.g. SET BLASTER=A220 I5 D1 H1 T3
  - Run DETECT.COM to confirm the card is detected correctly
  - Run SETUP again and verify the settings before confirming

Game locks up or crashes:
  - The IRQ setting may be wrong. Run SETUP and check the IRQ
    matches your card jumper or Plug and Play configuration.
  - Try a different IRQ setting if the detected one is wrong.

SETUP reports ERROR: SNDBLAST.DRV not found:
  - Ensure SETUP.COM and SNDBLAST.DRV are in the same directory.
  - Run SETUP from the game directory.


TECHNICAL NOTES
---------------
SETUP.COM patches the following locations in SNDBLAST.DRV:

  IO Base  : file offset 0025h (2 bytes, little-endian word)
  IRQ      : file offsets 250Eh, 2519h, 266Ah, 2688h (4 bytes)
  DMA      : file offsets 25B5h, 25C3h, 25C7h, 25CBh,
             25CFh, 25D3h, 25D5h (7 bytes)

The driver file size is 11,296 bytes (2C20h). Any other version
of SNDBLAST.DRV may have different patch locations and must not
be used with this version of SETUP.COM.