share/man/man4/snd_es137x.4

   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 .\" $FreeBSD$
  26 .\"
  27 .Dd November 29, 2006
  28 .Dt SND_ES137X 4
  29 .Os
  30 .Sh NAME
  31 .Nm snd_es137x
  32 .Nd "Ensoniq AudioPCI ES137x bridge device driver"
  33 .Sh SYNOPSIS
  34 To compile this driver into the kernel, place the following lines in your
  35 kernel configuration file:
  36 .Bd -ragged -offset indent
  37 .Cd "device sound"
  38 .Cd "device snd_es137x"
  39 .Ed
  40 .Pp
  41 Alternatively, to load the driver as a module at boot time, place the
  42 following line in
  43 .Xr loader.conf 5 :
  44 .Bd -literal -offset indent
  45 snd_es137x_load="YES"
  46 .Ed
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 bridge driver allows the generic audio driver
  51 .Xr sound 4
  52 to attach to the Ensoniq 137x audio cards.
  53 .Ss Runtime Configuration
  54 The following
  55 .Xr sysctl 8
  56 variables are available in addition to those available to all
  57 .Xr sound 4
  58 devices:
  59 .Bl -tag -width ".Va hw.snd.pcm%d.latency_timer" -offset indent
  60 .It Va hw.snd.pcm%d.latency_timer
  61 Controls the PCI latency timer setting.
  62 Increasing this value will solve most popping and crackling issues
  63 (especially on VIA motherboards).
  64 .It Va hw.snd.pcm%d.spdif_enabled
  65 Enables S/PDIF output on the primary playback channel.
  66 This
  67 .Xr sysctl 8
  68 variable is available only if the device is known to support S/PDIF output.
  69 .It Va dev.pcm.%d.polling
  70 Experimental polling mode, where the driver operates by querying the device
  71 state on each tick using
  72 .Xr callout 9 .
  73 Polling is disabled by default.
  74 Do not enable it unless you are facing weird interrupt problems or if the
  75 device cannot generate interrupts at all.
  76 .El
  77 .Sh HARDWARE
  78 The
  79 .Nm
  80 driver supports the following sound cards:
  81 .Pp
  82 .Bl -bullet -compact
  83 .It
  84 Creative CT5880-A
  85 .It
  86 Creative CT5880-C
  87 .It
  88 Creative CT5880-D
  89 .It
  90 Creative CT5880-E
  91 .It
  92 Creative SB AudioPCI CT4730
  93 .It
  94 Ensoniq AudioPCI ES1370
  95 .It
  96 Ensoniq AudioPCI ES1371-A
  97 .It
  98 Ensoniq AudioPCI ES1371-B
  99 .It
 100 Ensoniq AudioPCI ES1373-A
 101 .It
 102 Ensoniq AudioPCI ES1373-B
 103 .It
 104 Ensoniq AudioPCI ES1373-8
 105 .El
 106 .Sh SEE ALSO
 107 .Xr sound 4
 108 .Sh HISTORY
 109 The
 110 .Nm
 111 device driver first appeared in
 112 .Fx 4.0 .
 113 .Sh AUTHORS
 114 .An "Russell Cattelan" Aq cattelan@thebarn.com
 115 .An "Cameron Grant" Aq cg@FreeBSD.org
 116 .An "Joachim Kuebart"
 117 .An "Jonathan Noack" Aq noackjr@alumni.rice.edu