1Pro Audio Spectrum 16 for 2.3.99 and later
2=========================================
3by Thomas Molina (tmolina@home.com)
4last modified 3 Mar 2001
5Acknowledgement to Axel Boldt (boldt@math.ucsb.edu) for stuff taken
6from Configure.help, Riccardo Facchetti for stuff from README.OSS,
7and others whose names I could not find.
8
9This documentation is relevant for the PAS16 driver (pas2_card.c and
10friends) under kernel version 2.3.99 and later.  If you are
11unfamiliar with configuring sound under Linux, please read the
12Sound-HOWTO, Documentation/sound/oss/Introduction and other
13relevant docs first.
14
15The following information is relevant information from README.OSS
16and legacy docs for the Pro Audio Spectrum 16 (PAS16):
17==================================================================
18
19The pas2_card.c driver supports the following cards --
20Pro Audio Spectrum 16 (PAS16) and compatibles:
21        Pro Audio Spectrum 16
22        Pro Audio Studio 16
23        Logitech Sound Man 16
24        NOTE! The original Pro Audio Spectrum as well as the PAS+ are not
25              and will not be supported by the driver.
26
27The sound driver configuration dialog
28-------------------------------------
29
30Sound configuration starts by making some yes/no questions. Be careful
31when answering to these questions since answering y to a question may
32prevent some later ones from being asked. For example don't answer y to
33the question about (PAS16) if you don't really have a PAS16.  Sound
34configuration may also be made modular by answering m to configuration
35options presented. 
36
37Note also that all questions may not be asked. The configuration program
38may disable some questions depending on the earlier choices. It may also
39select some options automatically as well.
40
41  "ProAudioSpectrum 16 support",
42        - Answer 'y'_ONLY_ if you have a Pro Audio Spectrum _16_,
43          Pro Audio Studio 16 or Logitech SoundMan 16 (be sure that
44          you read the above list correctly). Don't answer 'y' if you
45          have some other card made by Media Vision or Logitech since they
46          are not PAS16 compatible.
47          NOTE! Since 3.5-beta10 you need to enable SB support (next question)
48          if you want to use the SB emulation of PAS16. It's also possible to
49          the emulation if you want to use a true SB card together with PAS16
50          (there is another question about this that is asked later).
51
52  "Generic OPL2/OPL3 FM synthesizer support",
53        - Answer 'y' if your card has a FM chip made by Yamaha (OPL2/OPL3/OPL4).
54	  The PAS16 has an OPL3-compatible FM chip.
55
56With PAS16 you can use two audio device files at the same time. /dev/dsp (and
57/dev/audio) is connected to the 8/16 bit native codec and the /dev/dsp1 (and
58/dev/audio1) is connected to the SB emulation (8 bit mono only).
59
60
61The new stuff for 2.3.99 and later
62============================================================================
63The following configuration options from Documentation/Configure.help
64are relevant to configuring the PAS16:
65
66Sound card support
67CONFIG_SOUND
68  If you have a sound card in your computer, i.e. if it can say more
69  than an occasional beep, say Y. Be sure to have all the information
70  about your sound card and its configuration down (I/O port,
71  interrupt and DMA channel), because you will be asked for it.
72
73  You want to read the Sound-HOWTO, available from
74  http://www.tldp.org/docs.html#howto . General information
75  about the modular sound system is contained in the files
76  Documentation/sound/oss/Introduction. The file
77  Documentation/sound/oss/README.OSS contains some slightly outdated but
78  still useful information as well.
79
80OSS sound modules
81CONFIG_SOUND_OSS
82  OSS is the Open Sound System suite of sound card drivers. They make
83  sound programming easier since they provide a common API. Say Y or M
84  here (the module will be called sound.o) if you haven't found a
85  driver for your sound card above, then pick your driver from the
86  list below.
87
88Persistent DMA buffers
89CONFIG_SOUND_DMAP
90  Linux can often have problems allocating DMA buffers for ISA sound
91  cards on machines with more than 16MB of RAM. This is because ISA
92  DMA buffers must exist below the 16MB boundary and it is quite
93  possible that a large enough free block in this region cannot be
94  found after the machine has been running for a while. If you say Y
95  here the DMA buffers (64Kb) will be allocated at boot time and kept
96  until the shutdown. This option is only useful if you said Y to
97  "OSS sound modules", above. If you said M to "OSS sound modules"
98  then you can get the persistent DMA buffer functionality by passing
99  the command-line argument "dmabuf=1" to the sound.o module.
100
101  Say y here for PAS16.
102
103ProAudioSpectrum 16 support
104CONFIG_SOUND_PAS
105  Answer Y only if you have a Pro Audio Spectrum 16, ProAudio Studio
106  16 or Logitech SoundMan 16 sound card. Don't answer Y if you have
107  some other card made by Media Vision or Logitech since they are not
108  PAS16 compatible.  It is not necessary to enable the  separate
109  Sound Blaster support; it is included in the PAS driver.
110
111  If you compile the driver into the kernel, you have to add
112  "pas2=<io>,<irq>,<dma>,<dma2>,<sbio>,<sbirq>,<sbdma>,<sbdma2>
113  to the kernel command line.
114
115FM Synthesizer (YM3812/OPL-3) support
116CONFIG_SOUND_YM3812
117  Answer Y if your card has a FM chip made by Yamaha (OPL2/OPL3/OPL4).
118  Answering Y is usually a safe and recommended choice, however some
119  cards may have software (TSR) FM emulation. Enabling FM support with
120  these cards may cause trouble (I don't currently know of any such
121  cards, however).
122  Please read the file Documentation/sound/oss/OPL3 if your card has an
123  OPL3 chip.
124  If you compile the driver into the kernel, you have to add
125  "opl3=<io>" to the kernel command line.
126
127  If you compile your drivers into the kernel, you MUST configure 
128  OPL3 support as a module for PAS16 support to work properly.
129  You can then get OPL3 functionality by issuing the command:
130  insmod opl3
131  In addition, you must either add the following line to 
132  /etc/modprobe.conf:
133  options opl3 io=0x388
134  or else add the following line to /etc/lilo.conf:
135  opl3=0x388
136
137
138EXAMPLES
139===================================================================
140To use the PAS16 in my computer I have enabled the following sound
141configuration options:
142
143CONFIG_SOUND=y
144CONFIG_SOUND_OSS=y
145CONFIG_SOUND_TRACEINIT=y
146CONFIG_SOUND_DMAP=y
147CONFIG_SOUND_PAS=y
148CONFIG_SOUND_SB=n
149CONFIG_SOUND_YM3812=m
150
151I have also included the following append line in /etc/lilo.conf:
152append="pas2=0x388,10,3,-1,0x220,5,1,-1 sb=0x220,5,1,-1 opl3=0x388"
153
154The io address of 0x388 is default configuration on the PAS16.  The
155irq of 10 and dma of 3 may not match your installation.  The above 
156configuration enables PAS16, 8-bit Soundblaster and OPL3
157functionality.  If Soundblaster functionality is not desired, the
158following line would be appropriate:
159append="pas2=0x388,10,3,-1,0,-1,-1,-1 opl3=0x388"
160
161If sound is built totally modular, the above options may be 
162specified in /etc/modprobe.conf for pas2, sb and opl3
163respectively. 
164