xref: /freebsd/share/man/man4/man4.powerpc/snd_ai2s.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.Dd January 20, 2009
278486eb86SNathan Whitehorn.Dt SND_AI2S 4
288486eb86SNathan Whitehorn.Os
298486eb86SNathan Whitehorn.Sh NAME
308486eb86SNathan Whitehorn.Nm snd_ai2s
318486eb86SNathan Whitehorn.Nd "Apple I2S audio device driver"
328486eb86SNathan Whitehorn.Sh SYNOPSIS
338486eb86SNathan WhitehornTo compile this driver into the kernel,
348486eb86SNathan Whitehornplace the following lines in your
358486eb86SNathan Whitehornkernel configuration file:
368486eb86SNathan Whitehorn.Bd -ragged -offset indent
378486eb86SNathan Whitehorn.Cd "device sound"
388486eb86SNathan Whitehorn.Cd "device snd_ai2s"
398486eb86SNathan Whitehorn.Ed
408486eb86SNathan Whitehorn.Pp
418486eb86SNathan WhitehornAlternatively, to load the driver as a
428486eb86SNathan Whitehornmodule at boot time, place the following line in
438486eb86SNathan Whitehorn.Xr loader.conf 5 :
448486eb86SNathan Whitehorn.Bd -literal -offset indent
458486eb86SNathan Whitehornsnd_ai2s_load="YES"
468486eb86SNathan Whitehorn.Ed
478486eb86SNathan Whitehorn.Sh DESCRIPTION
488486eb86SNathan WhitehornThe
498486eb86SNathan Whitehorn.Nm
508486eb86SNathan Whitehorndriver provides support for the Apple I2S audio controllers found
518486eb86SNathan Whitehornpredominantly in G4 and G5 machines, along with the snapper and tumbler
528486eb86SNathan Whitehorncodecs. Some machines (e.g. the Mac Mini) do not have configurable
538486eb86SNathan Whitehorncodecs and so lack hardware volume control.
548486eb86SNathan Whitehorn.Sh HARDWARE
558486eb86SNathan WhitehornChips supported by the
568486eb86SNathan Whitehorn.Nm
578486eb86SNathan Whitehorndriver include:
588486eb86SNathan Whitehorn.Pp
598486eb86SNathan Whitehorn.Bl -bullet -compact
608486eb86SNathan Whitehorn.It
618486eb86SNathan WhitehornApple Tumbler Audio
628486eb86SNathan Whitehorn.It
638486eb86SNathan WhitehornApple Snapper Audio
648486eb86SNathan Whitehorn.El
658486eb86SNathan Whitehorn.Sh SEE ALSO
66*068b48d6SJoel Dahl.Xr snd_davbus 4 ,
67*068b48d6SJoel Dahl.Xr sound 4
688486eb86SNathan Whitehorn.Sh HISTORY
698486eb86SNathan WhitehornThe
708486eb86SNathan Whitehorn.Nm
718486eb86SNathan Whitehorndevice driver appeared in
728486eb86SNathan Whitehorn.Nx 2.0
738486eb86SNathan Whitehornand then in
748486eb86SNathan Whitehorn.Fx 8.0 .
758486eb86SNathan Whitehorn.Sh AUTHORS
768486eb86SNathan Whitehorn.An -nosplit
778486eb86SNathan WhitehornThe
788486eb86SNathan Whitehorn.Nm
798486eb86SNathan Whitehorndriver was written by
806c899950SBaptiste Daroussin.An Tsubai Masanari Aq Mt tsubai@netbsd.org ,
816c899950SBaptiste Daroussinand ported to
826c899950SBaptiste Daroussin.Fx
836c899950SBaptiste Daroussinby
846c899950SBaptiste Daroussin.An Marco Trillo Aq Mt marcotrillo@gmail.com .
850afc94c1SUlrich Spörlein.Sh BUGS
860afc94c1SUlrich SpörleinRecording and operation with non-44.1 Khz audio are not currently supported.
87