| 1 | SoundBlaster Live! OS/2 Audio driver version 0.60 (beta)
|
|---|
| 2 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|---|
| 3 |
|
|---|
| 4 | Contents
|
|---|
| 5 | ========
|
|---|
| 6 | 1 Description
|
|---|
| 7 | 2 Features
|
|---|
| 8 | 3 History
|
|---|
| 9 | 4 Requirements
|
|---|
| 10 | 5 Installation/uninstall
|
|---|
| 11 | 6 Config.sys options
|
|---|
| 12 | 7 Known problems
|
|---|
| 13 | 8 File listing
|
|---|
| 14 | 9 Source code
|
|---|
| 15 | 10 Contacting the author
|
|---|
| 16 | 10.1 SoundBlaster Live OS/2 mailinglist
|
|---|
| 17 | 11 Warranty
|
|---|
| 18 |
|
|---|
| 19 |
|
|---|
| 20 | 1 Description
|
|---|
| 21 | =============
|
|---|
| 22 | This is the port of the open source Creative Labs SoundBlaster Live Linux audio
|
|---|
| 23 | driver.
|
|---|
| 24 | Although the driver is almost feature complete, it should still be considered
|
|---|
| 25 | beta software. (see the warranty section)
|
|---|
| 26 |
|
|---|
| 27 | This work would never have been possible without the support by Creative Labs
|
|---|
| 28 | and the current maintainers of the Linux driver.
|
|---|
| 29 |
|
|---|
| 30 |
|
|---|
| 31 | 2 Features
|
|---|
| 32 | ==========
|
|---|
| 33 | - Up to 32 simultaneous wave playback streams
|
|---|
| 34 | - One record stream
|
|---|
| 35 | - Full duplex
|
|---|
| 36 | - Support for the IOCTL90 mixer interface (designed by Joe Nord of
|
|---|
| 37 | Crystal Semiconductor and supported by the Crystal OS/2 audio drivers)
|
|---|
| 38 | - RTMIDI playback & recording
|
|---|
| 39 |
|
|---|
| 40 |
|
|---|
| 41 | 3 History
|
|---|
| 42 | =========
|
|---|
| 43 | 0.60
|
|---|
| 44 | - Fixed video mixer control
|
|---|
| 45 | - Changed wave volume level
|
|---|
| 46 | - Fixed clicks when playing wave files with large audio buffers
|
|---|
| 47 |
|
|---|
| 48 | 0.50
|
|---|
| 49 | - Added RTMIDI playback & recording (MPU401)
|
|---|
| 50 | - Manually detect SB Live! hardware
|
|---|
| 51 | - Bugfix for TRAP D when starting playback/recording
|
|---|
| 52 |
|
|---|
| 53 | 0.25
|
|---|
| 54 | - First public beta release
|
|---|
| 55 |
|
|---|
| 56 |
|
|---|
| 57 | 4 Requirements
|
|---|
| 58 | ==============
|
|---|
| 59 | - OS/2 Warp 4 or Warp Server for e-Business
|
|---|
| 60 | (Warp 3 not tested)
|
|---|
| 61 | - Creative Labs SoundBlaster Live! soundcard
|
|---|
| 62 |
|
|---|
| 63 |
|
|---|
| 64 | 5 Installation/uninstall
|
|---|
| 65 | ========================
|
|---|
| 66 | To install the SB Live driver:
|
|---|
| 67 | - Unzip driver archive
|
|---|
| 68 | - Run install.cmd
|
|---|
| 69 | - Select 'SoundBlaster Live! Wave Audio' and continue installation
|
|---|
| 70 | - Reboot
|
|---|
| 71 |
|
|---|
| 72 | To remove the SB Live driver you should proceed with the installation
|
|---|
| 73 | as described above, but select zero SB Live cards when asked.
|
|---|
| 74 |
|
|---|
| 75 | 6 Config.sys options
|
|---|
| 76 | ====================
|
|---|
| 77 | DEVICE=J:\MMOS2\SBLIVE16.SYS /V /C /M /L
|
|---|
| 78 | - /V: verbose (prints copyrights during driver init)
|
|---|
| 79 | - /C: enable CD audio input
|
|---|
| 80 | - /M: enable microphone audio input
|
|---|
| 81 | - /L: enable linein audio input
|
|---|
| 82 |
|
|---|
| 83 | DEVICE=J:\MMOS2\SBLIVE32.SYS /D
|
|---|
| 84 | - /D: print start and end address of code
|
|---|
| 85 | (useful to locate the code that causes a trap (CS:EIP in trapscreen))
|
|---|
| 86 |
|
|---|
| 87 | The installation adds the verbose and CD settings to the config.sys line.
|
|---|
| 88 |
|
|---|
| 89 |
|
|---|
| 90 | 7 Known problems
|
|---|
| 91 | ================
|
|---|
| 92 | - Users have reported that sometimes applications can no longer play audio
|
|---|
| 93 | (unable to load mdm.dll). This apparently happens from time to time (requiring
|
|---|
| 94 | a reboot), but I have not been able to reproduce this myself.
|
|---|
| 95 | If you find a way to reliably reproduce this, please contact the author.
|
|---|
| 96 | (see section 9)
|
|---|
| 97 | - Small distortions when recording at 44.1khz 16 bits stereo
|
|---|
| 98 | - Crash in PMMERGE when installing the driver on a system that uses the Scitech
|
|---|
| 99 | display drivers.
|
|---|
| 100 | Workaround: move the first minstall window (which asks you to select the sb
|
|---|
| 101 | driver) almost completely outside of the screen and press enter.
|
|---|
| 102 | - No sound when there are still inactive audio drivers in MMOS2\mmpm2.ini.
|
|---|
| 103 | To correct the problem uninstall the SB Live and your old audio driver.
|
|---|
| 104 | You can also manually remove references to the old driver:
|
|---|
| 105 | - uninstall the SB Live driver
|
|---|
| 106 | - edit MMOS2\mmpm2.ini
|
|---|
| 107 | - search for 'Waveaudio=' section and remove any names that
|
|---|
| 108 | are listed on that line
|
|---|
| 109 | - search for 'Ampmix=' section and remove any names that
|
|---|
| 110 | are listed on that line
|
|---|
| 111 | (result: Waveaudio=
|
|---|
| 112 | Ampmix=
|
|---|
| 113 | )
|
|---|
| 114 | - reinstall the SB Live driver
|
|---|
| 115 | MMOS2\mmpm2.ini should now contain:
|
|---|
| 116 | Waveaudio=SBLIVEWAVE01
|
|---|
| 117 | Ampmix=SBLIVEAMPMIX01
|
|---|
| 118 | - reboot
|
|---|
| 119 |
|
|---|
| 120 | 8 File listing
|
|---|
| 121 | ==============
|
|---|
| 122 | Installation files:
|
|---|
| 123 | audfiles.scr
|
|---|
| 124 | audplay.ico
|
|---|
| 125 | AUDHELP.HLP
|
|---|
| 126 | CARDINFO.dll
|
|---|
| 127 | control.scr
|
|---|
| 128 | midiplay.ico
|
|---|
| 129 | vidplay.ico
|
|---|
| 130 |
|
|---|
| 131 | 16 bits MMPM/2 audio driver:
|
|---|
| 132 | sblive16.sys
|
|---|
| 133 |
|
|---|
| 134 | 32 bits SB Live Core audio driver:
|
|---|
| 135 | sblive32w4.sys
|
|---|
| 136 |
|
|---|
| 137 | 32 bits SB Live Core audio driver:
|
|---|
| 138 | (uses the new KEE api found in Warp 4 + Fixpack 13 or Warp Server for
|
|---|
| 139 | e-Business)
|
|---|
| 140 | sblive32kee.sys
|
|---|
| 141 |
|
|---|
| 142 |
|
|---|
| 143 | 9 Source code
|
|---|
| 144 | =============
|
|---|
| 145 | As this driver is based on the open source SoundBlaster Live Linux driver,
|
|---|
| 146 | the source code is available under the GNU LIBRARY GENERAL PUBLIC LICENSE.
|
|---|
| 147 | The CVS repository is located at the Netlabs server:
|
|---|
| 148 | set CVSROOT=:pserver:guest@www.netlabs.org:d:/netlabs.src/sbliveos2
|
|---|
| 149 | set USER=guest
|
|---|
| 150 |
|
|---|
| 151 | Login as 'guest' with password 'readonly'.
|
|---|
| 152 |
|
|---|
| 153 |
|
|---|
| 154 | 10 Contacting the author
|
|---|
| 155 | =======================
|
|---|
| 156 | When you find a bug in the driver, you can contact the author by
|
|---|
| 157 | email at sandervl@xs4all.nl.
|
|---|
| 158 | Bug reports should include the following information:
|
|---|
| 159 | - SoundBlaster Live model
|
|---|
| 160 | - OS/2 version + fixpack level
|
|---|
| 161 | - Description of the procedure to reproduce the bug
|
|---|
| 162 | - Trap description (register contents) (if you're reporting a crash)
|
|---|
| 163 | Add the /D option to the sblive32.sys config.sys line and write down
|
|---|
| 164 | the start & end address printed during the driver initialization.
|
|---|
| 165 |
|
|---|
| 166 | Please note that I do *not* want people to mail me about problems that
|
|---|
| 167 | aren't clearly bugs in the driver. There is a mailinglist at egroups.com
|
|---|
| 168 | that can be used for general questions about the driver.
|
|---|
| 169 |
|
|---|
| 170 | Also, do NOT mail the Linux authors about problems with the OS/2 driver.
|
|---|
| 171 | If a problem in the driver turns out to be a bug in their code, then I will
|
|---|
| 172 | contact them.
|
|---|
| 173 |
|
|---|
| 174 |
|
|---|
| 175 | 10.1 SoundBlaster Live OS/2 mailinglist
|
|---|
| 176 | ======================================
|
|---|
| 177 | A mailinglist to discuss the OS/2 sblive driver has been created at egroups.com.
|
|---|
| 178 | Go to www.egroups.com to subscribe to sbliveos2@egroups.com.
|
|---|
| 179 |
|
|---|
| 180 |
|
|---|
| 181 | 11 Warranty
|
|---|
| 182 | ===========
|
|---|
| 183 | EXCEPT AS OTHERWISE RESTRICTED BY LAW, THIS WORK IS PROVIDED
|
|---|
| 184 | WITHOUT ANY EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND, INCLUDING
|
|---|
| 185 | BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF FITNESS FOR A
|
|---|
| 186 | PARTICULAR PURPOSE, MERCHANTABILITY OR TITLE. EXCEPT AS
|
|---|
| 187 | OTHERWISE PROVIDED BY LAW, NO AUTHOR, COPYRIGHT HOLDER OR
|
|---|
| 188 | LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES OF ANY KIND, EVEN IF
|
|---|
| 189 | THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
|---|
