home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3455 / README < prev    next >
Encoding:
Text File  |  1991-06-07  |  3.6 KB  |  72 lines
  1.  
  2.                          Sound Blaster(tm) Driver
  3.                        (Copyright 1991, Brian Smith)
  4.  
  5.  
  6. REQUIREMENTS
  7.  
  8. This driver and the associated user programs require a 386/486 system
  9. running System V 3.2 Unix.  It has been tested on ISC Unix versions
  10. 2.0.2 through 2.2.1.  I believe it will work correctly on Esix, Intel,
  11. and AT&T Unix.  SCO is a mystery to me (as well as many others).  I do
  12. not believe it will work in SysV 4.0 and above, but the modifications
  13. should be fairly minimal.  Remember, though, THERE IS NO WARRANTY.
  14.  
  15.  
  16. GENERAL INFORMATION
  17.  
  18. This driver is for the Sound Blaster sound card designed by Creative
  19. Labs, Incorporated.  The Sound Blaster is a sound card for the
  20. IBM-PC(tm) type I/O bus.  The card is capable of sampling sound from a
  21. microphone jack from 4KHz to 23KHz (or 24KHz, depending upon which
  22. portion of the manual you believe) at 8 raw bits of resolution.  It is
  23. also capable of playing samples at speeds from 4KHz up to 12KHz.  The
  24. board can play raw 8 bit samples, or 2 bit, 2.6 bit, or 4 bit ADPCM
  25. packed samples.  ADCPM is a lossy method of data compression.  The
  26. sampling and output may be directly driven by the CPU, or it may be
  27. driven by DMA.  The card is also capable of playing music through an
  28. on-board FM synthesizer chip.  The chip may play 9 simultaneous
  29. instruments, or it can play 6 simultaneous voices with 5 additional
  30. rhythm instruments.  In addition, the board (but NOT my driver) also
  31. supports the addition of 2 C/MS chips. For more information, read the
  32. advertising blurb, errr...  manual which comes with the Sound Blaster.
  33.  
  34. The driver is capable of utilizing only a subset of the capabilities
  35. of the Sound Blaster card.  The driver is accessed through three
  36. device nodes.
  37.  
  38. The /dev/sbdsp node accesses the DSP chip which controls sampling and
  39. sample playback.  Only 8-bit sound is supported thus far.  The driver
  40. utilizes DMA, and therefore is very unobtrusive to the system load.
  41. The ls utility is harder upon the system.  Read(2) and write(2) upon
  42. /dev/sbdsp sample sound and play back sound samples, respectively.
  43. Several ioctl(2)'s control sampling/playback speed, resets, etc... 
  44. The play_snd utility demonstrates the use of the /dev/sbdsp node.
  45.  
  46. The /dev/sbfm node accesses the FM chips.  The only access to the FM
  47. chips are through ioctl(2)'s.  The play_cmf utility demonstrates the
  48. use of the FM chips by (mostly) interpreting and playing CMF files.
  49. The various options controlling the voices can be dumped from a CMF
  50. file by the get_instruments utility.  Those familiar with synthesizers
  51. can then learn how to create their own instruments.  I can't provide
  52. direct documentation, as I believe that would be a violation of
  53. Creative Lab's copyrights.  Those having questions, send me e-mail.  I
  54. think it would be OK to answer questions.
  55.  
  56. The /dev/sbcms node accesses absolutely nothing.  I do not have the
  57. C/MS chips with which to experiment.
  58.  
  59. This driver is merely the rough outlines of what it could be.  Support
  60. could be added for oodles of features, like efficiency improvements, and
  61. ADCPM interpretion for the /dev/sbdsp node.  If you wish to add to this
  62. driver, please be my guest (after reading the license file).  When you
  63. have patches, send those to me.  I will then integrate, do rudimentary
  64. testing, and send the patches to Usenet.  That way, there won't be
  65. billions of versions of this driver to contend with.
  66.  
  67. I am not requiring donations to my, no doubt worthy cause, however,
  68. they are willingly accepted. :-)  They will help me in future
  69. projects, and if there are enough requests (loudness does not count),
  70. I will continue work on this driver and write more software to use
  71. it.
  72.