source: sbliveos2/trunk/readme.txt@ 151

Last change on this file since 151 was 151, checked in by sandervl, 25 years ago

update

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