workbench/devs/AHI/Drivers/SB128/README.txt

   1 \r
   2 SB128 AHI driver\r
   3 ----------------\r
   4 \r
   5 \r
   6 This is the open source release of the SB128 AHI driver written by Ross Vumbaca.\r
   7 \r
   8 The source to this driver is released under the terms of the Aros Public License (APL).\r
   9 \r
  10 Thank you to Paolo Besser for sponsoring the release of this driver source.\r
  11 \r
  12 For licensing information, please read the "LICENSE.txt" file.\r
  13 \r
  14 \r
  15 Background:\r
  16 -----------\r
  17 \r
  18 \r
  19 "SB128" is a generic name sometimes used by Creative Labs for their low cost\r
  20 PCI Sound Cards.\r
  21 \r
  22 \r
  23 Sometimes they are known by different names, such as:\r
  24 \r
  25 Sound Blaster AudioPCI97\r
  26 Sound Blaster PCI\r
  27 Sound Blaster Vibra\r
  28 Sound Blaster 128\r
  29 Sound Blaster 64(V)\r
  30 \r
  31 These cards are all based around the same "Ensoniq" audio chip\r
  32 (Creative bought them out a number of years ago).\r
  33 \r
  34 Creative likes to change the names of their cards.\r
  35 \r
  36 \r
  37 The original cards were based on the "Ensoniq ES1370" chip.\r
  38 \r
  39 The next generations of chips (name changing over time) were:\r
  40 \r
  41 Ensoniq ES1371\r
  42 Ensoniq ES1373\r
  43 Creative CT5880\r
  44 Ectiva EV1938\r
  45 \r
  46 They are all basically the same thing, and are all supported by this driver.\r
  47 \r
  48 Creative likes to change the names of their chips (do we see a trend here?)\r
  49 \r
  50 \r
  51 The driver supports playback and recording from 8000Hz to 48000Hz at 16 Bit, Stereo.\r
  52 \r
  53 \r
  54 Thank you to Davy Wentlzer for extensive help and guidance during the development of this driver,\r
  55 and also for sending me an ES1370 card - http://www.audio-evolution.com\r
  56 \r
  57 Additionally, thank you to all the AmigaOS4 Beta Testers that provided feedback.\r
  58 \r
  59 \r
  60 Instructions for use:\r
  61 ---------------------\r
  62 \r
  63 1) You must install AHI on your system\r
  64 \r
  65 2) Place "sb128.audio" into Devs:AHI/\r
  66 \r
  67 3) Place "SB128" into Devs:AudioModes/\r
  68 \r
  69 4) Make sure to set up Unit 0 using AHI Prefs\r
  70    Use a frequency of 44100Hz, and Channels = 32.\r
  71 \r
  72 \r
  73 Note Regarding ES1370:\r
  74 ----------------------\r
  75 \r
  76 When you are recording with the ES1370, the Monitor Volume level you hear,\r
  77 is the level which will be used for recording. That is, if you adjust the Monitor\r
  78 Volume, you are actually adjusting the Input Gain. It is not possible to adjust\r
  79 the Input Gain separately (as it is with the other SB128 AC97 based cards).\r
  80 \r
  81 The exception to this rule, is the Microphone and Speaker-Phone/TAD input\r
  82 (if present).\r
  83 \r
  84 \r
  85 Useless Trivia\r
  86 --------------\r
  87 \r
  88 Useless Trivia #1274 - Ensoniq was founded by an ex-Commodore employee.\r
  89                        He was the inventor of the SID chip.\r
  90 \r
  91 \r
  92 History\r
  93 -------\r
  94 \r
  95 5.10 - Initial Release\r
  96 \r
  97 5.15 - Implemented proper MicroDelays, for better performance in particular areas.\r
  98        Adjusted AC97 read code for the buggy revision 8, ES1373 chip.\r
  99 \r
 100 5.16 - Got rid of MicroDelays, changed timing approach.\r
 101 \r
 102 5.17 - Experimental DMA fix added\r
 103 \r
 104 5.18 - Adjustments made to experimental DMA fix\r
 105 \r
 106 5.19 - DMA fix finalised\r
 107 \r
 108 5.20 - Reset handler added.\r
 109        Support for ES1370 added!\r
 110 \r
 111 5.21 - Code clean up\r
 112 \r
 113 5.22 - Fixed issue with simultaneous playback and\r
 114        record\r
 115 \r
 116 5.23 - Now supports the New Memory System (TM)\r
 117 \r
 118 5.24 - Open source release, thank you to Paolo Besser\r
 119 \r
 120 \r
 121 Contacting the author\r
 122 ---------------------\r
 123 \r
 124 Please send bug reports to rossv@potduck.com\r
 125 \r
 126 Ross Vumbaca, 18/8/11\r
 127 \r