xref: /netbsd-src/share/man/man4/auich.4 (revision 7a268bffe03eebe7736c95c6dec84e2f242fd3ee)
1.\"	$NetBSD: auich.4,v 1.25 2016/10/16 05:26:20 wiz Exp $
2.\"
3.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Jason R. Thorpe.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd October 13, 2016
31.Dt AUICH 4
32.Os
33.Sh NAME
34.Nm auich
35.Nd Intel I/O Controller Hub integrated AC'97 audio device driver
36.Sh SYNOPSIS
37.Cd "auich* at pci? dev ? function ?"
38.Cd "audio* at audiobus?"
39.Sh DESCRIPTION
40The
41.Nm
42device driver supports the integrated AC'97 audio controller
43of the Intel I/O Controller Hub.
44Supported chipsets include the i82801AA (ICH), i82801AB (ICH0),
45i82801BA (ICH2), i82440MX, i82801CA (ICH3), i82801DB (ICH4), i82801EB (ICH5),
46i82801FB (ICH6), i82801GB/GR (ICH7), and Intel 6300ESB.
47The driver also supports SiS 7012, nForce MCP, nForce2 MCP-T,
48nForce3 MCP-T, nForce3 250 MCP-T, nForce4, and AMD 8111.
49.Pp
50The driver provides the following
51.Xr sysctl 8
52read/write variable (when hardware support is available):
53.Bl -tag -width Ds
54.It Va hw.auich0.ac97rate
55Link rate of the device in Hz.
56The driver automatically measures and
57calculates the correct rate so you usually don't need to change
58this.
59There is, however, a chance that the driver miscalculates the
60rate especially on an emulated hardware, resulting in an incorrect
61playback pitch.
62When this happens you need to manually set this
63variable to the correct value.
64Try
65.Li 48000
66if you don't know the correct value as it is the default link rate.
67.Sh SEE ALSO
68.Xr ac97 4 ,
69.Xr audio 4 ,
70.Xr pci 4 ,
71.Xr sysctl 8
72.Sh HISTORY
73The
74.Nm
75device driver appeared in
76.Nx 1.6 .
77.Sh BUGS
78The
79.Sq microphone
80input DMA channel is not currently supported.
81