home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 306.lha / SpeakerTools_v1.1 / SpeakerTools.docs < prev    next >
Text File  |  1980-12-05  |  12KB  |  297 lines

  1.                                                       Oct 15, 89
  2.                                                       
  3.                         SPEAKERTOOLS V1.1        
  4.  
  5. Disclaimer: I do not warranty the correctness of the information 
  6.             generated by this program, and I decline any         
  7.             responsibility for any problems caused by the use of 
  8.             this program or it's output.
  9.  
  10. Conditions: This is a shareware product, if you like it and use  
  11.             it, I suggest a donation of $30 (private users), or 
  12.             $50 (commercial users). You can freely redistribute 
  13.             this program as long as you include this             
  14.             documentation with the program itself. Registered    
  15.             users will get the latest version and version 2.0
  16.             when it becomes available. V2.0 will have better 
  17.             graphics a context sensitive help feature and a 
  18.             better X-Over section offering third order slopes 
  19.             and active filter designs.
  20.  
  21.  
  22.  
  23. Introduction
  24.  
  25.     This program is meant to help the hobbyist who builds and
  26. designs his own loudspeakers. It allows you to design sealed and
  27. vented types of enclosures, and will tell you the ideal
  28. dimensions, frequency response and power output. It also allows
  29. you to design crossover networks for 2 and 3 way speakers.
  30.  
  31.     If you already know about loudspeaker design than this
  32. program should be self explanatory. If you're just starting than
  33. this document and the program itself will guide you through the
  34. process of loudspeaker design.
  35.  
  36.     This program uses the Small/Thiele approximations for
  37. enclosure designs. If you notice any large discrepancy than
  38. please advise me so I can correct them.
  39.  
  40.     This was my first Amiga project and my first Modula 2
  41. program. It required quite a bit of work but in the process I
  42. learned a lob about programming the Amiga. If you have any
  43. suggestions, comments or bug reports, please let me know so that
  44. I can improve this program and make it more useful.
  45.  
  46.  
  47.  
  48. Setup
  49.  
  50.     To run this program you should have the ARP (1.3) Library in
  51. your libs: directory. Simply type "SpeakerTools" in the CLI or
  52. double-click on the icon and the program will start, no arguments
  53. required. You should use a stack size of at least 8000 bytes.
  54.  
  55.     I suggest you use a separate directory for all your driver
  56. data files. You can then use the "Set Path" item from the
  57. settings menu to tell the program where to look for these files.
  58.  
  59.     You can also change and save the default colours, I suggest
  60. a light background with dark characters for best results.
  61.  
  62.     This program looks for its defaults in a file called
  63. Speakers.dflts in the S: directory. If it doesn't find this file
  64. it will simply assume some settings of it's own. After you've
  65. setup the program the way you want (Using the Settings menu), you
  66. can save those settings by selecting "Save Settings" from the
  67. Settings menu.
  68.  
  69.     
  70.  
  71.  
  72.  
  73. Project Menu
  74.  
  75.     NEW : This menu item will clear from memory any data about a
  76. specific driver (woofer), and bring up a window for entering
  77. new driver data. If you change your mind, or lack some data,
  78. you can get out of this function (and all the other functions
  79. of this program as well) by clicking on the close gadget in the 
  80. left corner of the window. Once you've entered the last data
  81. item, the window will close on its own. In this data entry
  82. window, like in all the other ones in this program, if you enter
  83. an out of range value, a requester will pop-up to warn you and it
  84. will give the allowable range of values. You can cancel this 
  85. requester by clicking in the OK gadget, or typing the first letter
  86. of the gadget (IE "O"). Once you are out of the requester, you can
  87. enter an appropriate value to replace the old one.
  88.  
  89.     OPEN: This allows you to load a driver data file from disk.
  90. This archive contains several files that can be used if you have
  91. access to those drivers.
  92.  
  93.     SAVE: This will save the current driver data to disk using
  94. the current file name. If no file name exists then the program
  95. will ask for one.
  96.  
  97.     SAVE AS: This will ask for a name before saving the driver
  98. data file, even if a name already exists.
  99.  
  100.     Quit: Self explanatory. If there is an unsaved driver data
  101. file in memory the program will ask if you want to save it first.
  102.  
  103.  
  104.  
  105. Functions Menu
  106.  
  107.     VENTED BOX: This menu item allows you to design ported
  108. loudspeaker enclosures. This type of enclosures is suitable for
  109. drivers having a Qts (see glossary) between 0.2 and 0.5. You have
  110. the choice to do an OPTIMUM or a FORCED design. Optimum will give
  111. the best performance while forced allows you to tune the
  112. enclosure to your own taste. If no driver file was loaded from
  113. disk, the program will ask you for the driver data at this point.
  114. If you don't have access to this data, see the "Find Params" menu
  115. item. After you've entered all the data the program will display
  116. a graph of the frequency response and the appropriate data,
  117. including the enclosure volume and cutoff (-3dB) frequency.
  118.  
  119.     From this screen you can RESIZE the enclosure to suit your
  120. needs, PRINT this design (screen dump), ENCLOSURES will give you
  121. the ideal dimensions (golden ratio : 0.6 x 1.0 x 1.6, these
  122. dimensions include an extra 10 percent for internal bracing and
  123. insulation and are only recommended)but you can now change those
  124. dimensions for the given box volume, POWER OUTPUT will ask for
  125. some more data(watts should be RMS) and give you a chart of power
  126. levels at various frequencies, and VENT DESIGN will ask you for a
  127. vent diameter and give you the proper length.
  128.  
  129.     FORCED will do exactly the same thing except it will start
  130. by asking for an enclosure volume and tuning frequency. This is
  131. useful if you need some particular performance characteristics
  132. that do not correspond to the ideal (flattest response) provided
  133. by the OPTIMUM option.
  134.  
  135.  
  136.     CLOSED BOX: This will allow you to design a closed (sealed)
  137. enclosure. Drivers for this type of enclosure should have a Qts
  138. of 0.3 or higher. This section works the same as the closed box
  139. one except that the program will also ask you for a Qtc (see
  140. glossary), Qtc should be between 0.5 and 2.0.
  141.  
  142.     
  143.     ENCLOSURES: This is exactly the same function as the one
  144. available from the Closed and Vented design screens. It allows
  145. you to find out the dimensions of an enclosure according to the
  146. volume you provide. It will first give you the golden ratio
  147. dimensions. You can then change the volume or any of the dimensions 
  148. to arrive at the exact box design desired. If you enter a new width
  149. in the appropriat gadget, the depth will be corrected to arrive at
  150. the given volume, same thing if you change the height. If you 
  151. enter a new height. If you change the depth, the height will be
  152. modified to maintain the proper volume. All those dimensions  
  153. include an extra 10% for bracing and insulation. The program will 
  154. show you what the box will look like.
  155.  
  156.  
  157.     VENTS: This is the same function as the one available from
  158. the Vented design screen. It acts as a calculator, you enter a
  159. box volume, a tuning frequency and a tube diameter, the program
  160. will calculate the proper vent length.
  161.  
  162.  
  163.     X-OVERS: This will allow you to design a 2 or 3 way
  164. crossover network with any mix of first or second order (Butterworth) 
  165. slopes. You will be presented with gadgets arranged in a graphical
  166. way representing the crossover. You can change the impedances by
  167. clicking in the appropriate gadgets and entering the proper value.
  168. Same goes for the crossover frequencies. You can change the 
  169. individual slopes by clicking in the slope gadgets, they will toggle
  170. between 6 and 12 dB/Octave. When you're satisfied with the data,
  171. just click on the DONE gadget. The program will then draw a diagram 
  172. with the proper values of capacitors and inductors. Be sure to check 
  173. the proper polarity on the drivers. From this screen you can select 
  174. RETRY for another design or select PRINT to send this one to the 
  175. printer (screen dump). 
  176.  
  177.  
  178.     FIND PARAMS: This will allow you to find the driver
  179. parameters when you don't already have them. To do this you will
  180. need a VOM, an audio frequency generator and a test enclosure.
  181. You will be asked for the driver's DC resistance (use the VOM),
  182. the free air resonance (frequency at which the impedance is
  183. highest), the frequency at which the impedance equals the
  184. calculated Z below and above the free air resonance, the volume
  185. of your test box (sealed) and the resonance frequency with the
  186. driver mounted in the box. When you enter the last data, the input
  187. window will close itself and the program will display the calculated
  188. data. You are now offered the choice to SAVE this as a driver data 
  189. file for later use, PRINT the data, start all over AGAIN or QUIT.
  190.  
  191.  
  192. UTILITIES MENU
  193.  
  194.     CALCULATOR: This one will translate between cubic feet and
  195. liters or between inches and centimeters. Simply enter the proper
  196. value in the appropriate gadget and you will get the converted
  197. value in the other gadget. Clicking on the MODE gadget will
  198. toggle between volume and length units. This runs as a separate
  199. task and can be kept in the background at all times.
  200.  
  201.   FREQ.GEN. : This will bring up another backgroung task that will
  202. allow you to use your Amiga as an audio frequency generator to help 
  203. you use the FIND PARAMETERS function. It will generate triangular
  204. waves from 6 to 13300 Hertz (it doesn't work well above 7000 Hz yet).
  205. You have gadgets to START a sound, STOP a sound, QUIT this function,
  206. and select a different frequency range. You can also use the 
  207. proportionnal gadgets to change the frequency within a range, or 
  208. adjust the volume. You should feed the audio output of your Amiga
  209. to a small amplifier to get enough power to drive your speakers.
  210. This module can be sent to the back like the metric calculator.
  211.  
  212.   If you re-select the CALCULATOR or FREQ.GEN. menu options while
  213. the task is already running, it will simply become the frontmost 
  214. window.
  215.  
  216.  
  217. SETTINGS MENU
  218.  
  219.     SET UNITS: this will allow you to chose between the METRIC
  220. and ENGLISH modes. Unless you then select the SAVE SETTINGS item
  221. the program will revert to it's default setting on the next run.
  222.  
  223.  
  224.     SET COLOURS: this will bring up a colour palette allowing
  225. you to change the screen's colours. Again, unless you then select
  226. SAVE SETTINGS the program will revert to it's default colours on
  227. the next run.
  228.  
  229.     SET PATH: This will bring up a file requester to allos you to 
  230. select the path for your driver files directory. You should than 
  231. save this path by using the SAVE SETTINGS option.
  232.  
  233.  
  234.     SAVE SETTINGS: See above if you don't already know how to
  235. use this.
  236.  
  237.  
  238.  
  239. INFO MENU
  240.  
  241.  
  242.     ABOUT: this is self explanatory.
  243.  
  244.  
  245. BUGS:
  246. ~~~~~
  247.   There is a small bug in my compiler that will cause some small
  248. inacuracies with numbers displayed in StringGadgets. This is not
  249. to worry about as the right number is still used for internal
  250. calculations.
  251.  
  252.  
  253. CONCLUSION:
  254. ~~~~~~~~~~~
  255.   I hope you will enjoy this program and find it useful. It 
  256. required a lot of work and can still use some improvements, so any
  257. encouragement will be most welcome. Only 3 persons registered V1.01,
  258. common guys, I'm sure there is many more than that using it. This 
  259. makes me wonder if it's worth all the trouble, and if anybody 
  260. actually appreciates my efforts.
  261.  
  262.     Please send me any bug reports, donations or comments via mail or 
  263. leave me an EMAIL on CompuServe (76056,1655) or BIX (slyduf).
  264.  
  265.   For user support and free upgrades, registered users can contact
  266. The Hobby Board (my own BBS, will come online in November 89) 
  267. 24 hrs/day, 300-2400 Baud, at 403-456-7593.
  268.  
  269.  
  270.     Here's a registration form for your convenience:
  271.  
  272. ----------------------------------------------------------------
  273.  
  274.  
  275.                SpeakerTools V1.1 Registration Form
  276.  
  277. Last name:____________________ First name:______________________
  278.  
  279. Address:________________________________________________________
  280.  
  281. City:_________________________ Prov/State:____________ 
  282.  
  283. Country:______________________ Postal code/ZIP:_______ 
  284.  
  285. CIS ID:_______________________ BIX ID:________________
  286.  
  287. Comments:_______________________________________________________
  288.  
  289. ________________________________________________________________
  290.  
  291. Send to:
  292.         Sylvain Duford
  293.         14103-114 Street
  294.         Edmonton,Alberta
  295.         Canada, T5X-1R6
  296.  
  297.