xref: /openbsd/share/man/man4/man4.sparc64/audioce.4 (revision 09467b48)
1.\"     $OpenBSD: audioce.4,v 1.9 2020/05/17 05:48:39 ratchov Exp $
2.\"
3.\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
19.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
24.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd $Mdocdate: May 17 2020 $
28.Dt AUDIOCE 4 sparc64
29.Os
30.Sh NAME
31.Nm audioce
32.Nd SPARC64 EBus CS4231 audio device
33.Sh SYNOPSIS
34.Cd "audioce* at ebus?"
35.Cd "audio* at audioce?"
36.Sh DESCRIPTION
37The
38.Nm
39device uses the
40.Tn Crystal Semiconductor
41CS4231A
42Parallel Interface, Multimedia Audio Codec
43chip to implement the audio device interface described in
44.Xr audio 4 .
45This device is found onboard on some PCI/EBus based sparc64 models.
46.Pp
47The
48.Nm
49has a maximum precision of 16 bits and has both stereo and monoaural outputs.
50.Sh MIXER INTERFACE
51The
52.Xr audio 4
53interface for
54.Nm
55provides the following controls:
56.Bl -tag -width "outputs.monitor.mute"
57.It Cm outputs.dac
58Specifies the attenuation of DAC output.
59A value of
60.Ql 255
61represents 0 dB attenuation.
62.It Cm outputs.dac.mute
63Specifies whether DAC output is muted.
64.It Cm outputs.output
65Specifies the set of enabled output ports.
66The output ports are:
67.Ql line ,
68the line output jack,
69.Ql hp ,
70the low impedance headphone jack, and
71.Ql spkr ,
72the internal speaker.
73Note: Not all systems support disabling the headphone and line output ports.
74.It Cm inputs.cd
75Specifies the gain applied to CD audio input.
76A value of
77.Ql 191
78represents 0 dB.
79.It Cm inputs.cd.mute
80Specifies whether CD audio input is muted.
81.It Cm inputs.line
82Specifies the gain applied to line input.
83A value of
84.Ql 191
85represents 0 dB.
86.It Cm inputs.line.mute
87Specifies whether line input is muted.
88.It Cm outputs.monitor
89Specifies the attenuation of ADC to DAC output.
90A value of
91.Ql 255
92represents 0 dB.
93.It Cm outputs.monitor.mute
94Specifies whether ADC to DAC output is muted.
95.It Cm record.volume
96Specifies ADC input gain.
97A value of
98.Ql 0
99represents 0 dB.
100.It Cm record.source
101Specifies the active input port for the ADC.
102The following are valid ADC input ports:
103.Ql line ,
104line input,
105.Ql cd ,
106CD input,
107.Ql mic ,
108microphone input, and
109.Ql mixerout ,
110post-mixer output as heard on the output ports.
111.It Cm record.mic_preamp
112Specifies whether an additional +20 dB gain is
113applied to the ADC's microphone input.
114.El
115.Sh SEE ALSO
116.Xr ioctl 2 ,
117.Xr audio 4 ,
118.Xr ebus 4 ,
119.Xr intro 4
120.Sh HISTORY
121.Ox
122support for
123.Nm
124first appeared in
125.Ox 3.0 .
126