share/man/man4/man4.powerpc/snd_ai2s.4

   1 .\"-
   2 .\" Copyright (c) 2009 Nathan Whitehorn <nwhitehorn@FreeBSD.org>
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  15 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  16 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  17 .\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
  18 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  19 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  20 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  22 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  23 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  24 .\" POSSIBILITY OF SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd January 20, 2009
  29 .Dt SND_AI2S 4
  30 .Os
  31 .Sh NAME
  32 .Nm snd_ai2s
  33 .Nd "Apple I2S audio device driver"
  34 .Sh SYNOPSIS
  35 To compile this driver into the kernel,
  36 place the following lines in your
  37 kernel configuration file:
  38 .Bd -ragged -offset indent
  39 .Cd "device sound"
  40 .Cd "device snd_ai2s"
  41 .Ed
  42 .Pp
  43 Alternatively, to load the driver as a
  44 module at boot time, place the following line in
  45 .Xr loader.conf 5 :
  46 .Bd -literal -offset indent
  47 snd_ai2s_load="YES"
  48 .Ed
  49 .Sh DESCRIPTION
  50 The
  51 .Nm
  52 driver provides support for the Apple I2S audio controllers found
  53 predominantly in G4 and G5 machines, along with the snapper and tumbler
  54 codecs. Some machines (e.g. the Mac Mini) do not have configurable
  55 codecs and so lack hardware volume control.
  56 .Sh HARDWARE
  57 Chips supported by the
  58 .Nm
  59 driver include:
  60 .Pp
  61 .Bl -bullet -compact
  62 .It
  63 Apple Tumbler Audio
  64 .It
  65 Apple Snapper Audio
  66 .El
  67 .Sh SEE ALSO
  68 .Xr sound 4 ,
  69 .Xr snd_davbus 4
  70 .Sh HISTORY
  71 The
  72 .Nm
  73 device driver appeared in
  74 .Nx 2.0
  75 and then in
  76 .Fx 8.0 .
  77 .Sh AUTHORS
  78 .An -nosplit
  79 The
  80 .Nm
  81 driver was written by
  82 .An Tsubai Masanari
  83 .Aq tsubai@netbsd.org ,
  84 and ported to FreeBSD by
  85 .An Marco Trillo
  86 .Aq marcotrillo@gmail.com .
  87 .Sh BUGS
  88 Recording and operation with non-44.1 Khz audio are not currently supported.