share/man/man4/snd_hda.4

   1 .\" Copyright (c) 2006-2008 Joel Dahl <joel@FreeBSD.org>
   2 .\" Copyright (c) 2008 Alexander Motin <mav@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 AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd January 11, 2012
  29 .Dt SND_HDA 4
  30 .Os
  31 .Sh NAME
  32 .Nm snd_hda
  33 .Nd "Intel High Definition Audio bridge device driver"
  34 .Sh SYNOPSIS
  35 To compile this driver into the kernel, place the following lines in your
  36 kernel configuration file:
  37 .Bd -ragged -offset indent
  38 .Cd "device sound"
  39 .Cd "device snd_hda"
  40 .Ed
  41 .Pp
  42 Alternatively, to load the driver as a module at boot time, place the
  43 following line in
  44 .Xr loader.conf 5 :
  45 .Bd -literal -offset indent
  46 snd_hda_load="YES"
  47 .Ed
  48 .Sh DESCRIPTION
  49 The High Definition (HD) Audio specification was developed by Intel as the
  50 logical successor of the old AC'97 specification and has several advantages,
  51 such as higher bandwidth which allows more channels and more detailed formats,
  52 support for several logical audio devices, and general purpose DMA channels.
  53 .Pp
  54 The
  55 .Nm
  56 driver includes HDA bus controller driver (hdac), HDA codec driver (hdacc)
  57 and HDA codecs audio functions bridge driver (hdaa) that allows
  58 the generic audio driver,
  59 .Xr sound 4 ,
  60 to be used with this hardware.
  61 Only audio functions are supported by
  62 .Nm .
  63 Modem and other possible functions are not implemented.
  64 .Pp
  65 The
  66 .Nm
  67 driver supports hardware that conforms with revision 1.0 of the Intel High
  68 Definition Audio specification and tries to behave much like the Microsoft
  69 Universal Audio Architecture (UAA) draft (revision 0.7b) for handling audio
  70 devices.
  71 .Pp
  72 According to HDA and UAA specifications, depending on the number of HDA buses
  73 and codecs present in system, their audio capabilities and BIOS provided
  74 configuration, the
  75 .Nm
  76 driver often provides several PCM audio devices.
  77 For example, one device for main rear 7.1 output and inputs, one device
  78 for independent headset connectors at front and one device for SPDIF or
  79 HDMI audio input/output.
  80 The assignment of audio inputs and outputs may be tuned with
  81 .Xr device.hints 5
  82 or
  83 .Xr sysctl 8 .
  84 The driver's verbose boot messages provide a lot of information about
  85 the operation of the driver and present audio setup.
  86 .Pp
  87 The default audio device may be tuned by setting the
  88 .Ar hw.snd.default_unit
  89 sysctl, as described in
  90 .Xr sound 4 ,
  91 or explicitly specified in application settings.
  92 .Ss Boot-time Configuration
  93 The following variables are available at boot-time through the
  94 .Xr device.hints 5
  95 file:
  96 .Bl -tag -width ".Va hint.hdac.%d.config"-offset indent
  97 .It Va hint.hdac.%d.config
  98 Configures a range of possible controller options.
  99 Possible values are:
 100 .Dq Li 64bit ,
 101 .Dq Li dmapos ,
 102 .Dq Li msi .
 103 An option prefixed with
 104 .Dq Li no ,
 105 such as
 106 .Dq Li nomsi ,
 107 will do the opposite and takes precedence.
 108 Options can be separated by whitespace and commas.
 109 .It Va hint.hdac.%d.msi
 110 Controls MSI (Message Signaled Interrupts) support.
 111 .It Va hint.hdac.%d.cad%d.nid%d.config
 112 Same as
 113 .Va hint.hdaa.%d.nid%d.config
 114 .It Va hint.hdaa.%d.config
 115 Configures a range of possible audio function options.
 116 Possible values are:
 117 .Dq Li eapdinv ,
 118 .Dq Li ivref ,
 119 .Dq Li ivref50 ,
 120 .Dq Li ivref80 ,
 121 .Dq Li ivref100 ,
 122 .Dq Li fixedrate ,
 123 .Dq Li forcestereo ,
 124 .Dq Li ovref ,
 125 .Dq Li ovref50 ,
 126 .Dq Li ovref80 ,
 127 .Dq Li ovref100 ,
 128 .Dq Li senseinv ,
 129 .Dq Li softpcmvol ,
 130 and
 131 .Dq Li vref .
 132 An option prefixed with
 133 .Dq Li no ,
 134 such as
 135 .Dq Li nofixedrate ,
 136 will do the opposite and takes precedence.
 137 Options can be separated by whitespace and commas.
 138 .Pp
 139 The
 140 .Dq Li eapdinv
 141 option inverts External Amplifier Power Down signal.
 142 The
 143 .Dq Li fixedrate
 144 denies all sampling rates except 48KHz.
 145 The
 146 .Dq Li forcestereo
 147 denies mono playback/recording.
 148 The
 149 .Dq Li senseinv
 150 option inverts jack sensing logic.
 151 The
 152 .Dq Li ivref Ns Ar X
 153 and
 154 .Dq Li ovref Ns Ar X
 155 options control the voltage used to power external microphones.
 156 .It Va hint.hdaa.%d.gpio_config
 157 Overrides audio function GPIO pins configuration set by BIOS.
 158 May be specified as a set of space-separated
 159 .Dq Ar num Ns = Ns Ar value
 160 pairs, where
 161 .Ar num
 162 is GPIO line number, and
 163 .Ar value
 164 is one of:
 165 .Dq Li keep ,
 166 .Dq Li set ,
 167 .Dq Li clear ,
 168 .Dq Li disable
 169 and
 170 .Dq Li input .
 171 .Pp
 172 .Dq Li GPIO Ns s
 173 are a codec's General Purpose I/O pins which system integrators sometimes
 174 use to control external muters, amplifiers and so on.
 175 If you have no sound, or sound volume is not adequate, you may have to
 176 experiment a bit with the GPIO setup to find the optimal setup for your
 177 system.
 178 .It Va hint.hdaa.%d.nid%d.config
 179 Overrides audio function pin configuration set by BIOS.
 180 May be specified as a 32-bit hexadecimal value with a leading
 181 .Dq 0x ,
 182 or as a set of space-separated
 183 .Dq Ar option Ns = Ns Ar value
 184 pairs.
 185 .El
 186 .Pp
 187 Pin configuration is the UAA driver's main source of information about codec
 188 usage.
 189 This information is usually provided by the codec manufacturer and tuned
 190 by system integrators for specific system requirements.
 191 The
 192 .Nm
 193 driver allows users to override it to fix integrator mistakes or to use the
 194 available codec in alternative ways (for example to get stereo output and 2
 195 inputs instead of a single 5.1 output).
 196 .Pp
 197 The following options are supported:
 198 .Bl -tag -width ".Va device=" -offset indent
 199 .It Va as
 200 Association number.
 201 Associations are used to group individual pins to form a complex multi-pin
 202 device.
 203 For example, to group 4 connectors for 7.1 input/output, or to treat several
 204 input connectors as sources for the same input device.
 205 Association numbers can be specified as numeric values from 0 to 15.
 206 A value of 0 means disabled pin.
 207 A value of 15 is a set of independent unassociated pins.
 208 Each association includes only pins of the same direction (in/out) and is
 209 detected atomically (all pins or none).
 210 A separate PCM audio device is created for every pair of input and
 211 output associations.
 212 .It Va seq
 213 Sequence number.
 214 A unique, per-association number used to order pins inside the
 215 particular association.
 216 Sequence numbers can be specified as numeric values from 0 to 15.
 217 .Pp
 218 The sequence number 15 has a special meaning for output associations.
 219 Output pins with this number and device type
 220 .Dq Ar Headphones
 221 will duplicate (with automatic mute if jack detection is supported) the
 222 first pin in that association.
 223 .Pp
 224 The sequence numbers 14 and 15 has a special meaning for input associations.
 225 Their presence in association defines it as multiplexed or mixed respectively.
 226 If none of them present and there are more then one pin in association,
 227 the association will provide multichannel input.
 228 .Pp
 229 For multichannel input/output assotiations sequence numbers encode
 230 channel pairs positions:
 231 0 - Front, 1 - Center/LFE, 2 - Back, 3 - Front Wide Center, 4 - Side.
 232 Standard combinations are: (0) - Stereo; (0, 2), (0, 4) - Quadro;
 233 (0, 1, 2), (0, 1, 4) - 5.1; (0, 1, 2, 4) - 7.1.
 234 .It Va device
 235 Device type.
 236 Can be specified as a number from 0 to 15 or as a name:
 237 .Dq Li Line-out ,
 238 .Dq Li Speaker ,
 239 .Dq Li Headphones,
 240 .Dq Li CD ,
 241 .Dq Li SPDIF-out ,
 242 .Dq Li Digital-out ,
 243 .Dq Li Modem-line ,
 244 .Dq Li Modem-handset ,
 245 .Dq Li Line-in ,
 246 .Dq Li AUX ,
 247 .Dq Li Mic ,
 248 .Dq Li Telephony ,
 249 .Dq Li SPDIF-in ,
 250 .Dq Li Digital-in ,
 251 .Dq Li Res.E ,
 252 or
 253 .Dq Li Other .
 254 The device type also describes the pin direction (in/out).
 255 For example,
 256 .Dq Li CD
 257 always means an input pin, while
 258 .Dq Li Headphones
 259 always means an output.
 260 .It Va conn
 261 Connection type.
 262 Can be specified as a number from 0 to 3.
 263 The connection type can also be specified as one of the special names
 264 .Dq Li Jack ,
 265 .Dq Li None ,
 266 .Dq Li Fixed ,
 267 or
 268 .Dq Li Both .
 269 Pins with a connection type of
 270 .Dq Li None
 271 are disabled.
 272 .It Va ctype
 273 Connector physical type.
 274 Can be specified as a number from 0 to 15.
 275 This is a reference only value.
 276 It is ignored by the
 277 .Nm
 278 driver.
 279 .It Va color
 280 Connector color.
 281 Can be specified as a number from 0 to 15 or as one of the names
 282 .Dq Li Unknown ,
 283 .Dq Li Black ,
 284 .Dq Li Grey ,
 285 .Dq Li Blue ,
 286 .Dq Li Green ,
 287 .Dq Li Red ,
 288 .Dq Li Orange ,
 289 .Dq Li Yellow ,
 290 .Dq Li Purple ,
 291 .Dq Li Pink ,
 292 .Dq Li Res.A ,
 293 .Dq Li Res.B ,
 294 .Dq Li Res.C ,
 295 .Dq Li Res.D ,
 296 .Dq Li White ,
 297 or
 298 .Dq Li Other .
 299 This is a reference only value.
 300 It is ignored by the
 301 .Nm
 302 driver.
 303 .It Va loc
 304 Connector physical location.
 305 Can be specified as a number from 0 to 63.
 306 This is a reference only value.
 307 It is ignored by the
 308 .Nm
 309 driver.
 310 .It Va misc
 311 Misc bits.
 312 Can be specified as a number from 0 to 15.
 313 Bit 0 has a special meaning.  When set it means that jack detection is
 314 not implemented in hardware.
 315 .El
 316 .Ss Runtime Configuration
 317 The following
 318 .Xr sysctl 8
 319 variables are available in addition to those available to all
 320 .Xr sound 4
 321 devices:
 322 .Bl -tag -width ".Va dev.hdaa.%d.nid%d_original" -offset indent
 323 .It Va dev.hdac.%d.pindump
 324 Setting this to a non-zero value dumps the current pin configuration, main
 325 capabilities and jack sense status of all audio functions on the controller
 326 to console and syslog.
 327 .It Va dev.hdac.%d.polling
 328 Enables polling mode.
 329 In this mode the driver operates by querying the device state on timer
 330 ticks using
 331 .Xr callout 9
 332 instead of interrupts.
 333 Polling is disabled by default.
 334 Do not enable it unless you are facing weird interrupt problems or if the
 335 device cannot generate interrupts at all.
 336 .It Va dev.hdaa.%d.config
 337 Run-time equivalent of the
 338 .Va hint.hdaa.%d.config
 339 tunable.
 340 .It Va dev.hdaa.%d.gpi_state
 341 Current state of GPI lines.
 342 .It Va dev.hdaa.%d.gpio_state
 343 Current state of GPIO lines.
 344 .It Va dev.hdaa.%d.gpio_config
 345 Run-time equivalent of the
 346 .Va hint.hdaa.%d.gpio.config
 347 tunable.
 348 .It Va dev.hdaa.%d.gpo_state
 349 Current state of GPO lines.
 350 .It Va dev.hdaa.%d.nid%d_config
 351 Run-time equivalent of the
 352 .Va hint.hdaa.%d.nid%d.config
 353 tunable.
 354 .It Va dev.hdaa.%d.nid%d_original
 355 Original pin configuration written by BIOS.
 356 .It Va dev.hdaa.%d.reconfig
 357 Setting this to a non-zero value makes driver to destroy existing pcm devices
 358 and process new pins configuration set via
 359 .Va dev.hdaa.%d.nid%d_config.
 360 .El
 361 .Sh EXAMPLES
 362 Taking HP Compaq DX2300 with Realtek ALC888 HDA codec for example.
 363 This system has two audio connectors on a front side, three audio connectors
 364 on a rear side and one internal speaker.
 365 According to verbose driver output and the codec datasheet,
 366 this codec has five stereo DACs and two stereo ADCs, all of them are routable to
 367 any codec pin (external connector).
 368 All codec pins are reversible (could be configured either as input or output).
 369 .Pp
 370 So high codec uniformity and flexibility allow driver to configure it in many
 371 different ways, depending on requested pins usage decribed by pins configuration.
 372 The driver reports such default pin configuration when verbose messages enabled:
 373 .Bd -literal
 374 hdaa0: nid   0x    as seq device       conn  jack    loc        color   misc
 375 hdaa0: 20 01014020 2  0  Line-out      Jack  1/8     Rear       Green   0
 376 hdaa0: 21 99130110 1  0  Speaker       Fixed ATAPI   Onboard    Unknown 1
 377 hdaa0: 22 411111f0 15 0  Speaker       None  1/8     Rear       Black   1 DISA
 378 hdaa0: 23 411111f0 15 0  Speaker       None  1/8     Rear       Black   1 DISA
 379 hdaa0: 24 01a19830 3  0  Mic           Jack  1/8     Rear       Pink    8
 380 hdaa0: 25 02a1983f 3  15 Mic           Jack  1/8     Front      Pink    8
 381 hdaa0: 26 01813031 3  1  Line-in       Jack  1/8     Rear       Blue    0
 382 hdaa0: 27 0221401f 1  15 Headphones    Jack  1/8     Front      Green   0
 383 hdaa0: 28 411111f0 15 0  Speaker       None  1/8     Rear       Black   1 DISA
 384 hdaa0: 30 411111f0 15 0  Speaker       None  1/8     Rear       Black   1 DISA
 385 hdaa0: 31 411111f0 15 0  Speaker       None  1/8     Rear       Black   1 DISA
 386 .Ed
 387 .Pp
 388 Here we can see, that the nodes with ID (nid) 25 and 27 are front panel
 389 connectors (Jack, Front), nids 20, 24 and 26 are rear panel connectors
 390 (Jack, Rear) and nid 21 is a built-in speaker (Fixed, Onboard).
 391 Pins with nids 22, 23, 28, 30 and 31 will be disabled by driver due to "None"
 392 connectivity. So the pin count and description matches to connectors that
 393 we have.
 394 .Pp
 395 Using association (as) and sequence (seq) fields values pins are grouped into
 396 3 associations:
 397 .Bd -literal
 398 hdaa0: Association 0 (1) out:
 399 hdaa0:   Pin nid=21 seq=0
 400 hdaa0:   Pin nid=27 seq=15
 401 hdaa0: Association 1 (2) out:
 402 hdaa0:   Pin nid=20 seq=0
 403 hdaa0: Association 2 (3) in:
 404 hdaa0:   Pin nid=24 seq=0
 405 hdaa0:   Pin nid=26 seq=1
 406 hdaa0:   Pin nid=25 seq=15
 407 .Ed
 408 .Pp
 409 Each
 410 .Xr pcm 4
 411 device uses two associations: one for playback and one for recording.
 412 Associations processed and assigned to
 413 .Xr pcm 4
 414 devices in increasing numerical order.
 415 In this case association #0 (1) will become
 416 .Li pcm0
 417 device playback, using the internal speakers and
 418 .Ar Headphones
 419 jack with speaker automute on the headphones jack connection.
 420 Association #1 (2) will become
 421 .Li pcm1
 422 playback, using the
 423 .Ar Line-out
 424 jack.
 425 Association #2 (3) will become
 426 .Li pcm0
 427 recording, using the external microphones and the
 428 .Ar Line-in
 429 jack.
 430 .Pp
 431 The
 432 .Nm
 433 driver provides extensive verbose messages to diagnose its operation
 434 logic and describe its current codec configuration.
 435 .Pp
 436 Using
 437 .Xr device.hints 5
 438 it is possible to modify the configuration of the existing pins,
 439 allowing a broad range of different audio setups.
 440 Here are a few examples of some setups possible for this particular
 441 hardware:
 442 .Ss Example 1
 443 Setting the
 444 .Xr device.hints 5
 445 options
 446 .Bd -literal
 447 hint.hdac.0.cad0.nid20.config="as=1"
 448 hint.hdac.0.cad0.nid21.config="as=2"
 449 .Ed
 450 .Pp
 451 will swap line-out and speaker functions.
 452 So the
 453 .Li pcm0
 454 device will play to the line-out and headphones jacks. Line-out will
 455 be muted on the headphones jack connection.
 456 Recording on
 457 .Li pcm0
 458 will go from two external microphones and line-in jacks.
 459 .Li pcm1
 460 playback will go to the internal speaker.
 461 .Pp
 462 .Ss Example 2
 463 Setting the
 464 .Xr device.hints 5
 465 options
 466 .Bd -literal
 467 hint.hdac.0.cad0.nid20.config="as=1 seq=15 device=Headphones"
 468 hint.hdac.0.cad0.nid27.config="as=2 seq=0"
 469 hint.hdac.0.cad0.nid25.config="as=4 seq=0"
 470 .Ed
 471 .Pp
 472 will split the headphones and one of the microphones to a separate device.
 473 The
 474 .Li pcm0
 475 device will play to the internal speaker and to the line-out jack, with
 476 speaker automute on the line-out jack connection.
 477 Recording on
 478 .Li pcm0
 479 will use input from one external microphone and the line-in jacks.
 480 The
 481 .Li pcm1
 482 device will be completely dedicated to a headset (headphones and mic)
 483 connected to the front connectors.
 484 .Pp
 485 .Ss Example 3
 486 Setting the
 487 .Xr device.hints 5
 488 options
 489 .Bd -literal
 490 hint.hdac.0.cad0.nid20.config="as=1 seq=0"
 491 hint.hdac.0.cad0.nid26.config="as=2 seq=0"
 492 hint.hdac.0.cad0.nid27.config="as=3 seq=0"
 493 hint.hdac.0.cad0.nid25.config="as=4 seq=0"
 494 hint.hdac.0.cad0.nid24.config="as=5 seq=0 device=Line-out"
 495 hint.hdac.0.cad0.nid21.config="as=6 seq=0"
 496 .Ed
 497 .Pp
 498 will give 4 independent devices:
 499 .Li pcm0
 500 .Pq line-out and line-in ,
 501 .Li pcm1
 502 .Pq headphones and mic ,
 503 .Li pcm2
 504 .Pq additional line-out via retasked rear mic jack ,
 505 and
 506 .Li pcm3
 507 .Pq internal speaker .
 508 .Pp
 509 .Ss Example 4
 510 Setting the
 511 .Xr device.hints 5
 512 options
 513 .Bd -literal
 514 hint.hdac.0.cad0.nid20.config="as=1 seq=0"
 515 hint.hdac.0.cad0.nid24.config="as=1 seq=1 device=Line-out"
 516 hint.hdac.0.cad0.nid26.config="as=1 seq=2 device=Line-out"
 517 hint.hdac.0.cad0.nid21.config="as=2 seq=0"
 518 .Ed
 519 .Pp
 520 will give 2 devices:
 521 .Li pcm0
 522 for 5.1 playback via 3 rear connectors (line-out and retasked
 523 mic and line-in) and headset (headphones and mic) at front connectors.
 524 .Li pcm1
 525 for internal speaker playback.
 526 On headphones connection rear connectors will be muted.
 527 .Sh MIXER CONTROLS
 528 Depending on codec configuration, these controls and signal sources could be
 529 reported to
 530 .Xr sound 4 :
 531 .Pp
 532 .Bl -tag -width ".Va speaker" -offset indent
 533 .It Va vol
 534 overall output level (volume)
 535 .It Va rec
 536 overall recording level
 537 .It Va igain
 538 input-to-output monitoring loopback level
 539 .It Va ogain
 540 external amplifier control
 541 .It Va pcm
 542 PCM playback
 543 .It Va mix
 544 input mix
 545 .It Va mic
 546 first external or second internal microphone input
 547 .It Va monitor
 548 first internal or second external microphone input
 549 .It Va line , Va line1 , Va line2, Va line3
 550 analog (line) inputs
 551 .It Va dig1 , Va dig2 , Va dig3
 552 digital (S/PDIF, HDMI or DisplayPort) inputs
 553 .It Va cd
 554 CD input
 555 .It Va speaker
 556 PC speaker input
 557 .It Va phin , Va phout , Va radio . Va video
 558 other random inputs
 559 .El
 560 .Pp
 561 Controls have different precision. Some could be just an on/off triggers.
 562 Most of controls use logarithmic scale.
 563 .Sh HARDWARE
 564 The
 565 .Nm
 566 driver supports controllers having PCI class 4 (multimedia) and
 567 subclass 3 (HDA), compatible with Intel HDA specification.
 568 .Pp
 569 The
 570 .Nm
 571 driver supports more then two hundred different controllers and CODECs.
 572 There is no sense to list all of them here, as in most cases specific CODEC
 573 configuration and wiring are more important then type of the CODEC itself.
 574 .Sh SEE ALSO
 575 .Xr sound 4 ,
 576 .Xr snd_ich 4 ,
 577 .Xr device.hints 5 ,
 578 .Xr loader.conf 5 ,
 579 .Xr sysctl 8
 580 .Sh HISTORY
 581 The
 582 .Nm
 583 device driver first appeared in
 584 .Fx 6.3 .
 585 .Sh AUTHORS
 586 .An -nosplit
 587 The
 588 .Nm
 589 driver was written by
 590 .An Stephane E. Potvin Aq sepotvin@videotron.ca ,
 591 .An Ariff Abdullah Aq ariff@FreeBSD.org
 592 and
 593 .An Alexander Motin Aq mav@FreeBSD.org .
 594 This manual page was written by
 595 .An Joel Dahl Aq joel@FreeBSD.org ,
 596 .An Alexander Motin Aq mav@FreeBSD.org
 597 and
 598 .An Giorgos Keramidas Aq keramida@FreeBSD.org .
 599 .Sh BUGS
 600 Some Hardware/OEM vendors tend to screw up BIOS settings or use custom
 601 unusual CODEC wiring that create problems to the driver.
 602 This may result in missing pcm devices, or a state where the
 603 .Nm
 604 driver seems to attach and work, but no sound is played.
 605 Some cases can be solved by tuning
 606 .Pa loader.conf
 607 variables.
 608 But before trying to fix problem that way, make sure that there really is
 609 a problem and that the PCM audio device in use really corresponds to the
 610 expected audio connector.
 611 .Pp
 612 Some vendors use non-standardized General Purpose I/O (GPIO) pins of the codec
 613 to control external amplifiers.
 614 In some cases setting a combination of GPIO bits may be needed to make
 615 sound work on a specific device.
 616 .Pp
 617 HDMI and DisplayPort audio may also require support from video driver.