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