home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / PROGRAM / SBDOS10.ZIP / README < prev    next >
Text File  |  1992-06-13  |  7KB  |  177 lines
  1.                Sound Blaster Pro(tm) BSD Unix device driver
  2.                             RELEASE NOTES
  3.                                  v1.4
  4.  
  5.                  Steve Haehnichen <shaehnic@ucsd.edu>
  6.  
  7.      $Id: README,v 1.1 1992/06/13 01:44:40 steve Exp steve $
  8.               [ This file is a part of SBlast-BSD-1.4 ]
  9.  
  10.     These note accompany the third Beta release of my Sound Blaster Pro
  11.     device driver for BSD Unix v4.3.
  12.  
  13.     The purpose of this release is to get feedback on the software.
  14.     If you have questions or errors about ANYTHING in this package, please
  15.     let me know so that I can answer them for when this is publicly
  16.     distributed.  This includes errors in the code and documentation.
  17.     Thanks in advance for your help.
  18.  
  19.  
  20. WHY?
  21. ----
  22. One of the major forces tying people to systems like MS-DOS is lack of
  23. hardware support under other operating systems.  With the recent
  24. release of a free BSD 4.3 for the 386, it will become increasingly
  25. unacceptable to rely on DOS for specialty hardware support.
  26.  
  27. This code is free, in the hopes that the the details of programming
  28. the SB will eventually become something other than proprietary
  29. secrets, hoarded by Creative Labs.  This software and documentation is
  30. covered by the GNU General Public License, to ensure that future
  31. releases will always be free.  Please read the file COPYING for
  32. details, or ask me via Email if you have any questions.
  33.  
  34.  
  35. SOUND BLASTER OVERVIEW:
  36. ----------------------
  37. As of v1.4b, this driver supports every feature of the Sound Blaster
  38. Pro audio card except stereo recording.  The original Sound Blaster
  39. has fewer features, but only small modifications should be necessary
  40. to make this driver support it properly.  Any cards that claim 100%
  41. Sound Blaster Pro compatibility should work fine.  If time allows, I
  42. am planning support for the Pro Audio Spectrum 16, and Gravis
  43. Ultrasound, if that is ever released.
  44.  
  45. For the time being, the Sound Blaster Pro is one of the best offers on
  46. the market, with 22 FM voices in two channels, a DSP that can do 47
  47. KHz 8-bit stereo recording and playback, bi-directional MIDI and
  48. on-board mixer for Line-In, Microphone, DSP, and CD, built-in
  49. selectable filters, and a even a lame attempt at a SCSI CD-ROM
  50. interface, all for under $200.  Future IBM-PC sound cards will
  51. probably be compatible with the SB because of the wide support, and
  52. hopefully this driver will grow accordingly.
  53.  
  54.  
  55. CURRENT FEATURES:
  56. -----------------
  57. This version of the driver supports double-buffered DSP playback using
  58. DMA for speeds up to 47KHz in both mono and stereo modes.
  59.  
  60. Recording (sampling) is currency only done in mono, because I haven't
  61. learned the secret to sampling in stereo.  Again, this information is
  62. extremely hard to squeeze out of Creative Labs, and even other users
  63. in-the-know seem reluctant to share the information.  Hopefully, this
  64. will change in the future.
  65.  
  66. The on-board Mixer functions are fully supported, both via ioctl calls
  67. and standard read and write operations.  See the comments in the code
  68. for more info.
  69.  
  70. Stereo FM synthesis is supported, either as ioctl's, or a stream of
  71. event instructions.
  72.  
  73. This release also has MIDI read/write support.  Due to lack of a
  74. reliable hi-res timer, there is no time information stored with the
  75. MIDI data.  This is left to application software, which can do it just
  76. as well.  
  77.  
  78. The CMS chips are corny and should never have existed on the SB in the
  79. first place, much less for an extra $30.  The SB Pro card does not
  80. accept them at all, and this driver doesn't support them.
  81.  
  82. TO DO:
  83. -----
  84. In future releases, I hope to support stereo sampling, better
  85. technical documentation, better installation instructions for more
  86. platforms, and FM timers.  I am really hoping to get some serious
  87. feedback on this release to help speed things up.
  88.  
  89. INCLUDED APPLICATIONS
  90. ---------------------
  91. A few basic programs are included with this release to get you up and
  92. running, and hopefully provide some programming examples for using the
  93. driver.  Included are:
  94.  
  95. xmix/xmix
  96.     An X Windows interface to the SB Pro mixer, using faders and such.
  97.  
  98. cdsp
  99.     A program to set/read the DSP speed and stereo settings.
  100.  
  101. chew
  102.     A simple program for converting between signed to unsigned byte
  103.     formats.  (csound uses and produces signed byte files; the SB wants
  104.     unsigned bytes.
  105.  
  106. filt
  107.     A skeleton MIDI filter to read incoming MIDI data, possibly
  108.     modifies the bytes, and then sends them out the MIDI-OUT port.
  109.  
  110. float
  111.     A program to convert between unsigned bytes and floating point binary
  112.     streams.  Floats are used by several phase vocoders and such.
  113.  
  114. mixer
  115.     A command-line interface to the mixer.  Similar to the bundled DOS
  116.     program SBP-SET.
  117.  
  118. notes
  119.     Generates random notes in the FM channels.  Not very useful, but it's
  120.     great for testing the driver, and it shows what a wide range of sounds
  121.     can come from those simple FM synth chips.
  122.  
  123. playmidi
  124.     Reads a standard MIDI type 1 or type 0 file and sends the data out the
  125.     MIDI port.  Mostly useful for playing .mid files to an external MIDI
  126.     synthesizer.
  127.  
  128. record
  129.     Simplifies recording direct to disk.  You tell it how long, what
  130.     speed, and what file to record into.
  131.  
  132. midi2fm
  133.     Experimental program to play incoming MIDI notes on the FM synth
  134.     chips.  (Note that I play a horn, so polyphonics are probably not
  135.     supported properly.)
  136.         
  137. revox
  138.     Reverses binary sound files of any length.  
  139.  
  140. midithru
  141.     Pass MIDI bytes from MIDI-IN to MIDI-OUT.  Handy when you need it.
  142.  
  143. Most of these are quick hacks and under constant change.  I hope to
  144. hear what other applications people come up with.
  145.  
  146. Also, I have patched the Mixview graphical sound editor to use this SB
  147. Pro driver.  Email me if you want the diffs.  (Needs X Windows, of course)
  148.  
  149.  
  150. "YOUR MISSION, (should you chose to accept it..)"
  151. ------------------------------------------------
  152. If you install this driver, PLEASE send me any and all mods you had to
  153. make to get it to install on your system.  If you had to change a
  154. single line or #define that wasn't explained in the docs, I would
  155. like to hear about it.
  156.  
  157. If you find any bugs in either the documentation, code, or comments,
  158. please let me know, or send patches if you have already fixed them.
  159.  
  160. If you expand the driver in a significant way, I would love to
  161. incorporate your patches into the distribution.  I am especially eager
  162. to hear from MIDI hackers.
  163.  
  164. If you are a programmer, and see a better, cleaner, or more
  165. explanatory way to do something, I would appreciate a tip or two.
  166. Code can always be better.
  167.  
  168. Most of all, Thanks!  Please let me know how you fare.  If you chose
  169. not to install the driver because of something you didn't like, please
  170. tell me.
  171.  
  172. Good Luck!
  173. -Steve
  174.  
  175. Steve Haehnichen
  176. shaehnic@ucsd.edu
  177.