| [188] | 1 | SoundBlaster Live! OS/2 Audio driver version 0.75 (beta)
|
|---|
| [148] | 2 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|---|
| 3 |
|
|---|
| 4 | Contents
|
|---|
| 5 | ========
|
|---|
| [152] | 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
|
|---|
| [148] | 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)
|
|---|
| [151] | 38 | - RTMIDI playback & recording
|
|---|
| [188] | 39 | --> Note: this is not the same as midi playback via MMPM/2 (midi applet)
|
|---|
| 40 | Playing midi files requires an external MIDI device
|
|---|
| [148] | 41 |
|
|---|
| 42 |
|
|---|
| [152] | 43 | 3 History
|
|---|
| 44 | =========
|
|---|
| [188] | 45 | 0.75
|
|---|
| 46 | - Put back joystick code
|
|---|
| 47 | - Fix for playing small wave files
|
|---|
| 48 |
|
|---|
| 49 | 0.70
|
|---|
| 50 | - Fail to load if resource manager returned error while allocating resources.
|
|---|
| 51 | (prevents SB Live driver from allocating irq when the (e.g.) the USB driver
|
|---|
| 52 | has already claimed exclusive access)
|
|---|
| 53 | - Added new DirectAudio interface used by Odin for wave playback
|
|---|
| 54 |
|
|---|
| [153] | 55 | 0.60
|
|---|
| [188] | 56 | - Fixed detection of SB Live on some systems
|
|---|
| [153] | 57 | - Fixed video mixer control
|
|---|
| 58 | - Changed wave volume level
|
|---|
| 59 | - Fixed clicks when playing wave files with large audio buffers
|
|---|
| [188] | 60 | - Print joystick port during init + register joystick device + it's resources
|
|---|
| [153] | 61 |
|
|---|
| [152] | 62 | 0.50
|
|---|
| 63 | - Added RTMIDI playback & recording (MPU401)
|
|---|
| 64 | - Manually detect SB Live! hardware
|
|---|
| 65 | - Bugfix for TRAP D when starting playback/recording
|
|---|
| 66 |
|
|---|
| 67 | 0.25
|
|---|
| 68 | - First public beta release
|
|---|
| 69 |
|
|---|
| 70 |
|
|---|
| 71 | 4 Requirements
|
|---|
| [148] | 72 | ==============
|
|---|
| 73 | - OS/2 Warp 4 or Warp Server for e-Business
|
|---|
| 74 | (Warp 3 not tested)
|
|---|
| [188] | 75 | - Creative Labs SoundBlaster Live! or
|
|---|
| 76 | Creative Labs SoundBlaster PCI 512 soundcard
|
|---|
| [148] | 77 |
|
|---|
| 78 |
|
|---|
| [152] | 79 | 5 Installation/uninstall
|
|---|
| [151] | 80 | ========================
|
|---|
| 81 | To install the SB Live driver:
|
|---|
| [188] | 82 | - Make sure your BIOS configures the SB Live! card (assigns IRQ and IO addresses)
|
|---|
| 83 | Look for a 'PnP OS' (or similar) setting in your BIOS options and set it to
|
|---|
| 84 | 'No' or 'Off'.
|
|---|
| 85 | The SB Live! driver does not work if the BIOS doesn't assign hardware
|
|---|
| 86 | resources to the card.
|
|---|
| [148] | 87 | - Unzip driver archive
|
|---|
| 88 | - Run install.cmd
|
|---|
| 89 | - Select 'SoundBlaster Live! Wave Audio' and continue installation
|
|---|
| 90 | - Reboot
|
|---|
| 91 |
|
|---|
| [151] | 92 | To remove the SB Live driver you should proceed with the installation
|
|---|
| 93 | as described above, but select zero SB Live cards when asked.
|
|---|
| [148] | 94 |
|
|---|
| [188] | 95 | To use the SB Live's joystick port you need to install one of the
|
|---|
| 96 | OS/2 joystick drivers and tell it to you the IO port that the
|
|---|
| 97 | sb live driver prints during boot.
|
|---|
| 98 | I.e.: Sblive16 prints this during boot:
|
|---|
| 99 | SB Live! joystick at : 0xE400
|
|---|
| 100 | Change the joystick port address to E400 for the gamedd2 driver:
|
|---|
| 101 | DEVICE=C:\GAMEDD.SYS /P:E400 /W:400 /C:1E
|
|---|
| 102 |
|
|---|
| 103 | Note that this is not an ideal solution as the SB Live's joystick
|
|---|
| 104 | port address can be changed by the BIOS when hardware is added or
|
|---|
| 105 | removed.
|
|---|
| 106 | However, it's safer than mapping it to the standard joystick port address
|
|---|
| 107 | (i.e. 0x201) due to the risk of a conflict with other (audio) hardware.
|
|---|
| 108 |
|
|---|
| 109 |
|
|---|
| [152] | 110 | 6 Config.sys options
|
|---|
| [148] | 111 | ====================
|
|---|
| 112 | DEVICE=J:\MMOS2\SBLIVE16.SYS /V /C /M /L
|
|---|
| 113 | - /V: verbose (prints copyrights during driver init)
|
|---|
| [188] | 114 | - /C: enable CD audio input (default muted; can be changed with mixer app)
|
|---|
| 115 | - /M: enable microphone audio input (default muted; can be changed with mixer app)
|
|---|
| 116 | - /L: enable linein audio input (default muted; can be changed with mixer app)
|
|---|
| [148] | 117 |
|
|---|
| [151] | 118 | DEVICE=J:\MMOS2\SBLIVE32.SYS /D
|
|---|
| 119 | - /D: print start and end address of code
|
|---|
| 120 | (useful to locate the code that causes a trap (CS:EIP in trapscreen))
|
|---|
| 121 |
|
|---|
| [148] | 122 | The installation adds the verbose and CD settings to the config.sys line.
|
|---|
| 123 |
|
|---|
| 124 |
|
|---|
| [152] | 125 | 7 Known problems
|
|---|
| [148] | 126 | ================
|
|---|
| 127 | - Users have reported that sometimes applications can no longer play audio
|
|---|
| 128 | (unable to load mdm.dll). This apparently happens from time to time (requiring
|
|---|
| 129 | a reboot), but I have not been able to reproduce this myself.
|
|---|
| 130 | If you find a way to reliably reproduce this, please contact the author.
|
|---|
| 131 | (see section 9)
|
|---|
| 132 | - Crash in PMMERGE when installing the driver on a system that uses the Scitech
|
|---|
| 133 | display drivers.
|
|---|
| 134 | Workaround: move the first minstall window (which asks you to select the sb
|
|---|
| 135 | driver) almost completely outside of the screen and press enter.
|
|---|
| [151] | 136 | - No sound when there are still inactive audio drivers in MMOS2\mmpm2.ini.
|
|---|
| 137 | To correct the problem uninstall the SB Live and your old audio driver.
|
|---|
| 138 | You can also manually remove references to the old driver:
|
|---|
| 139 | - uninstall the SB Live driver
|
|---|
| 140 | - edit MMOS2\mmpm2.ini
|
|---|
| 141 | - search for 'Waveaudio=' section and remove any names that
|
|---|
| 142 | are listed on that line
|
|---|
| 143 | - search for 'Ampmix=' section and remove any names that
|
|---|
| 144 | are listed on that line
|
|---|
| 145 | (result: Waveaudio=
|
|---|
| 146 | Ampmix=
|
|---|
| 147 | )
|
|---|
| 148 | - reinstall the SB Live driver
|
|---|
| 149 | MMOS2\mmpm2.ini should now contain:
|
|---|
| 150 | Waveaudio=SBLIVEWAVE01
|
|---|
| 151 | Ampmix=SBLIVEAMPMIX01
|
|---|
| 152 | - reboot
|
|---|
| [148] | 153 |
|
|---|
| [188] | 154 | - IRQ conflicts can occurs with drivers that are unable to share their interrupt.
|
|---|
| 155 | (the USB drivers have this problem, but only on some systems)
|
|---|
| 156 | The SBLive driver can detect some of these conflicts and will print the
|
|---|
| 157 | following messages:
|
|---|
| 158 | Another device driver was granted exclusive access to IRQ xx
|
|---|
| 159 | Unable to allocate hardware resources! Aborting...
|
|---|
| 160 |
|
|---|
| 161 | When you see this message, you must force the BIOS to allocate another
|
|---|
| 162 | interrupt for the sblive driver.
|
|---|
| 163 |
|
|---|
| 164 |
|
|---|
| [152] | 165 | 8 File listing
|
|---|
| [148] | 166 | ==============
|
|---|
| 167 | Installation files:
|
|---|
| [151] | 168 | audfiles.scr
|
|---|
| 169 | audplay.ico
|
|---|
| 170 | AUDHELP.HLP
|
|---|
| 171 | CARDINFO.dll
|
|---|
| 172 | control.scr
|
|---|
| 173 | midiplay.ico
|
|---|
| 174 | vidplay.ico
|
|---|
| [148] | 175 |
|
|---|
| 176 | 16 bits MMPM/2 audio driver:
|
|---|
| [151] | 177 | sblive16.sys
|
|---|
| [148] | 178 |
|
|---|
| 179 | 32 bits SB Live Core audio driver:
|
|---|
| [151] | 180 | sblive32w4.sys
|
|---|
| [148] | 181 |
|
|---|
| 182 | 32 bits SB Live Core audio driver:
|
|---|
| 183 | (uses the new KEE api found in Warp 4 + Fixpack 13 or Warp Server for
|
|---|
| 184 | e-Business)
|
|---|
| [151] | 185 | sblive32kee.sys
|
|---|
| [148] | 186 |
|
|---|
| 187 |
|
|---|
| [152] | 188 | 9 Source code
|
|---|
| [148] | 189 | =============
|
|---|
| 190 | As this driver is based on the open source SoundBlaster Live Linux driver,
|
|---|
| 191 | the source code is available under the GNU LIBRARY GENERAL PUBLIC LICENSE.
|
|---|
| 192 | The CVS repository is located at the Netlabs server:
|
|---|
| 193 | set CVSROOT=:pserver:guest@www.netlabs.org:d:/netlabs.src/sbliveos2
|
|---|
| 194 | set USER=guest
|
|---|
| 195 |
|
|---|
| 196 | Login as 'guest' with password 'readonly'.
|
|---|
| 197 |
|
|---|
| 198 |
|
|---|
| [152] | 199 | 10 Contacting the author
|
|---|
| [148] | 200 | =======================
|
|---|
| 201 | When you find a bug in the driver, you can contact the author by
|
|---|
| 202 | email at sandervl@xs4all.nl.
|
|---|
| 203 | Bug reports should include the following information:
|
|---|
| 204 | - SoundBlaster Live model
|
|---|
| 205 | - OS/2 version + fixpack level
|
|---|
| 206 | - Description of the procedure to reproduce the bug
|
|---|
| [151] | 207 | - Trap description (register contents) (if you're reporting a crash)
|
|---|
| 208 | Add the /D option to the sblive32.sys config.sys line and write down
|
|---|
| 209 | the start & end address printed during the driver initialization.
|
|---|
| [148] | 210 |
|
|---|
| 211 | Please note that I do *not* want people to mail me about problems that
|
|---|
| 212 | aren't clearly bugs in the driver. There is a mailinglist at egroups.com
|
|---|
| 213 | that can be used for general questions about the driver.
|
|---|
| 214 |
|
|---|
| 215 | Also, do NOT mail the Linux authors about problems with the OS/2 driver.
|
|---|
| 216 | If a problem in the driver turns out to be a bug in their code, then I will
|
|---|
| 217 | contact them.
|
|---|
| 218 |
|
|---|
| 219 |
|
|---|
| [152] | 220 | 10.1 SoundBlaster Live OS/2 mailinglist
|
|---|
| [148] | 221 | ======================================
|
|---|
| [188] | 222 | A mailinglist to discuss the OS/2 sblive driver has been created at yahoogroups.com.
|
|---|
| 223 | Go to www.yahoogroups.com to subscribe to sbliveos2@yahoogroups.com.
|
|---|
| [148] | 224 |
|
|---|
| 225 |
|
|---|
| [152] | 226 | 11 Warranty
|
|---|
| [148] | 227 | ===========
|
|---|
| 228 | EXCEPT AS OTHERWISE RESTRICTED BY LAW, THIS WORK IS PROVIDED
|
|---|
| 229 | WITHOUT ANY EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND, INCLUDING
|
|---|
| 230 | BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF FITNESS FOR A
|
|---|
| 231 | PARTICULAR PURPOSE, MERCHANTABILITY OR TITLE. EXCEPT AS
|
|---|
| 232 | OTHERWISE PROVIDED BY LAW, NO AUTHOR, COPYRIGHT HOLDER OR
|
|---|
| 233 | LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES OF ANY KIND, EVEN IF
|
|---|
| 234 | THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
|---|
