This commit was generated by cvs2svn to track changes on a CVS vendor

[unix-history] / sys / i386 / doc / sound.doc

diff --git a/sys/i386/doc/sound.doc b/sys/i386/doc/sound.doc
index 7f5b9da..3e1df27 100644 (file)
--- a/sys/i386/doc/sound.doc
+++ b/sys/i386/doc/sound.doc
@@ -1,23 +1,49 @@
-To enable sound card support, you need to add one or more of the following
-lines to your kernel configuration file:
-
-device snd5 at isa? port 0x330 irq 6 drq 0 vector mpuintr
-device snd4 at isa? port 0x220 irq 15 drq 6 vector gusintr
-device snd3 at isa? port 0x388 irq 12 drq 3 vector pasintr
-device snd2 at isa? port 0x220 irq 7 drq 1 vector sbintr
-device snd1 at isa? port 0x388 irq 0 drq 0 vector sbintr
-
-      Unit numbers are:
-                1 for Yamaha FM synth
-                2 for SB/SB Pro DSP
-                3 for PAS PCM and Midi
-                4 for GUS
-                5 for MPU-401
-
-      If you have ProAudioSpectrum, uncomment units 3 and 2.
-      If you have SoundBlaster, uncomment 2 and 1.
-      If you have GravisUltrasound, uncomment 4
-      If you have MPU-401, uncomment 5
+NOTE! Check that there is no #define EXCLUDE_<cardname> lines for
+      the cards you are configuring in the sound/local.h. Otherwise
+      the low level driver for the card is not compiled in the kernel.
+You may add one or more of the following depending on what you do NOT
+want compiled into your kernel.  Only use the options for which you
+do NOT have a card to support it, or if you do not want a particular
+functionality.
+
+      options         "EXCLUDE_MPU401"        # NO MPU401 support
+      options         EXCLUDE_GUS             # NO GUS support
+      options         EXCLUDE_SBPRO           # NO SB Pro support
+      options         EXCLUDE_SB16            # NO SB 16 support
+      options        EXCLUDE_YM3812          # NO SB AdLib support
+      options         EXCLUDE_PAS             # NO Pro Audio Studio support
+      options         EXCLUDE_PRO_MIDI        # NO PAS MIDI support
+      options        EXCLUDE_MIDI            # NO MIDI support whatsoever
+
+To enable sound card support, you need to uncomment and add one or more of 
+the following lines to your kernel configuration file according to the
+directions below:
+
+#device snd5 at isa? port 0x330 irq 6 drq 0 vector mpuintr
+#device snd4 at isa? port 0x220 irq 15 drq 6 vector gusintr
+#device snd3 at isa? port 0x388 irq 10 drq 6 vector pasintr
+#device snd2 at isa? port 0x220 irq 7 drq 1 vector sbintr
+#device snd6 at isa? port 0x220 irq 7 drq 5 vector sbintr
+#device snd7 at isa? port 0x300 irq 7 drq 0 vector sbintr
+#device snd1 at isa? port 0x388 irq 0 drq 0 vector sbintr
+
+       Unit numbers are:
+                 1 for Yamaha FM synth
+                 2 for SB/SB Pro DSP
+                 3 for PAS PCM and Midi
+                 4 for GUS
+                 5 for MPU-401 (there is separate driver for the SB16)
+                 6 for SB16 (DSP)
+                 7 for SB16 Midi (MPU-401 emulation)
+
+       If you have ProAudioSpectrum, uncomment units 3, 2 and 1
+       If you have SoundBlaster 1.0 to 2.0 or SB Pro, uncomment 2 and 1.
+       If you have SoundBlaster 16, uncomment 2, 1, 6 and 7.
+       (use the same IRQ for the cards 2, 6 and 7. The DMA of the
+       card 2 is the 8 bit one and the DMA of the card 6 is the 16 bit one.
+       the port address of the card 7 is the Midi I/O address of the SB16.
+       If you have GravisUltrasound, uncomment 4
+       If you have MPU-401, uncomment 5

 
 NOTE:  The MPU-401 driver may or may not work, and is unfortunately
 unverifiable since no one I know has one.  If you can test this,
 
 NOTE:  The MPU-401 driver may or may not work, and is unfortunately
 unverifiable since no one I know has one.  If you can test this,


@@ -27,12 +53,17 @@ Please check your documentation (or verify with any provided DOS utilities
 that may have come with your card) and set the IRQ or address fields
 accordingly.
 
 that may have come with your card) and set the IRQ or address fields
 accordingly.
 

-

 Also:  Some systems with the OPTI chipset will require you to #define
 BROKEN_BUS_CLOCK in /sys/i386/sound/pas2_card.c.  Symptoms are that
 you will hear a lot of clicking and popping sounds, like a geiger counter,
 coming out of the PAS even when is not playing anything.
 
 Also:  Some systems with the OPTI chipset will require you to #define
 BROKEN_BUS_CLOCK in /sys/i386/sound/pas2_card.c.  Symptoms are that
 you will hear a lot of clicking and popping sounds, like a geiger counter,
 coming out of the PAS even when is not playing anything.
 

-
+Probing problems:  Since the SB16 uses the same IRQ and addresses for
+the different drivers, some of the snd dirvers will not be probed because
+the kernel thinks there is a conflict.  Until a real solution is implemented,
+to get all the snd drivers to work, immediately return(0) to the haveseen()
+call in /sys/i386/isa/isa.c on your local copy.  (Warning: doing this
+will bypass checks for ALL drivers, so be careful)

 
                - Jordan Hubbard (jkh@freefall.cdrom.com)
 
                - Jordan Hubbard (jkh@freefall.cdrom.com)

+               - Steven Wallace (swallace@freefall.cdrom.com)