patch-2.4.2 linux/Documentation/sound/AWE32

• Lines: 154
• Date: Fri Feb 16 15:53:08 2001
• Orig file: v2.4.1/linux/Documentation/sound/AWE32
• Orig date: Tue Apr 11 19:13:15 2000

diff -u --recursive --new-file v2.4.1/linux/Documentation/sound/AWE32 linux/Documentation/sound/AWE32
@@ -3,103 +3,74 @@
 This documentation is devoted to the Creative Sound Blaster AWE32, AWE64 and 
 SB32.
 
-1) Make sure you have an ORIGINAL Creative SB32, AWE32 or AWE64 card. This is 
-important, because the driver works only with real Creative cards.
+1) Make sure you have an ORIGINAL Creative SB32, AWE32 or AWE64 card. This
+   is important, because the driver works only with real Creative cards.
 
-2) If your card is NOT "Plug-n-Play" then go to 5th step now. In the other case
-proceed to step 3.
+2) The first thing you need to do is re-compile your kernel with support for
+   your sound card. Run your favourite tool to configure the kernel and when
+   you get to the "Sound" menu you should enable support for the following:
 
-3) You should compile in kernel ISAPnP support or you should obtain isapnptools.
-If you choose kernel level ISAPnP skip to step 5. I looked through other PnP 
-packages for Linux, but all they are either in deep unstable beta/alpha releases
-or they are much worse than isapnptools. In my case isapnptools were included in
-a Linux distribution (Red Hat 5.x). If you also already have them then go to 
-step 4.
+   Sound card support,
+   OSS sound modules,
+   100% Sound Blaster compatibles (SB16/32/64, ESS, Jazz16) support,
+   AWE32 synth
 
-The latest copy of isapnptools-1.17 is available from 
-ftp://sunsite.unc.edu/pub/Linux/system/hardware/isapnptools-1.17.tgz
-You should gunzip/untar it to something like /usr/local/ 
-(cp isapnptools-1.17.tgz /usr/local/; cd /usr/local/;
-tar -xzf isapnptools-1.17.tgz). 
+   If your card is "Plug and Play" you will also need to enable these two
+   options, found under the "Plug and Play configuration" menu:
 
-Compile the package (make) and install it (make install).
-If something goes wrong check the INSTALL file in isapnptools-1.15 directory.
+   Plug and Play support
+   ISA Plug and Play support
 
-4) Now do a "pnpdump > /etc/isapnp.conf". File /etc/isapnp.conf will contain 
-info about PnP devices you may have. If you want you can read the manual page
-about isapnp.conf file (man isapnp.conf). Most lines of your isapnp.conf file are 
-commented. You should uncomment lines which don't conflict with your 
-configuration.
+   Now compile and install the kernel in normal fashion. If you don't know
+   how to do this you can find instructions for this in the README file
+   located in the root directory of the kernel source.
 
-ATTENTION! Device Audio should have 1 IRQ, 2 DMA and 3 base I/O resources.
-If you don't have such a configuration you should manually add the resources to
-the isapnp.conf file. After editing I got these lines in the Audio device
-section (I ripped out all the comments):
+3) Before you can start playing midi files you will have to load a sound
+   bank file. The utility needed for doing this is called "sfxload", and it
+   is one of the utilities found in a package called "awesfx". If this
+   package is not available in your distribution you can download the AWE
+   snapshot from Creative Labs Open Source website:
 
-"(CONFIGURE CTL0044/1132685 (LD 0 (INT 0 (IRQ 5 (MODE +E))) (DMA 0 (CHANNEL 1))
- (DMA 1 (CHANNEL 5)) (IO 0 (BASE 0x220)) (IO 1 (BASE 0x330)) (IO 2 (BASE 0x388))
- (ACT Y)))"
+   http://www.opensource.creative.com/snapshot.html
 
-(In your case CTL044/1132685 numbers may be other)
+   Once you have unpacked the AWE snapshot you will see a "awesfx"
+   directory. Follow the instructions in awesfx/docs/INSTALL to install the
+   utilities in this package. After doing this, sfxload should be installed
+   as:
 
