xref: /openbsd/share/man/man4/man4.i386/sb.4 (revision 7b36286a)
1.\"	$OpenBSD: sb.4,v 1.14 2008/06/26 05:42:07 ray 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: June 26 2008 $
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.Cd "opl* at sb?"
44.Sh DESCRIPTION
45The
46.Nm
47driver supports the
48SoundBlaster 16, Jazz 16, SoundBlaster AWE 32, SoundBlaster AWE 64,
49and hardware register-level compatible audio cards.
50.Pp
51The SoundBlaster series are half-duplex cards, capable of 8- and 16-bit
52audio sample recording and playback at rates up to 44.1kHz (depending on
53the particular model).
54.Pp
55The base I/O port address is usually jumper-selected to either 0x220 or
560x240 (newer cards may provide software configuration, but this driver
57does not directly support them--you must configure the card for its I/O
58addresses with other software).
59The SoundBlaster takes 16 I/O ports.
60For the SoundBlaster and SoundBlaster Pro, the IRQ and DRQ channels are
61jumper-selected.
62For the SoundBlaster 16, the IRQ and DRQ channels are set by this driver
63to the values specified in the config file.
64The IRQ must be selected from the set {5,7,9,10}.
65.Pp
66The configuration file must set the value of
67.Cm flags
68to 1 to enable the Jazz16 support.
69This is to avoid potential conflicts with other devices when probing the
70Jazz 16 because it requires use of extra I/O ports not in the base port range.
71.Pp
72The joystick interface (if enabled by a jumper) is handled by the
73.Xr joy 4
74driver, and the optional SCSI CD-ROM interface is handled by the
75.Xr aic 4
76driver.
77.Sh SEE ALSO
78.Xr aic 4 ,
79.Xr audio 4 ,
80.Xr intro 4 ,
81.Xr isa 4 ,
82.Xr isapnp 4 ,
83.Xr joy 4 ,
84.Xr midi 4 ,
85.Xr opl 4 ,
86.Xr wss 4
87.Sh HISTORY
88The
89.Nm
90device driver appeared in
91.Nx 1.0 .
92.Sh BUGS
93With a SoundBlaster 16 card the device is full duplex, but it can
94only sensibly handle a precision of 8 bits.
95It does so by extending
96the output 8 bit samples to 16 bits and using the 8 bit DMA channel
97for input and the 16 bit channel for output.
98.Pp
99The non-SCSI CD-ROM interfaces found on some older cards are not supported.
100