Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Whitespace cleanup, sort sections, fix list.

Browse Source
This commit is contained in:
wiz 2009-09-06 17:59:09 +00:00
parent 7f280b4483
commit 0192905bb1
1 changed files with 29 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
share/man/man4/hdaudio.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: hdaudio.4,v 1.1 2009/09/06 17:25:55 sborrill Exp $ .\" $NetBSD: hdaudio.4,v 1.2 2009/09/06 17:59:09 wiz Exp $
.\" .\"
.\" Copyright (c) 2009 The NetBSD Foundation, Inc. .\" Copyright (c) 2009 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -49,7 +49,7 @@ It is a replacement for
.Xr azalia 4 . .Xr azalia 4 .
It was written from scratch following the Intel HD Audio and Microsoft It was written from scratch following the Intel HD Audio and Microsoft
Universal Audio Architecture specifications. Universal Audio Architecture specifications.
.Pp
The driver consists of two interlinked components, which reflects the The driver consists of two interlinked components, which reflects the
hardware design. hardware design.
The The
@ -57,14 +57,14 @@ The
component interfaces with a PCI/PCIe bus and provides an component interfaces with a PCI/PCIe bus and provides an
.Xr hdaudiobus 4 .Xr hdaudiobus 4
onto which different function groups attach. onto which different function groups attach.
Each function group (e.g. audio, vendor-specific modem) is exported as a Each function group (e.g. audio, vendor-specific modem) is exported as a
separate child device of the separate child device of the
.Nm .Nm
controller. controller.
Audio function groups (a.k.a audio codec) are exported as Audio function groups (a.k.a. audio codec) are exported as
.Xr hdafg 4 .Xr hdafg 4
devices. devices.
.Pp
Audio codecs are available from a number of manufacturers and are made up of a Audio codecs are available from a number of manufacturers and are made up of a
number of widgets (e.g. audio mixer, output pin, analog-to-digital converter). number of widgets (e.g. audio mixer, output pin, analog-to-digital converter).
The way the widgets are interlinked varies significantly between The way the widgets are interlinked varies significantly between
@ -79,22 +79,26 @@ Unlike the
.Xr azalia 4 .Xr azalia 4
driver (which tends to generate a large number of unclearly named driver (which tends to generate a large number of unclearly named
.Xr mixer 4 .Xr mixer 4
controls), controls),
.Nm .Nm
works backwards by starting with a list of desired, consistent and compatible works backwards by starting with a list of desired, consistent and compatible
.Xr mixer 4 .Xr mixer 4
controls and configuring/discovering appropriate widget link routes to fit. controls and configuring/discovering appropriate widget link routes to fit.
.Pp
By following the published mechanisms for common implementations of widget By following the published mechanisms for common implementations of widget
parsing, it is expected that nearly all High Definition Audio devices will parsing, it is expected that nearly all High Definition Audio devices will
be supported without requiring per-device quirks. be supported without requiring per-device quirks.
.Sh SEE ALSO .Sh SEE ALSO
.Xr audio 4 , .Xr audio 4 ,
.Xr mixer 4 , .Xr mixer 4 ,
.Xr pci 4 , .Xr pci 4 ,
.Pa http://www.intel.com/standards/hdaudio/ .Pa http://www.intel.com/standards/hdaudio/
.Pa http://www.microsoft.com/whdc/device/audio/ .Pa http://www.microsoft.com/whdc/device/audio/
.Sh HISTORY
The
.Nm
device driver appeared in
.Nx 6.0 .
.Sh AUTHORS .Sh AUTHORS
The The
.Nm .Nm
@ -102,23 +106,22 @@ driver was written by
.An Jared McNeill Aq jmcneill@NetBSD.org .An Jared McNeill Aq jmcneill@NetBSD.org
under contract by under contract by
.An Precedence Technologies Ltd Aq http://www.precedence.co.uk/ . .An Precedence Technologies Ltd Aq http://www.precedence.co.uk/ .
The UAA-compliant widget parser is derived from the FreeBSD snd_hda(4) driver. The UAA-compliant widget parser is derived from the
.Fx
snd_hda(4) driver.
.Sh BUGS .Sh BUGS
The following items are not yet implemented: The following items are not yet implemented:
.Bl -tag -width indent .Bl -bullet
- Support sample rates in hardware other than 48kHz .It
.Bl -tag -width indent Support sample rates in hardware other than 48kHz
- Improve power management support when driver is idle .It
.Bl -tag -width indent Improve power management support when driver is idle
- Add support for non-PCM output formats .It
.Bl -tag -width indent Add support for non-PCM output formats
- Handle unsolicited RIRB messages .It
.Bl -tag -width indent Handle unsolicited RIRB messages
- Headphone jack sensing .It
.Bl -tag -width indent Headphone jack sensing
- Modem function groups .It
.Sh HISTORY Modem function groups
The .El
.Nm
device driver appeared in
.Nx 6.0 .