-Don't forget to uncomment (ACT Y)!
+   /usr/local/bin/sfxload
 
-The next device is the on-board IDE controller. You may enable it if you wish,
-but it will not effect sound.
+   To enable AWE general midi synthesis you should also get the sound bank
+   file for general midi from:
 
-Then WaveTable goes. For some reason Plug-n-Play detects only one I/O port,
-but the wavetable needs THREE! My working string is:
+   http://members.xoom.com/yar/synthgm.sbk.gz
 
-"(CONFIGURE CTL044/1132685 (LD 2 (IO 0 (BASE 0x0620)) (IO 1 (BASE 0x0A20)) 
-(IO 2 (BASE 0x0E20)) (ACT Y) ))"
+   Copy it to a directory of your choice, and unpack it there.
 
-Resources 0x0620, 0x0A20 and 0x0E20 should work. Other on-board devices: 
-Gameport and StereoEnhance are not required to be initialized.
+4) Edit /etc/modules.conf, and insert the following lines at the end of the
+   file:
 
-Now you can execute "isapnp /etc/isapnp.conf". No errors should be reported.
-If you correctly installed isapnptools, then isapnp will run every boot time.
+  alias sound-slot-0 sb
+  alias sound-service-0-1 awe_wave
+  post-install awe_wave /usr/local/bin/sfxload PATH_TO_SOUND_BANK_FILE
 
-5) Now you should recompile the kernel.
+  You will of course have to change "PATH_TO_SOUND_BANK_FILE" to the full
+  path of of the sound bank file. That will enable the Sound Blaster and AWE
+  wave synthesis. To play midi files you should get one of these programs if
+  you don't already have them:
 
-In "make (x,menu)config" select in "Sound":
-"Sound card support", "100% Sound Blaster compatibles (SB16/32/64, ESS, Jazz16) support",
-"Generic OPL2/OPL3 FM synthesizer support" and "FM synthesizer (YM3812/OPL-3) 
-support" as <M> (module).
+  Playmidi:			http://playmidi.openprojects.net
 
-In "make (x,menu)config" select in "Sound":
-select "OSS sound modules" as <M> (module)
-select "AWE32 Synth" as <M> (module)
+  AWEMidi Player (drvmidi)  	Included in the previously mentioned AWE
+  				snapshot.
 
-Now recompile the kernel (make dep; make (b)zImage, b(z)lilo, etc...;
-make modules; make modules_install), update your boot loader (if required) and
-boot new kernel.
+  You will probably have to pass the "-e" switch to playmidi to have it use
+  your midi device. drvmidi should work without switches.
 
-6) If awesfx program is not included in your distribution, then download it 
-from http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/awedrv/index.html#Latest.
-Compile it. Copy sfxload program to /usr/bin. To enable AWE general midi
-synthesis you should also get the sound bank file for general midi from
-http://members.xoom.com/yar/synthgm.sbk.gz. Copy it to /usr and gunzip it there.
+  If something goes wrong please e-mail me. All comments and suggestions are
+  welcome.
 
-7) Edit /etc/modules.conf, inserting at the end of the file:
+		    Yaroslav Rosomakho (alons55@dialup.ptt.ru)
+			    http://www.yar.opennet.ru
 
-alias midi awe_wave
-post-install awe_wave /usr/bin/sfxload /usr/synthfm.sbk
-
-That will enable the Sound Blaster and AWE wave synthesis.
-
-To play midi files you should get one of these programs:
-
-Playmidi 2.4 or higher: http://playmidi.openprojects.net
-Drvmidi: http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/awedrv/index.html#Latest
-
-(These are available at all major Linux FTP sites and may already be
- in your distribution)
-Remember to use -a switch if you have playmidi as a compiled binary (ex. RPM)
-
-If something goes wrong please e-mail me. All comments and suggestions are
-welcome.
-
-			    Yaroslav Rosomakho (alons55@dialup.ptt.ru)
-				    http://www.yar.opennet.ru
-
-Last Updated: 10Apr2000
+Last Updated: Feb 3 2001