xref: /freebsd/share/man/man4/man4.powerpc/snd_ai2s.4 (revision 0afc94c17a8772df34294778904e816258542498)
18486eb86SNathan Whitehorn.\"-
28486eb86SNathan Whitehorn.\" Copyright (c) 2009 Nathan Whitehorn <nwhitehorn@FreeBSD.org>
38486eb86SNathan Whitehorn.\" All rights reserved.
48486eb86SNathan Whitehorn.\"
58486eb86SNathan Whitehorn.\" Redistribution and use in source and binary forms, with or without
68486eb86SNathan Whitehorn.\" modification, are permitted provided that the following conditions
78486eb86SNathan Whitehorn.\" are met:
88486eb86SNathan Whitehorn.\" 1. Redistributions of source code must retain the above copyright
98486eb86SNathan Whitehorn.\"    notice, this list of conditions and the following disclaimer.
108486eb86SNathan Whitehorn.\" 2. Redistributions in binary form must reproduce the above copyright
118486eb86SNathan Whitehorn.\"    notice, this list of conditions and the following disclaimer in the
128486eb86SNathan Whitehorn.\"    documentation and/or other materials provided with the distribution.
138486eb86SNathan Whitehorn.\"
148486eb86SNathan Whitehorn.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
158486eb86SNathan Whitehorn.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
168486eb86SNathan Whitehorn.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
178486eb86SNathan Whitehorn.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
188486eb86SNathan Whitehorn.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
198486eb86SNathan Whitehorn.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
208486eb86SNathan Whitehorn.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
218486eb86SNathan Whitehorn.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
228486eb86SNathan Whitehorn.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
238486eb86SNathan Whitehorn.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
248486eb86SNathan Whitehorn.\" POSSIBILITY OF SUCH DAMAGE.
258486eb86SNathan Whitehorn.\"
268486eb86SNathan Whitehorn.\" $FreeBSD$
278486eb86SNathan Whitehorn.\"
288486eb86SNathan Whitehorn.Dd January 20, 2009
298486eb86SNathan Whitehorn.Dt SND_AI2S 4
308486eb86SNathan Whitehorn.Os
318486eb86SNathan Whitehorn.Sh NAME
328486eb86SNathan Whitehorn.Nm snd_ai2s
338486eb86SNathan Whitehorn.Nd "Apple I2S audio device driver"
348486eb86SNathan Whitehorn.Sh SYNOPSIS
358486eb86SNathan WhitehornTo compile this driver into the kernel,
368486eb86SNathan Whitehornplace the following lines in your
378486eb86SNathan Whitehornkernel configuration file:
388486eb86SNathan Whitehorn.Bd -ragged -offset indent
398486eb86SNathan Whitehorn.Cd "device sound"
408486eb86SNathan Whitehorn.Cd "device snd_ai2s"
418486eb86SNathan Whitehorn.Ed
428486eb86SNathan Whitehorn.Pp
438486eb86SNathan WhitehornAlternatively, to load the driver as a
448486eb86SNathan Whitehornmodule at boot time, place the following line in
458486eb86SNathan Whitehorn.Xr loader.conf 5 :
468486eb86SNathan Whitehorn.Bd -literal -offset indent
478486eb86SNathan Whitehornsnd_ai2s_load="YES"
488486eb86SNathan Whitehorn.Ed
498486eb86SNathan Whitehorn.Sh DESCRIPTION
508486eb86SNathan WhitehornThe
518486eb86SNathan Whitehorn.Nm
528486eb86SNathan Whitehorndriver provides support for the Apple I2S audio controllers found
538486eb86SNathan Whitehornpredominantly in G4 and G5 machines, along with the snapper and tumbler
548486eb86SNathan Whitehorncodecs. Some machines (e.g. the Mac Mini) do not have configurable
558486eb86SNathan Whitehorncodecs and so lack hardware volume control.
568486eb86SNathan Whitehorn.Sh HARDWARE
578486eb86SNathan Whitehorn.Pp
588486eb86SNathan WhitehornChips supported by the
598486eb86SNathan Whitehorn.Nm
608486eb86SNathan Whitehorndriver include:
618486eb86SNathan Whitehorn.Pp
628486eb86SNathan Whitehorn.Bl -bullet -compact
638486eb86SNathan Whitehorn.It
648486eb86SNathan WhitehornApple Tumbler Audio
658486eb86SNathan Whitehorn.It
668486eb86SNathan WhitehornApple Snapper Audio
678486eb86SNathan Whitehorn.El
688486eb86SNathan Whitehorn.Pp
698486eb86SNathan Whitehorn.Sh SEE ALSO
708486eb86SNathan Whitehorn.Xr sound 4 ,
718486eb86SNathan Whitehorn.Xr snd_davbus 4
728486eb86SNathan Whitehorn.Sh HISTORY
738486eb86SNathan WhitehornThe
748486eb86SNathan Whitehorn.Nm
758486eb86SNathan Whitehorndevice driver appeared in
768486eb86SNathan Whitehorn.Nx 2.0
778486eb86SNathan Whitehornand then in
788486eb86SNathan Whitehorn.Fx 8.0 .
798486eb86SNathan Whitehorn.Sh AUTHORS
808486eb86SNathan Whitehorn.An -nosplit
818486eb86SNathan WhitehornThe
828486eb86SNathan Whitehorn.Nm
838486eb86SNathan Whitehorndriver was written by
848486eb86SNathan Whitehorn.An Tsubai Masanari
858486eb86SNathan Whitehorn.Aq tsubai@netbsd.org ,
868486eb86SNathan Whitehornand ported to FreeBSD by
878486eb86SNathan Whitehorn.An Marco Trillo
888486eb86SNathan Whitehorn.Aq marcotrillo@gmail.com .
89*0afc94c1SUlrich Spörlein.Sh BUGS
90*0afc94c1SUlrich SpörleinRecording and operation with non-44.1 Khz audio are not currently supported.
91