share/man/man4/snd_hda.4

   1 .\" Copyright (c) 2006 Joel Dahl <joel@FreeBSD.org>
   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.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  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$
  26 .\"
  27 .Dd October 8, 2006
  28 .Dt SND_HDA 4
  29 .Os
  30 .Sh NAME
  31 .Nm snd_hda
  32 .Nd "Intel High Definition Audio bridge device driver"
  33 .Sh SYNOPSIS
  34 To compile this driver into the kernel, place the following lines in your
  35 kernel configuration file:
  36 .Bd -ragged -offset indent
  37 .Cd "device sound"
  38 .Cd "device snd_hda"
  39 .Ed
  40 .Pp
  41 Alternatively, to load the driver as a module at boot time, place the
  42 following line in
  43 .Xr loader.conf 5 :
  44 .Bd -literal -offset indent
  45 snd_hda_load="YES"
  46 .Ed
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 bridge device driver allows the generic audio driver,
  51 .Xr sound 4 ,
  52 to attach to Intel High Definition Audio devices.
  53 The
  54 .Nm
  55 driver supports hardware that conforms with revision 1.0 of the Intel High
  56 Definition Audio specification and tries to behave much like the Microsoft
  57 Universal Audio Architecture (UAA) draft (revision 0.7b) for handling audio
  58 devices.
  59 HDA acts like a primary bus, similar to
  60 .Xr miibus 4 ,
  61 for handling various child buses such as audio, modem and HDMI (High Definition
  62 Multimedia Interface).
  63 Only audio is implemented in the
  64 .Nm
  65 driver.
  66 .Pp
  67 The High Definition (HD) Audio specification was developed by Intel as the
  68 logical successor of the old AC'97 specification and has several advantages,
  69 such as higher bandwidth which allows more channels and more detailed formats,
  70 support for several logical audio devices, and general purpose DMA channels.
  71 .Pp
  72 The HDA specification defines the register-level interface, physical link
  73 characteristics, codec programming models, and codec architectural components.
  74 This specification is intended for both device driver developers and hardware
  75 component designers.
  76 .Sh HARDWARE
  77 The
  78 .Nm
  79 driver supports the following audio chipsets:
  80 .Pp
  81 .Bl -bullet -compact
  82 .It
  83 ATI SB450
  84 .It
  85 ATI SB600
  86 .It
  87 Intel 631x/632xESB
  88 .It
  89 Intel 82801F
  90 .It
  91 Intel 82801G
  92 .It
  93 Intel 82801H
  94 .It
  95 nVidia MCP51
  96 .It
  97 nVidia MCP55
  98 .It
  99 nVidia MCP61A
 100 .It
 101 nVidia MCP61B
 102 .It
 103 nVidia MCP65A
 104 .It
 105 nVidia MCP65B
 106 .It
 107 SiS 966
 108 .It
 109 VIA VT8251/8237A
 110 .El
 111 .Pp
 112 Generic Audio chipsets compatible with the Intel HDA specification should work,
 113 but have not been verified yet.
 114 The following codecs have been verified to work:
 115 .Pp
 116 .Bl -bullet -compact
 117 .It
 118 Analog Device AD1981HD
 119 .It
 120 Analog Device AD1983
 121 .It
 122 Analog Device AD1986A
 123 .It
 124 CMedia CMI9880
 125 .It
 126 Conexant Venice
 127 .It
 128 Conexant Waikiki
 129 .It
 130 Realtek ALC260
 131 .It
 132 Realtek ALC861
 133 .It
 134 Realtek ALC880
 135 .It
 136 Realtek ALC882
 137 .It
 138 Realtek ALC883
 139 .It
 140 Sigmatel STAC9220
 141 .It
 142 Sigmatel STAC9220D/9223D
 143 .It
 144 Sigmatel STAC9221
 145 .It
 146 Sigmatel STAC9221D
 147 .El
 148 .Sh SEE ALSO
 149 .Xr sound 4 ,
 150 .Xr loader.conf 5
 151 .Sh HISTORY
 152 The
 153 .Nm
 154 device driver first appeared in
 155 .Fx 7.0 .
 156 .Sh AUTHORS
 157 .An -nosplit
 158 The
 159 .Nm
 160 driver was written by
 161 .An Stephane E. Potvin Aq sepotvin@videotron.ca
 162 and
 163 .An Ariff Abdullah Aq ariff@FreeBSD.org .
 164 This manual page was written by
 165 .An Joel Dahl Aq joel@FreeBSD.org .
 166 .Sh BUGS
 167 There are a couple of missing features, such as support for Digital
 168 S/PDIF and multichannel output.
 169 .Pp
 170 A few Hardware/OEM vendors tend to screw up BIOS settings, thus
 171 rendering the
 172 .Nm
 173 driver useless, which usually results in a state where the
 174 .Nm
 175 driver seems to attach and work, but without any sound.