xref: /freebsd/share/man/man4/snd_es137x.4 (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
1.\" Copyright (c) 2004 Atte Peltomaki
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.Dd November 29, 2006
26.Dt SND_ES137X 4
27.Os
28.Sh NAME
29.Nm snd_es137x
30.Nd "Ensoniq AudioPCI ES137x bridge device driver"
31.Sh SYNOPSIS
32To compile this driver into the kernel, place the following lines in your
33kernel configuration file:
34.Bd -ragged -offset indent
35.Cd "device sound"
36.Cd "device snd_es137x"
37.Ed
38.Pp
39Alternatively, to load the driver as a module at boot time, place the
40following line in
41.Xr loader.conf 5 :
42.Bd -literal -offset indent
43snd_es137x_load="YES"
44.Ed
45.Sh DESCRIPTION
46The
47.Nm
48bridge driver allows the generic audio driver
49.Xr sound 4
50to attach to the Ensoniq 137x audio cards.
51.Ss Runtime Configuration
52The following
53.Xr sysctl 8
54variables are available in addition to those available to all
55.Xr sound 4
56devices:
57.Bl -tag -width ".Va hw.snd.pcm%d.latency_timer" -offset indent
58.It Va hw.snd.pcm%d.latency_timer
59Controls the PCI latency timer setting.
60Increasing this value will solve most popping and crackling issues
61(especially on VIA motherboards).
62.It Va hw.snd.pcm%d.spdif_enabled
63Enables S/PDIF output on the primary playback channel.
64This
65.Xr sysctl 8
66variable is available only if the device is known to support S/PDIF output.
67.It Va dev.pcm.%d.polling
68Experimental polling mode, where the driver operates by querying the device
69state on each tick using
70.Xr callout 9 .
71Polling is disabled by default.
72Do not enable it unless you are facing weird interrupt problems or if the
73device cannot generate interrupts at all.
74.El
75.Sh HARDWARE
76The
77.Nm
78driver supports the following sound cards:
79.Pp
80.Bl -bullet -compact
81.It
82Creative CT5880-A
83.It
84Creative CT5880-C
85.It
86Creative CT5880-D
87.It
88Creative CT5880-E
89.It
90Creative SB AudioPCI CT4730
91.It
92Ensoniq AudioPCI ES1370
93.It
94Ensoniq AudioPCI ES1371-A
95.It
96Ensoniq AudioPCI ES1371-B
97.It
98Ensoniq AudioPCI ES1373-A
99.It
100Ensoniq AudioPCI ES1373-B
101.It
102Ensoniq AudioPCI ES1373-8
103.El
104.Sh SEE ALSO
105.Xr sound 4
106.Sh HISTORY
107The
108.Nm
109device driver first appeared in
110.Fx 4.0 .
111.Sh AUTHORS
112.An Russell Cattelan Aq Mt cattelan@thebarn.com
113.An Cameron Grant Aq Mt cg@FreeBSD.org
114.An Joachim Kuebart
115.An Jonathan Noack Aq Mt noackjr@alumni.rice.edu
116