Whitespace cleanup, sort sections, fix list.

This commit is contained in:
wiz 2009-09-06 17:59:09 +00:00
parent 7f280b4483
commit 0192905bb1

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.
.\" All rights reserved.
@ -49,7 +49,7 @@ It is a replacement for
.Xr azalia 4 .
It was written from scratch following the Intel HD Audio and Microsoft
Universal Audio Architecture specifications.
.Pp
The driver consists of two interlinked components, which reflects the
hardware design.
The
@ -57,14 +57,14 @@ The
component interfaces with a PCI/PCIe bus and provides an
.Xr hdaudiobus 4
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
.Nm
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
devices.
.Pp
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).
The way the widgets are interlinked varies significantly between
@ -79,22 +79,26 @@ Unlike the
.Xr azalia 4
driver (which tends to generate a large number of unclearly named
.Xr mixer 4
controls),
controls),
.Nm
works backwards by starting with a list of desired, consistent and compatible
.Xr mixer 4
controls and configuring/discovering appropriate widget link routes to fit.
.Pp
By following the published mechanisms for common implementations of widget
parsing, it is expected that nearly all High Definition Audio devices will
be supported without requiring per-device quirks.
.Sh SEE ALSO
.Xr audio 4 ,
.Xr mixer 4 ,
.Xr pci 4 ,
.Pa http://www.intel.com/standards/hdaudio/
.Pa http://www.microsoft.com/whdc/device/audio/
.Sh HISTORY
The
.Nm
device driver appeared in
.Nx 6.0 .
.Sh AUTHORS
The
.Nm
@ -102,23 +106,22 @@ driver was written by
.An Jared McNeill Aq jmcneill@NetBSD.org
under contract by
.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
The following items are not yet implemented:
.Bl -tag -width indent
- Support sample rates in hardware other than 48kHz
.Bl -tag -width indent
- Improve power management support when driver is idle
.Bl -tag -width indent
- Add support for non-PCM output formats
.Bl -tag -width indent
- Handle unsolicited RIRB messages
.Bl -tag -width indent
- Headphone jack sensing
.Bl -tag -width indent
- Modem function groups
.Sh HISTORY
The
.Nm
device driver appeared in
.Nx 6.0 .
.Bl -bullet
.It
Support sample rates in hardware other than 48kHz
.It
Improve power management support when driver is idle
.It
Add support for non-PCM output formats
.It
Handle unsolicited RIRB messages
.It
Headphone jack sensing
.It
Modem function groups
.El