xref: /openbsd/share/man/man4/man4.i386/sb.4 (revision 3cab2bb3)
1.\"	$OpenBSD: sb.4,v 1.16 2016/08/31 13:54:58 jmc Exp $
2.\"	$NetBSD: sb.4,v 1.13 1997/10/31 15:02:33 augustss Exp $
3.\"
4.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
5.\" All rights reserved.
6.\"
7.\" This code is derived from software contributed to The NetBSD Foundation
8.\" by John T. Kohl.
9.\"
10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions
12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright
14.\"    notice, this list of conditions and the following disclaimer.
15.\" 2. Redistributions in binary form must reproduce the above copyright
16.\"    notice, this list of conditions and the following disclaimer in the
17.\"    documentation and/or other materials provided with the distribution.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
23.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29.\" POSSIBILITY OF SUCH DAMAGE.
30.\"
31.Dd $Mdocdate: August 31 2016 $
32.Dt SB 4 i386
33.Os
34.Sh NAME
35.Nm sb
36.Nd SoundBlaster family audio device
37.Sh SYNOPSIS
38.Cd "sb0 at isa? port 0x220 irq 5 drq 1"
39.Cd "sb1 at isa? port 0x240 irq 7 drq 1 flags 1"
40.Cd "sb* at isapnp?"
41.Cd "audio* at sb?"
42.Cd "midi* at sb?" Pq "MPU401 port"
43.Sh DESCRIPTION
44The
45.Nm
46driver supports the
47SoundBlaster 16, Jazz 16, SoundBlaster AWE 32, SoundBlaster AWE 64,
48and hardware register-level compatible audio cards.
49.Pp
50The SoundBlaster series are half-duplex cards, capable of 8- and 16-bit
51audio sample recording and playback at rates up to 44.1kHz (depending on
52the particular model).
53.Pp
54The base I/O port address is usually jumper-selected to either 0x220 or
550x240 (newer cards may provide software configuration, but this driver
56does not directly support them--you must configure the card for its I/O
57addresses with other software).
58The SoundBlaster takes 16 I/O ports.
59For the SoundBlaster and SoundBlaster Pro, the IRQ and DRQ channels are
60jumper-selected.
61For the SoundBlaster 16, the IRQ and DRQ channels are set by this driver
62to the values specified in the config file.
63The IRQ must be selected from the set {5,7,9,10}.
64.Pp
65The configuration file must set the value of
66.Cm flags
67to 1 to enable the Jazz16 support.
68This is to avoid potential conflicts with other devices when probing the
69Jazz 16 because it requires use of extra I/O ports not in the base port range.
70.Pp
71The joystick interface (if enabled by a jumper) is handled by the
72.Xr joy 4
73driver, and the optional SCSI CD-ROM interface is handled by the
74.Xr aic 4
75driver.
76.Sh SEE ALSO
77.Xr aic 4 ,
78.Xr audio 4 ,
79.Xr intro 4 ,
80.Xr isa 4 ,
81.Xr isapnp 4 ,
82.Xr joy 4 ,
83.Xr midi 4
84.Sh HISTORY
85The
86.Nm
87device driver appeared in
88.Nx 1.0 .
89.Sh BUGS
90With a SoundBlaster 16 card the device is full duplex, but it can
91only sensibly handle a precision of 8 bits.
92It does so by extending
93the output 8 bit samples to 16 bits and using the 8 bit DMA channel
94for input and the 16 bit channel for output.
95.Pp
96The non-SCSI CD-ROM interfaces found on some older cards are not supported.
97