← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/oss4/oneiric-proposed

« back to all changes in this revision

Viewing changes to kernel/drv/oss_imux/oss_imux.man

  • Committer: Bazaar Package Importer
  • Author(s): Stefano Rivera
  • Date: 2011-06-16 20:37:48 UTC
  • mfrom: (5.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20110616203748-jbrxik6ql33z54co
Tags: 4.2-build2004-1ubuntu1
https://launchpad.net/bugs/746048
https://launchpad.net/bugs/770972
* Merge from Debian unstable.
  - Supports our current kernel (LP: #746048)
  Remaining changes:
  - debian/oss4-dkms.dkms.in: s/source/build/ in Kernel headers paths.
* ld-as-needed.patch: Re-order CC arguments to enable building with ld
  --as-needed (LP: #770972)

Show diffs side-by-side

added added

removed removed

Lines of Context:
kernel/drv/oss_imux/oss_imux.man
 
1
NAME
 
2
oss_imux - Input Muplexer audio driver.
 
3
 
 
4
DESCRIPTION
 
5
IMUX is a virtual recording engine that permits up to 8 audio recording
 
6
applications to run at the same time. Generally most soundcards permit only a
 
7
single recording application to record the input source (via mic, line or CD).
 
8
With IMUX, you can use up to 8 recording applications to record the same
 
9
source in different sample rates, bits/sample and channels (mono/stereo).
 
10
IMUX does all the rate and format conversion in software. The applications
 
11
think that they are actually getting data from the physical device. For
 
12
instance, if you want to record the input from a CDROM in .wav format at
 
13
48Khz/8/Mono and at the same time you want to record the same stream in .mp3
 
14
format in 44.1Khz 16 bit stereo, with IMUX, you can start the wave recording
 
15
application on the first IMUX device and start the MP3 encoder on the second
 
16
IMUX device and both applications will run simultaneously thinking that they
 
17
are getting data from the physical soundcard.
 
18
 
 
19
CONFIGURATION
 
20
To add the IMUX driver you first need to ensure that there is a physical
 
21
soundcard present and then you can run ossdetect -i to add it. You may want
 
22
to select a master device by setting imux_masterdev, but the autodetection
 
23
should provide a good default. After OSS restart, imux should be available.
 
24
 
 
25
USAGE
 
26
Connect an input source to the soundcard's line-in jack. Using the Mixer app
 
27
like ossmix (or any OSS compliant mixer) set the recording source to Line-In 
 
28
(eg ossmix line.rec ON) Now you can start recording the input in multiple 
 
29
formats and at different sample rates. The simplest example is:
 
30
 
 
31
        ossrecord -s48000 -b16 -c2 -d/dev/oss/oss_imux0/pcmin0 test1.wav &
 
32
        ossrecord -s8000 -b8 -d/dev/oss/oss_imux0/pcmin0 test2.wav &
 
33
 
 
34
After a few minutes of recording you can stop them by placing the command in
 
35
forground mode (type fg %1 or fg %2) and press ^c to stop.
 
36
 
 
37
You now have two wav format files. test1.wav is a 48KHz 16bit stereo file and
 
38
test2.wav is a 8Khz 8bit Mono file.
 
39
 
 
40
You can now playback the files as follows:
 
41
o ossplay -v test1.wav and it should show you that the file is indeed
 
42
48Khz 16bit stereo.
 
43
 
 
44
o ossplay -v test2.wav - you should see that this file is indeed a
 
45
8Khz 8bit mono file.
 
46
 
 
47
What you have essentially accomplished is recording a single input stream into
 
48
two different formats at the same time.
 
49
 
 
50
You can now extend this analogy to record the input in mp3 format and RealAudio
 
51
format simultaneously.
 
52
 
 
53
The IMUX control panel can be displayed by typing ossxmix -d<imux mixer number>
 
54
(for e.g. in the above example, IMUX mixer is #2 so we type ossxmix -d2
 
55
 
 
56
There are record level control sliders for each input channel and it will show
 
57
activity when a recording program is active on a particular channel.
 
58
 
 
59
 
 
60
OPTIONS
 
61
o imux_masterdev: Selects which physical device to use as the Master device
 
62
for the IMUX driver.
 
63
Values: -1: automatically selected by OSS, 1-N: Audio device index of the
 
64
master device (as reported by ossinfo -a), Default: -1.
 
65
 
 
66
o imux_rate: Specifies what is the base sampling rate used by the imux driver.
 
67
Values: 5000-96000 Default: 48000
 
68
 
 
69
o imux_devices: Specifies number of Input Multiplexer devices to setup.
 
70
Values: 2-48 Default: 5
 
71
 
 
72
 
 
73
FILES
 
74
CONFIGFILEPATH/oss_imux.conf Device configuration file
 
75
 
 
76
AUTHOR
 
77
4Front Technologies
 
78