simplify the mixer(4) code and interface. document the interface.

ok kettenis

1 files changed, 67 insertions, 3 deletions

diff --git a/share/man/man4/man4.sparc64/audioce.4 b/share/man/man4/man4.sparc64/audioce.4
index 6528fbfff2c..9e2d6c9669a 100644
--- a/share/man/man4/man4.sparc64/audioce.4
+++ b/share/man/man4/man4.sparc64/audioce.4
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: audioce.4,v 1.6 2008/03/31 08:12:22 jmc Exp $
+.\"     $OpenBSD: audioce.4,v 1.7 2010/07/26 20:06:12 jakemsr Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 31 2008 $
+.Dd $Mdocdate: July 26 2010 $
 .Dt AUDIOCE 4 sparc64
 .Os
 .Sh NAME
@@ -48,7 +48,71 @@ Audio capture is currently not supported.
 The
 .Nm
 has a maximum precision of 16 bits and has both stereo and monoaural outputs.
-The output ports are: the internal speaker, line, and headphones.
+.Sh MIXER INTERFACE
+The
+.Xr mixer 4
+interface for
+.Nm
+provides the following controls:
+.Bl -tag -width "outputs.monitor.mute"
+.It Cm outputs.dac
+Specifies the attenuation of DAC output.
+A value of
+.Ql 255
+represents 0 dB attenuation.
+.It Cm outputs.dac.mute
+Specifies whether DAC output is muted.
+.It Cm outputs.output
+Specifies the set of enabled output ports.
+The output ports are:
+.Ql line ,
+the line output jack,
+.Ql hp ,
+the low impedance headphone jack, and
+.Ql spkr ,
+the internal speaker.
+Note: Not all systems support disabling the headphone and line output ports.
+.It Cm inputs.cd
+Specifies the gain applied to CD audio input.
+A value of
+.Ql 191
+represents 0 dB.
+.It Cm inputs.cd.mute
+Specifies whether CD audio input is muted.
+.It Cm inputs.line
+Specifies the gain applied to line input.
+A value of
+.Ql 191
+represents 0 dB.
+.It Cm inputs.line.mute
+Specifies whether line input is muted.
+.It Cm outputs.monitor
+Specifies the attenuation of ADC to DAC output.
+A value of
+.Ql 255
+represents 0 dB.
+.It Cm outputs.monitor.mute
+Specifies whether ADC to DAC output is muted.
+.It Cm record.volume
+Specifies ADC input gain.
+A value of
+.Ql 0
+represents 0 dB.
+.It Cm record.source
+Specifies the active input port for the ADC.
+The following are valid ADC input ports:
+.Ql line ,
+line input,
+.Ql cd ,
+CD input,
+.Ql mic ,
+microphone input, and
+.Ql mixerout ,
+post-mixer output as heard on the output ports.
+.It Cm record.mic_preamp
+Specifies whether an additional +20 dB gain is
+applied to the ADC's microphone input.
+.El
 .Sh SEE ALSO
 .Xr ioctl 2 ,
 .Xr audio 4 ,