1.\" Copyright (c) 2001 Scott Long
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
--- 8 unchanged lines hidden (view full) ---
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD: head/share/man/man4/snd_maestro3.4 134938 2004-09-08 08:28:02Z ru $
26.\"
27.Dd August 28, 2004
28.Dt SND_MAESTRO3 4
29.Os
30.Sh NAME
31.Nm snd_maestro3
32.Nd FreeBSD audio sub-driver for ESS Maestro3/Allegro-1 hardware
33.Sh SYNOPSIS
34.Cd "device sound"
35.Cd "device snd_maestro3"
36.Sh DESCRIPTION
37The
38.Nm
39driver provides support for the ESS Maestro3 and Allegro-1 sound chips
40under the PCM framework.
41These chips are mostly found in laptop computers and feature an AC97 mixer,
42a multi-channel sample rate converter that can mix up to four digital audio
43streams in hardware, recording support, and external volume control buttons.
44.Pp
45The firmware for the sound processor is licensed under the GNU Public
46License, and thus this driver is not included in the default
47.Pa GENERIC
48kernel, nor is it compiled into the kernel when
49.Cd "device sound"
50is specified in the kernel config file.
51A convenient way to automatically load the driver is to add the line
52.Pp
53.Dl snd_maestro3_load="YES"
54.Pp
55to the file
56.Pa /boot/loader.conf .
57.Sh DIAGNOSTICS
58The hardware volume control buttons can be connected to two different pin
59sets on the chip, depending on the manufacturer.
60The driver has no way of determining this configuration, so a hint may be
61used to override the default guess.
62Add the line
63.Dq Li hint.pcm.0.hwvol_config="0"
64to the file
65.Pa /boot/device.hints
66to override the default setting.
67.Sh SEE ALSO
68.Xr sound 4 ,
69.Xr loader.conf 5
70.Sh HISTORY
71The
72.Nm
73driver first appeared in
74.Fx 4.3 .
75.Sh AUTHORS
76.An Scott Long Aq scottl@FreeBSD.org
77.An Darrel Anderson Aq anderson@cs.duke.edu
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
--- 8 unchanged lines hidden (view full) ---
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD: head/share/man/man4/snd_maestro3.4 134938 2004-09-08 08:28:02Z ru $
26.\"
27.Dd August 28, 2004
28.Dt SND_MAESTRO3 4
29.Os
30.Sh NAME
31.Nm snd_maestro3
32.Nd FreeBSD audio sub-driver for ESS Maestro3/Allegro-1 hardware
33.Sh SYNOPSIS
34.Cd "device sound"
35.Cd "device snd_maestro3"
36.Sh DESCRIPTION
37The
38.Nm
39driver provides support for the ESS Maestro3 and Allegro-1 sound chips
40under the PCM framework.
41These chips are mostly found in laptop computers and feature an AC97 mixer,
42a multi-channel sample rate converter that can mix up to four digital audio
43streams in hardware, recording support, and external volume control buttons.
44.Pp
45The firmware for the sound processor is licensed under the GNU Public
46License, and thus this driver is not included in the default
47.Pa GENERIC
48kernel, nor is it compiled into the kernel when
49.Cd "device sound"
50is specified in the kernel config file.
51A convenient way to automatically load the driver is to add the line
52.Pp
53.Dl snd_maestro3_load="YES"
54.Pp
55to the file
56.Pa /boot/loader.conf .
57.Sh DIAGNOSTICS
58The hardware volume control buttons can be connected to two different pin
59sets on the chip, depending on the manufacturer.
60The driver has no way of determining this configuration, so a hint may be
61used to override the default guess.
62Add the line
63.Dq Li hint.pcm.0.hwvol_config="0"
64to the file
65.Pa /boot/device.hints
66to override the default setting.
67.Sh SEE ALSO
68.Xr sound 4 ,
69.Xr loader.conf 5
70.Sh HISTORY
71The
72.Nm
73driver first appeared in
74.Fx 4.3 .
75.Sh AUTHORS
76.An Scott Long Aq scottl@FreeBSD.org
77.An Darrel Anderson Aq anderson@cs.duke.edu