Deleted Added
full compact
snd_maestro3.4 (86740) snd_maestro3.4 (134938)
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.\"
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 86740 2001-11-21 17:12:31Z ru $
25.\" $FreeBSD: head/share/man/man4/snd_maestro3.4 134938 2004-09-08 08:28:02Z ru $
26.\"
26.\"
27.Dd October 14, 2001
28.Dt MAESTRO3 4
27.Dd August 28, 2004
28.Dt SND_MAESTRO3 4
29.Os
30.Sh NAME
29.Os
30.Sh NAME
31.Nm maestro3
31.Nm snd_maestro3
32.Nd FreeBSD audio sub-driver for ESS Maestro3/Allegro-1 hardware
33.Sh SYNOPSIS
32.Nd FreeBSD audio sub-driver for ESS Maestro3/Allegro-1 hardware
33.Sh SYNOPSIS
34.Li "kldload snd_maestro3"
34.Cd "device sound"
35.Cd "device snd_maestro3"
35.Sh DESCRIPTION
36The
37.Nm
38driver provides support for the ESS Maestro3 and Allegro-1 sound chips
39under the PCM framework.
40These chips are mostly found in laptop computers and feature an AC97 mixer,
41a multi-channel sample rate converter that can mix up to four digital audio
42streams in hardware, recording support, and external volume control buttons.
43.Pp
44The firmware for the sound processor is licensed under the GNU Public
45License, and thus this driver is not included in the default
46.Pa GENERIC
47kernel, nor is it compiled into the kernel when
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
48.Cd "device pcm"
49.Cd "device sound"
49is specified in the kernel config file.
50A convenient way to automatically load the driver is to add the line
51.Pp
52.Dl snd_maestro3_load="YES"
53.Pp
54to the file
55.Pa /boot/loader.conf .
56.Sh DIAGNOSTICS
57The hardware volume control buttons can be connected to two different pin
58sets on the chip, depending on the manufacturer.
59The driver has no way of determining this configuration, so a hint may be
60used to override the default guess.
61Add the line
62.Dq Li hint.pcm.0.hwvol_config="0"
63to the file
64.Pa /boot/device.hints
65to override the default setting.
66.Sh SEE ALSO
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
67.Xr pcm 4 ,
68.Xr sound 4 ,
68.Xr loader.conf 5
69.Sh HISTORY
70The
71.Nm
72driver first appeared in
73.Fx 4.3 .
74.Sh AUTHORS
75.An Scott Long Aq scottl@FreeBSD.org
76.An Darrel Anderson Aq anderson@cs.duke.edu
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