xref: /dflybsd-src/share/man/man4/snd_via8233.4 (revision 3b7b7de0633db1b2813962ec77e506dacdeb0842)
1558a398bSSimon Schubert.\" Copyright (c) 2005 Joel Dahl
2558a398bSSimon Schubert.\" All rights reserved.
3558a398bSSimon Schubert.\"
4558a398bSSimon Schubert.\" Redistribution and use in source and binary forms, with or without
5558a398bSSimon Schubert.\" modification, are permitted provided that the following conditions
6558a398bSSimon Schubert.\" are met:
7558a398bSSimon Schubert.\" 1. Redistributions of source code must retain the above copyright
8558a398bSSimon Schubert.\"    notice, this list of conditions and the following disclaimer.
9558a398bSSimon Schubert.\" 2. Redistributions in binary form must reproduce the above copyright
10558a398bSSimon Schubert.\"    notice, this list of conditions and the following disclaimer in the
11558a398bSSimon Schubert.\"    documentation and/or other materials provided with the distribution.
12558a398bSSimon Schubert.\"
13558a398bSSimon Schubert.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14558a398bSSimon Schubert.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15558a398bSSimon Schubert.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16558a398bSSimon Schubert.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17558a398bSSimon Schubert.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18558a398bSSimon Schubert.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19558a398bSSimon Schubert.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20558a398bSSimon Schubert.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21558a398bSSimon Schubert.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22558a398bSSimon Schubert.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23558a398bSSimon Schubert.\" SUCH DAMAGE.
24558a398bSSimon Schubert.\"
25*3b7b7de0SSascha Wildner.\" $FreeBSD: head/share/man/man4/snd_via8233.4 267938 2014-06-26 21:46:14Z bapt $
26558a398bSSimon Schubert.\"
27*3b7b7de0SSascha Wildner.Dd January 8, 2015
28558a398bSSimon Schubert.Dt SND_VIA8233 4
29558a398bSSimon Schubert.Os
30558a398bSSimon Schubert.Sh NAME
31558a398bSSimon Schubert.Nm snd_via8233
32558a398bSSimon Schubert.Nd "VIA Technologies VT8233 bridge device driver"
33558a398bSSimon Schubert.Sh SYNOPSIS
34558a398bSSimon SchubertTo compile this driver into the kernel, place the following lines in your
35558a398bSSimon Schubertkernel configuration file:
36558a398bSSimon Schubert.Bd -ragged -offset indent
37*3b7b7de0SSascha Wildner.Cd "device sound"
38558a398bSSimon Schubert.Cd "device snd_via8233"
39558a398bSSimon Schubert.Ed
40558a398bSSimon Schubert.Pp
41558a398bSSimon SchubertAlternatively, to load the driver as a module at boot time, place the
42558a398bSSimon Schubertfollowing line in
43558a398bSSimon Schubert.Xr loader.conf 5 :
44558a398bSSimon Schubert.Bd -literal -offset indent
45558a398bSSimon Schubertsnd_via8233_load="YES"
46558a398bSSimon Schubert.Ed
47558a398bSSimon Schubert.Sh DESCRIPTION
48558a398bSSimon SchubertThe
49558a398bSSimon Schubert.Nm
50558a398bSSimon Schubertbridge driver allows the generic audio driver,
51558a398bSSimon Schubert.Xr sound 4 ,
52558a398bSSimon Schubertto attach to the VIA VT8233 audio devices.
53558a398bSSimon SchubertThese audio chipsets are integrated in the southbridge on many VIA based
54558a398bSSimon Schubertmotherboards.
55*3b7b7de0SSascha Wildner.Ss Runtime Configuration
56*3b7b7de0SSascha WildnerThe following
57*3b7b7de0SSascha Wildner.Xr sysctl 8
58*3b7b7de0SSascha Wildnervariables are available in addition to those available to all
59*3b7b7de0SSascha Wildner.Xr sound 4
60*3b7b7de0SSascha Wildnerdevices:
61*3b7b7de0SSascha Wildner.Bl -tag -width ".Va dev.pcm.%d.polling" -offset indent
62*3b7b7de0SSascha Wildner.It Va dev.pcm.%d.polling
63*3b7b7de0SSascha WildnerExperimental polling mode, where the driver operates by querying the device
64*3b7b7de0SSascha Wildnerstate on each tick using
65*3b7b7de0SSascha Wildner.Xr callout 9 .
66*3b7b7de0SSascha WildnerPolling is disabled by default.
67*3b7b7de0SSascha WildnerDo not enable it unless you are facing weird interrupt problems or if the
68*3b7b7de0SSascha Wildnerdevice cannot generate interrupts at all.
69*3b7b7de0SSascha Wildner.El
70558a398bSSimon Schubert.Sh HARDWARE
71558a398bSSimon SchubertThe
72558a398bSSimon Schubert.Nm
73558a398bSSimon Schubertdriver supports the following audio chipsets:
74558a398bSSimon Schubert.Pp
75558a398bSSimon Schubert.Bl -bullet -compact
76558a398bSSimon Schubert.It
77558a398bSSimon SchubertVIA VT8233
78558a398bSSimon Schubert.It
79558a398bSSimon SchubertVIA VT8233A
80558a398bSSimon Schubert.It
81558a398bSSimon SchubertVIA VT8233C
82558a398bSSimon Schubert.It
83558a398bSSimon SchubertVIA VT8235
84558a398bSSimon Schubert.It
85558a398bSSimon SchubertVIA VT8237
86558a398bSSimon Schubert.It
87558a398bSSimon SchubertVIA VT8251
88558a398bSSimon Schubert.El
89558a398bSSimon Schubert.Sh SEE ALSO
90558a398bSSimon Schubert.Xr sound 4
91558a398bSSimon Schubert.Sh HISTORY
92558a398bSSimon SchubertThe
93558a398bSSimon Schubert.Nm
94558a398bSSimon Schubertdevice driver first appeared in
95558a398bSSimon Schubert.Fx 4.7 .
96558a398bSSimon Schubert.Sh AUTHORS
97558a398bSSimon SchubertThis manual page was written by
98e18a87e3SFranco Fichtner.An Joel Dahl Aq Mt joel@FreeBSD.org .
99558a398bSSimon Schubert.Sh BUGS
100558a398bSSimon SchubertThe
101558a398bSSimon Schubert.Nm
102558a398bSSimon Schubertdriver
103558a398bSSimon Schubertdoes not support S/PDIF.
104558a398bSSimon SchubertThere is partial support in the code, so implementing it should be fairly
105558a398bSSimon Schuberteasy if the right hardware is available.
106