Provided by: oss4-base_4.2-build2020-1ubuntu3_amd64 bug

NAME

       oss_sblive - Creative Labs Sound Blaster Live/Audigy family driver.

DESCRIPTION

       Open  Sound System driver for Creative Labs Sound Blaster Live!, Audigy, Audigy2, Audigy2-Value and sound
       cards.

       The sblive driver supports:

       •  8-48Khz Playback/Recording

       •  8 or 16 bits

       •  SPDIF digital output and Input

       •  Multi channel 5.1 (Live!) and 7.1 (Audigy) output.

       AC3 passthrough is only supported on Audigy series of the soundcards.

OTHER SIMILAR CARDS

       There are several Sound Blaster cards that are also called as Live or Audigy.  However  these  cards  are
       based on entirely different hardware design and they are not compatible with this driver.

       •  Sound Blaster Live 5.1 card is used in some Dell machines but it's driven by the emu10k1x driver.

       •  Sound Blaster AudigyLS and Live 7.1 models are driven by the audigyls driver of OSS.

          SBLIVE  COMBO  SPDIF  AND  AUDIO JACKS Most models of Live! and Audigy cards have an orange combo jack
          that is used both for the analog center/LFE output and for digital DIN  (S/PDIF)  output.  The  output
          mode  is  selected  by  a driver configuration option (seel below) which should be set to proper value
          depending on the actual speaker configuration.

       •  Noisy analog center/LFE output. The orange combo jack at the rear plate of  the  Live/Audigy  card  is
          shared  between  the  digital DIN and the analog center/LFE outputs. In digital DIN mode (default) you
          will hear very noisy output from the speakers connected to  this  output  jack.  If  you  have  analog
          center/LFE  (subwoofer)  speakers  connected  then  you  need  to  turn off the sblive_digital_din (or
          audigy_digital_din) option.

       •  There is a new configuration option to enable/disable the "digital DIN" output. By default the digital
          DIN interface is enabled which disables the center/LFE analog output (uses the same  combo  jack).  By
          setting  the  sblive_digital_din  (or  audigy_digital_din) option to 0 you can enable the analog C/LFE
          output feature. When digital DIN is disabled you can still get S/PDIF (or AC3) output from the digital
          (optical/coax) outputs of the optional livedrive unit.

          SBLIVE MIXER SB Live cards have actually two mixer chips. In OSS both of them are controlled together.
          However only limited set of features can be controlled using ordinary  mixer  programs  (such  as  the
          mixer applet included in OSS).  Majority of features can only be accessed using the ossmix and ossxmix
          programs included in OSS.

       The  AC97  mixer is used to control volumes of the back bracket inputs (mic and line in) and the _analog_
       CD input connector on the soundcard. The 'mic' volume controls the level of the rear  bracket  microphone
       input  sent directly to the front (only front) speakers. The 'line' and 'cd' controls do the same for the
       back bracket line in connector and the on board analog CD input connector. It's  usually  recommended  to
       set these volumes to 0.

       Another  function  of  the  AC97  mixer  is  selecting the signal that is passed to the master mixer (for
       example for recording). One of the 'mic', 'line' or ’cd' signals can be routed to  the  master  mixer  by
       selecting  that  device as the recording source in the AC97 mixer. The 'rec' volume control slider can be
       used to adjust the signal strength. The 'igain' control doesn't usually have any effect but some hardware
       revisions may use it for controlling the microphone recording level.

        SBLIVE MASTER MIXER
       Other mixer functions are handled by the DSP engine of the EMU 10k1 chip.  Most input signals  (including
       all digital signals and LiveDrive inputs).

              There  are  only  two  master  mixer settings that can be controlled using all mixer programs. The
              'vol' setting is the master output volume that affects both the front and rear  speakers  and  the
              headphone  output (digital output volumes are not affected). The 'pcm' setting controls volumes of
              all PCM playback channels (/dev/dsp#).

              In addition to volume sliders most inputs have a stereo VU meter pair (only in ossxmix)  that  can
              be used to monitor the input and to adjust the input levels properly.

              The master mixer consists of several sections that are:

              •  Primary  section:  This  section has two settings. The "spkmode" setting selects how front/rear
                 speakers are used for PCM playback  (outputs  from  programs  using  /dev/dsp#).  The  possible
                 settings  are FRONT, REAR and FRONT+REAR. The default is FRONT+REAR. Change this setting if you
                 like to get PCM playback only from front or rear speakers. The  "autoreset"  flag  is  used  to
                 control the "/dev" section.

              •  "/dev"  section:  This  section controls the volumes of each /dev/dsp# device file supported by
                 the device (there are 8 of them at this moment). These volumes  will  return  back  to  maximum
                 every time the device is opened. However this can be disabled by setting the 'autoreset' option
                 to  OFF.  The  ossxmix program has special ability to show the application using the particular
                 /dev/dsp device (for layout reasons only the first 4 characters of the program name are shown).

              •  The equalizer section: This section controls the graphic equalizer for front speakers only.

              •  The front rear, and record sections: These three  identical  sections  control  the  levels  of
                 external  inputs and PCM playback (/dev/dsp# devices) to be sent to the front/rear speakers and
                 to the recording device.  The CD Analog audio will only be heard from the FRONT speakers.

                 SBLIVE RECORDING Before recording anything you need to set the volumes in the recording section
                 properly. To enable recording from the AC97 connected inputs (mic, line in and analog  CD)  use
                 the  AC97  mixer  to  select the desired input and then tune the input level using the rec (and
                 igain) setting.

              Finally set the 'ac97' slider in the record section of the master  mixer  so  that  the  recording
              level is suitable.

              The OSS drivers permit recording any application that's currently playing.

              To record audio that's playing on any of the SB Live channels:

              •  Turn  down  the  AC97 control in the "record" section. This prevents any audio being fed to the
                 soundcard from MIC/Line-in/CD-in from getting mixed with the audio produced by the  application
                 that's currently playing.

              •  Type ossrecord -s<sampling rate> -b<bits/sample> -c<channels> test.wav

              •  To  stop  recording  press  <Ctrl-c> and then you can play back the test.wav file using ossplay
                 command.

              RECORDING ISSUES: In most cases noise is caused by the microphone input  or  some  other  (unused)
              input.  Use  the  ossxmix program to turn off all unused inputs and finally save the current mixer
              settings (see below).

       Hint: Look at the VU meter panels of ossxmix. It's usually very  easy  to  locate  the  noise  source  by
       looking which input has some signal coming from it.

              WARNING!  If  you turn off some of the signals in recording section or the AC97 mixer section this
              affects all subsequent recordings. Remember to raise the volume prior doing any  recording.  After
              that decrease the volumes again if necessary.

        SBLIVE HARDWARE MIXING
       You  can  use  /dev/oss/oss_sblive0/ pcm0-pcm7 to play multiple audio programs using the hardware mixing.
       Simply specify the device name with the application. A simple  test  is  to  do  the  following:  ossplay
       -d/dev/oss/oss_sblive0/pcm0  <file1.wav>  &  ossplay  -d/dev/oss/oss_sblive0/pcm1  <file2.wav>  & ossplay
       -d/dev/oss/oss_sblive0/pcm2 <file3.wav> &

              You should hear all three wav files playing simultaneously.

              NOTE: Some apps may desire the old /dev/dspN names. e.g. /dev/dsp0 - /dev/dsp7.

              NOTE: You can increase the number of output devices from the standard 8 devices to 32 device.  For
              this,  run soundconf, select Set configuration options and look for the entry "sblive_device", now
              type any number between 1 and 32 for the number of  channels  you  wish.  You  can  also  do  this
              manually by editing oss_sblive.conf and inserting sblive_devices=XX entry, e.g.: sblive_devices=27

                     CDROM  CONNNECTIONS  There  are  two alternative ways to connect audio signal from a CD-ROM
                     drive tor the SB Live soundcard. You can use a (three wire) analog  cable  or  a  (2  wire)
                     digital  cable.  OSS now supports both of these choices. Note that there are separate mixer
                     settings for both of these connections.

              The analog CD-ROM wire is connected to the AC97 code chip and this method works in most cases.  To
              route  the  analog  CD  -input  to  the  (front) speakers you need to raise the volume of the 'cd'
              control in mixer. However if you like to hear the analog CD input both from the  front  and  rears
              speakers  you  need to do this in slightly different way (please read the description of the mixer
              above).

              The digital connection works only with CD-ROM drives that has support for it.  Note that some  CD-
              ROM drives having this digital output connector use a different signal level than the one required
              by SB Live. This means that the digital connection doesn't work with all CD-ROM drives (no sound).
              If  you  have  problems with the digital connection you should use the analog one.  When using the
              the digital CD input you may need to adjust the 'digcd' volumes using ossxmix (or ossmix).

              It should be noted that SB Live works internally at 48 kHz.  This  means  that  all  S/PDIF  input
              signals are automatically sample rate converted to 48 kHz.  If you record from a 44.1 kHz (CD-ROM)
              and  save the result to a 44.1 kHz file the signal will be sample rate converted twice. First from
              the 44.1 kHz input to internal 48 kHz and then back to 44.1 kHz. While the sample  rate  converter
              of  SB Live is very precise this will cause some change. This should not be any problem when doing
              audio recordings but it may cause  unwanted  results  when  transferring  digital  data  (such  as
              AC3/DTS) using the S/PDIF the interface.

CONFIGURATION OPTIONS

       •  sblive_digital_din=<0|1>  -  This  option is to enable/disable the "digital DIN" output of SB Live. By
          default the digital DIN interface is disabled which enables the center/LFE  analog  output  (uses  the
          same  combo  jack). By setting the sblive_digital_din option to 0 you can enable the analog Center/LFE
          output feature. When digital DIN is disabled you can still get S/PDIF (or AC3) output from the digital
          (optical/coax) outputs of the optional livedrive unit. Default: 0=analog output.

       •  audigy_digital_din=<0|1> - same as "sblive_digital_din"  option  except  for  the  Audigy  soundcards.
          Default: 1=digital output.

       •  sblive_devices=<1..32> - Number of audio devices to be configured.

LIMITATION

       •  SB Live! devices will not work in Sparc systems due to PCI addressing limitations. Only Audigy/Audigy2
          models work under Sparc.

       •  EMU Wavetable MIDI synthesizer is not supported

       •  AC3 passthrough only supported on Audigy/Audigy but not on SB Live! devices.

FILES

       /etc/oss4/conf/oss_sblive.conf
              Device configuration file.

AUTHOR

       4Front Technologies

                                                11 February 2015                                   oss_sblive(7)