246 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			246 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
." Automatically generated text
 | 
						|
.TH 7 "August 31, 2006" "OSS" "OSS Devices"
 | 
						|
.SH NAME
 | 
						|
oss_sblive - Creative Labs Sound Blaster Live/Audigy family driver.
 | 
						|
 | 
						|
.SH DESCRIPTION
 | 
						|
 Open Sound System driver for Creative Labs Sound Blaster Live!, Audigy, 
 | 
						|
 Audigy2, Audigy2-Value and sound cards.
 | 
						|
 | 
						|
 The sblive driver supports:
 | 
						|
 | 
						|
 o 8-48Khz Playback/Recording
 | 
						|
 o 8 or 16 bits
 | 
						|
 o SPDIF digital output and Input
 | 
						|
 o Multi channel 5.1 (Live!) and 7.1 (Audigy) output.
 | 
						|
 | 
						|
 AC3 passthrough is only supported on Audigy series of the soundcards.
 | 
						|
 | 
						|
.SH 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.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
Sound Blaster Live 5.1 card is used in some Dell machines but it's
 | 
						|
 driven by the emu10k1x driver.
 | 
						|
.IP \(bu 3
 | 
						|
Sound Blaster AudigyLS and Live 7.1 models are driven by the audigyls
 | 
						|
 driver of OSS.
 | 
						|
 | 
						|
.SH  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.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
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. 
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
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.
 | 
						|
 | 
						|
.SH  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.
 | 
						|
 | 
						|
 | 
						|
.SH  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:
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
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.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
"/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).
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
The equalizer section: This section controls the graphic equalizer for
 | 
						|
 front speakers only.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
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.
 | 
						|
 | 
						|
.SH  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:
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
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.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
Type ossrecord -s<sampling rate> -b<bits/sample> -c<channels> test.wav
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
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.
 | 
						|
 | 
						|
 | 
						|
.SH  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 
 | 
						|
 | 
						|
.SH  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.
 | 
						|
 | 
						|
.SH CONFIGURATION OPTIONS
 | 
						|
.IP \(bu 3
 | 
						|
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.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
audigy_digital_din=<0|1> - same as "sblive_digital_din" option except for
 | 
						|
 the Audigy soundcards. Default: 1=digital output.
 | 
						|
 | 
						|
.IP \(bu 3
 | 
						|
sblive_devices=<1..32> - Number of audio devices to be configured.
 | 
						|
 | 
						|
 | 
						|
.SH LIMITATION
 | 
						|
.IP \(bu 3
 | 
						|
SB Live! devices will not work in Sparc systems due to PCI addressing
 | 
						|
 limitations. Only Audigy/Audigy2 models work under Sparc.
 | 
						|
.IP \(bu 3
 | 
						|
EMU Wavetable MIDI synthesizer is not supported
 | 
						|
.IP \(bu 3
 | 
						|
AC3 passthrough only supported on Audigy/Audigy but not on SB Live! devices.
 | 
						|
 | 
						|
.SH FILES
 | 
						|
/usr/lib/oss/conf/oss_sblive.conf Device configuration file
 | 
						|
 | 
						|
.SH AUTHOR
 | 
						|
 4Front Technologies
 | 
						|
 |