sys/dev/sound/isa/i386/sound.doc

   1 $FreeBSD: src/sys/i386/isa/sound/sound.doc,v 1.12 1999/08/28 00:45:20 peter Exp $
   2
   3 Instructions on using audio on a FreeBSD 2.1 (or 2.0-current) system.
   4 See also /sys/i386/conf/LINT.
   5
   6 To enable sound driver support, the controller sound code must be included
   7 in your config file:
   8
   9 # SB = SoundBlaster;  PAS = ProAudioSpectrum;  GUS = Gravis UltraSound
  10 # Controls all sound devices
  11 controller      snd0
  12
  13 Uncomment one or more of these device entries, depending on what type of
  14 sound card you have:
  15
  16 # ProAudioSpectrum PCM and Midi - for PAS
  17 #device pas0     at isa? port 0x388 irq 10 drq 6
  18
  19 # SoundBlaster DSP driver - for SB, SB Pro, SB16, PAS(emulating SB)
  20 #device sb0      at isa? port 0x220 irq 7 drq 1
  21
  22 # SoundBlaster 16 DSP driver - for SB16 - requires sb0 device
  23 #device sbxvi0   at isa? drq 5
  24
  25 # SoundBlaster 16 MIDI - for SB16 - requires sb0 device
  26 #device sbmidi0  at isa? port 0x300
  27
  28 # Gravis UltraSound - for GUS, GUS16, GUSMAX
  29 # For cards that use 2 DMA Channels:
  30 #     drq = Write DMA Channel, flags = Read DMA Channel
  31 #device gus0 at isa? port 0x220 irq 11 drq 1 flags 0x3
  32
  33 # Gravis UltraSound 16 bit option - for GUS16 - requires gus0
  34 #device gusxvi0 at isa? port 0x530 irq 7 drq 3
  35
  36 # MS Sound System (AD1848 Based Boards)
  37 #device mss0 at isa? port 0x530 irq 10 drq 1
  38
  39 # Yamaha OPL-2/OPL-3 FM - for SB, SB Pro, SB16, PAS
  40 #device opl0     at isa? port 0x388
  41
  42 # MPU-401 - for MPU-401 standalone card
  43 #device mpu0     at isa? port 0x330 irq 6 drq 0
  44
  45 # 6850 UART Midi
  46 #device uart0 at isa? port 0x330 irq 5
  47
  48 You may add one or more of the following depending on what you do and don't
  49 want compiled into your kernel.  Note:  Excluding things with EXCLUDE_...
  50 is NOT recommended unless you really know what you're doing.
  51
  52 #options        EXCLUDE_AUDIO                   # NO digital audio support
  53 #options        EXCLUDE_SEQUENCER               # NO sequencer support
  54 #options        EXCLUDE_MIDI                    # NO MIDI support whatsoever
  55 #options        EXCLUDE_SBPRO                   # EXCLUDE SB Pro support
  56 #options        EXCLUDE_SB_EMULATION            # NO PAS SB emulation support
  57 #options        EXCLUDE_GUS_IODETECT            # NO GUS io detection
  58 #options        EXCLUDE_PRO_MIDI                # NO PAS MIDI support
  59
  60 Other Options:
  61
  62 #options        SYMPHONY_PAS
  63         Adds some code to make pas work with Symphony chipsets.  Only use
  64         this if your pas doesn't work and you have a Symphony chipset.
  65
  66 #options        BROKEN_BUS_CLOCK
  67         Some systems with the OPTI chipset and a PAS will require you to
  68         use this option.  Symptoms are that you will hear a lot of clicking and
  69         popping sounds, like a geiger counter, coming out of the PAS even when
  70         it is not playing anything.
  71
  72 #options        MOZART_PORT
  73         Adds support for Mozart (OAK OTI-601). (Part of the MSS driver)
  74
  75 #options        OPTI_MAD16_PORT
  76         Adds support for the OPTI MAD16 Chip. (Part of the MSS driver)
  77         If your soundcard has a chip labeled "OPTi 82C929" then try this.
  78
  79 #options        __SGNXPRO__
  80         Adds support for the SG NX Pro mixer. (Part of the SB driver)
  81
  82 #options        JAZZ16
  83         Adds support for the MV Jazz16 (ProSonic etc). (Part of the SB Driver)
  84
  85 #options        SM_WAVE
  86         Adds support for the SoundMan Wave (Part of the SB Driver)
  87         Note:  You will need to do some work to get this to work.
  88                See i386/isa/sound/configure.c
  89
  90 #options        SM_GAMES
  91         Adds support for the Logitech SoundMan Games (Part of the SB Driver)
  92
  93 #options        PAS_JOYSTICK_ENABLE
  94         Enables the gameport on the ProAudio Spectrum
  95
  96 NOTE:  The MPU-401 driver may or may not work, and is unfortunately
  97 unverifiable since no one I know has one.  If you can test this,
  98 please let me know!  Also note that you will have to change these
  99 settings if your soundcard is set for a non-standard address or IRQ.
 100 Please check your documentation (or verify with any provided DOS utilities
 101 that may have come with your card) and set the IRQ or address fields
 102 accordingly.
 103
 104
 105 Also:  You can configure more then one card on a single DMA using
 106 the conflicts keyword in your configuration file.  This is useful for boards
 107 with more then one type of emulation.
 108
 109
 110 Probing problems:  Since the SB16 uses the same IRQ and addresses for
 111 the different drivers, some of the snd drivers will not be probed because
 112 the kernel thinks there is a conflict.  This can be worked-around by
 113 using the "conflicts" keyword on the sb16's device line.
 114
 115
 116 For further information, contact multimedia@freebsd.org
 117
 118                 - Jordan Hubbard (jkh@freefall.cdrom.com)
 119                 - Steven Wallace (swallace@freefall.cdrom.com)
 120                 - Sujal Patel (smpatel@wam.umd.edu)