1.\" $NetBSD: eap.4,v 1.20 2024/05/16 17:00:31 nia Exp $ 2.\" 3.\" Copyright (c) 1999 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Lennart Augustsson. 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 May 16, 2024 31.Dt EAP 4 32.Os 33.Sh NAME 34.Nm eap 35.Nd AudioPCI audio device driver 36.Sh SYNOPSIS 37.Cd "eap* at pci? dev ? function ?" 38.Cd "options EAP_USE_BOTH_DACS" 39.Pp 40.Cd "audio* at audiobus?" 41.Cd "joy* at eap?" 42.Cd "midi* at eap?" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for the Ensoniq AudioPCI and Creative Labs 47SoundBlaster PCI series of audio cards. 48All models based on the ES1370, ES1371, and ES1373 chips are supported. 49.Pp 50By specifying: 51.Pp 52.D1 Cd options EAP_USE_BOTH_DACS 53.Pp 54a second audio device is attached. 55This can be used for audio output simultaneously with the primary DAC. 56You can use it simply by directing audio output to the additional 57.Pa /dev/audioX 58device associated with it. 59.Sh SEE ALSO 60.Xr ac97 4 , 61.Xr audio 4 , 62.Xr joy 4 , 63.Xr midi 4 , 64.Xr pci 4 65.Sh HISTORY 66The 67.Nm 68device driver appeared in 69.Nx 1.4 . 70.Sh CAVEATS 71The joystick port hardware works by emulating a legacy 72.Xr isa 4 73joystick port, bypassing the 74.Xr pci 4 75bus method for address allocation. 76This is unlikely to work on PCI busses other than the primary one. 77There is also a possibility for conflicts with real ISA devices 78because the PCI bus is probed before ISA. 79Use with caution. 80.Pp 81The 82.Dv EAP_USE_BOTH_DACS 83option is rather redundant after the introduction of the in-kernel audio 84mixer, and may be removed in a future release. 85It is possible that it could be used to accelerate mixing streams by 86taking advantage of the hardware's features, but currently the 87additional (small) overhead of the kernel mixer is impossible to bypass, 88since 89.Nx 90no longer allows userspace software to write directly to audio hardware. 91The 92.Nm 93hardware only features one clock, so generally the second audio device 94must be configured in the same way as the first. 95