1987de8a0SScott Long.\" Copyright (c) 2001 Scott Long 2987de8a0SScott Long.\" All rights reserved. 3987de8a0SScott Long.\" 4987de8a0SScott Long.\" Redistribution and use in source and binary forms, with or without 5987de8a0SScott Long.\" modification, are permitted provided that the following conditions 6987de8a0SScott Long.\" are met: 7987de8a0SScott Long.\" 1. Redistributions of source code must retain the above copyright 8987de8a0SScott Long.\" notice, this list of conditions and the following disclaimer. 9987de8a0SScott Long.\" 2. Redistributions in binary form must reproduce the above copyright 10987de8a0SScott Long.\" notice, this list of conditions and the following disclaimer in the 11987de8a0SScott Long.\" documentation and/or other materials provided with the distribution. 12987de8a0SScott Long.\" 13987de8a0SScott Long.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14987de8a0SScott Long.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15987de8a0SScott Long.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16987de8a0SScott Long.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17987de8a0SScott Long.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18987de8a0SScott Long.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19987de8a0SScott Long.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20987de8a0SScott Long.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21987de8a0SScott Long.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22987de8a0SScott Long.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23987de8a0SScott Long.\" SUCH DAMAGE. 24987de8a0SScott Long.\" 25aaf93d16SJoel Dahl.Dd December 15, 2005 2624013109SRuslan Ermilov.Dt SND_MAESTRO3 4 27987de8a0SScott Long.Os 28987de8a0SScott Long.Sh NAME 2924013109SRuslan Ermilov.Nm snd_maestro3 30fd500d2fSSimon L. B. Nielsen.Nd "ESS Maestro3/Allegro-1 bridge device driver" 31987de8a0SScott Long.Sh SYNOPSIS 32aaf93d16SJoel DahlTo compile this driver into the kernel, place the following lines in your 33aaf93d16SJoel Dahlkernel configuration file: 34aaf93d16SJoel Dahl.Bd -ragged -offset indent 3524013109SRuslan Ermilov.Cd "device sound" 3624013109SRuslan Ermilov.Cd "device snd_maestro3" 37aaf93d16SJoel Dahl.Ed 38aaf93d16SJoel Dahl.Pp 39aaf93d16SJoel DahlAlternatively, to load the driver as a module at boot time, place the 40aaf93d16SJoel Dahlfollowing line in 41aaf93d16SJoel Dahl.Xr loader.conf 5 : 42aaf93d16SJoel Dahl.Bd -literal -offset indent 43aaf93d16SJoel Dahlsnd_maestro3_load="YES" 44aaf93d16SJoel Dahl.Ed 45987de8a0SScott Long.Sh DESCRIPTION 46987de8a0SScott LongThe 47987de8a0SScott Long.Nm 48987de8a0SScott Longdriver provides support for the ESS Maestro3 and Allegro-1 sound chips 49987de8a0SScott Longunder the PCM framework. 50987de8a0SScott LongThese chips are mostly found in laptop computers and feature an AC97 mixer, 51987de8a0SScott Longa multi-channel sample rate converter that can mix up to four digital audio 52987de8a0SScott Longstreams in hardware, recording support, and external volume control buttons. 53987de8a0SScott Long.Pp 54987de8a0SScott LongThe firmware for the sound processor is licensed under the GNU Public 5599696fe9SRuslan ErmilovLicense, and thus this driver is not included in the default 5699696fe9SRuslan Ermilov.Pa GENERIC 57fd500d2fSSimon L. B. Nielsenkernel. 58fd500d2fSSimon L. B. Nielsen.Sh HARDWARE 59fd500d2fSSimon L. B. NielsenThe 60fd500d2fSSimon L. B. Nielsen.Nm 61fd500d2fSSimon L. B. Nielsendriver supports the following audio devices: 62fd500d2fSSimon L. B. Nielsen.Pp 63fd500d2fSSimon L. B. Nielsen.Bl -bullet -compact 64fd500d2fSSimon L. B. Nielsen.It 65fd500d2fSSimon L. B. NielsenESS Technology Allegro-1 66fd500d2fSSimon L. B. Nielsen.It 67fd500d2fSSimon L. B. NielsenESS Technology Maestro3 68fd500d2fSSimon L. B. Nielsen.El 69987de8a0SScott Long.Sh DIAGNOSTICS 70987de8a0SScott LongThe hardware volume control buttons can be connected to two different pin 71ee2350ccSPyun YongHyeonsets (GPIO or GD) on the chip, depending on the manufacturer. 72987de8a0SScott LongThe driver has no way of determining this configuration, so a hint may be 73987de8a0SScott Longused to override the default guess. 74ee2350ccSPyun YongHyeonThe default setting for hardware volume control assumes that GD pins 75ee2350ccSPyun YongHyeonare wired to control the hardware volume. 76ee2350ccSPyun YongHyeonFor systems that have the GPIO pins wired to the hardware volume control 77ee2350ccSPyun YongHyeonbuttons, add the line 78987de8a0SScott Long.Dq Li hint.pcm.0.hwvol_config="0" 79987de8a0SScott Longto the file 80987de8a0SScott Long.Pa /boot/device.hints 81987de8a0SScott Longto override the default setting. 82987de8a0SScott Long.Sh SEE ALSO 8324013109SRuslan Ermilov.Xr sound 4 , 84987de8a0SScott Long.Xr loader.conf 5 85987de8a0SScott Long.Sh HISTORY 86987de8a0SScott LongThe 87987de8a0SScott Long.Nm 88987de8a0SScott Longdriver first appeared in 89987de8a0SScott Long.Fx 4.3 . 90987de8a0SScott Long.Sh AUTHORS 91*6c899950SBaptiste Daroussin.An Scott Long Aq Mt scottl@FreeBSD.org 92*6c899950SBaptiste Daroussin.An Darrel Anderson Aq Mt anderson@cs.duke.edu 93