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 $
26.\"
27.Dd October 14, 2001
28.Dt MAESTRO3 4
29.Os
30.Sh NAME
31.Nm maestro3
32.Nd FreeBSD audio sub-driver for ESS Maestro3/Allegro-1 hardware
33.Sh SYNOPSIS
34.Li "kldload 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
48.Cd "device pcm"
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
67.Xr pcm 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
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 $
26.\"
27.Dd October 14, 2001
28.Dt MAESTRO3 4
29.Os
30.Sh NAME
31.Nm maestro3
32.Nd FreeBSD audio sub-driver for ESS Maestro3/Allegro-1 hardware
33.Sh SYNOPSIS
34.Li "kldload 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
48.Cd "device pcm"
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
67.Xr pcm 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