A PDF version of this online manual is available AudioTool - Online Manual - Bofinit Corporation.pdf .
When AudioTool is started, you will see the main screen for the Real Time Analyser (RTA). The screen is divided into three regions:
The labels on the buttons indicate the current state of the control.
The bottom row of buttons, select major functions of AudioTool. The middle button is the Menu button. The Menu can also be activated by a long press on the phone/tablet's "Recent Apps" button.
To hide the buttons from the screen simply tap in the top region of the display. To restore the buttons, tap anywhere in the display.
An option in the Menu allows to select/toggle between the front microphone, for those phones that have one, and the main microphone (usually at the base of the phone). The front microphone is the one that is typically on the front of the phone used for video recording. The setting is remembered between sessions. For phones that do not have a front microphone, then the menu option is still available, but all it will do is select the main microphone's AGC stream - which is probably not what you want :-)
To connect an external microphone (the Dayton Audio iMM6 is recommended), just plug the mic into the headset jack on your Android tablet/phone.
To connect your amp, you can plug a cable with a jack on one end (into the iMM6's socket for that purpose) and phono plugs, or whatever your amp needs, on the other. Then, you can send signal generator audio to your amp, and measure the resulting audio with the iMM6.
If you don't have an iMM6 then you can use a Y connector in the headset jack - this breaks the jack into two jack sockets: one for a mic, one for audio out.
The frequency resolution of AudioTool is governed by the sample rate (typically 44100 samples/sec) and sample size (typically 4096 samples) by the relation:
Frequency resolution = Sample Rate / Sample Size
So, the typical resolution is around 10Hz. You can improve the resolution via the Menu option called "Fine Freq.(slowest)" - this simply increases the sample size to 2^14 which is 16384. The downside is that the frame rate will slow down (the display will not react as quickly as before). The advantage is that the frequency resolution will typically rise to around 2Hz: this will be very noticeable in the RTA "Full Res." mode, for example.
Selecting <CANCEL> will return you to the main display, selecting <CLEAR> will remove an existing loaded file from being displayed. Selecting one of the files results in it being shown on the main display thus (the file loaded here is called "ambient"):
The AudioTool .at files have the following format. There is a file header line, containing the date/time etc., followed by rows of measurement data. For each row:
New in 6.2.3:
If you are in 1 Octave, 1/3 Octave or 1/6 Octave mode when Storing the file, the relevant octave data will be appended to the data described above. An example is shown below:
1/3 Octave Data: Columns are Frequency(Hz), dB, dB(valley), dB(peak)
20.0 26.83156706582885 22.166787511483037 52.632521644880924
25.0 24.79307357192959 22.166787511483037 52.632521644880924
31.5 23.638651696759617 14.802948453138242 54.36133378082017
40.0 31.207812167904592 19.370791325960823 45.49667680795788
50.0 38.912702880111574 29.64552758219944 49.49161872432127
63.0 31.308559430337557 22.89743713538305 48.84070943868894
80.0 36.503730339760416 30.2550007563 53.60647538837455
100.0 37.32872961438841 31.628594404178614 52.84494589661469
125.0 47.53906365527617 41.49260507497887 55.603996089423774
160.0 37.13218036161636 30.019891483037632 53.51520224280762
200.0 38.61583915476531 32.18272210005908 56.303036331405195
250.0 39.45571992076893 34.41176902389282 58.93353652741962
315.0 35.445424637925015 32.892587984824274 53.20546791705307
400.0 38.07353309291713 33.10039544690382 58.651517195975586
500.0 37.44883468905982 31.62128553573676 60.243290257242265
630.0 33.905814941577894 29.745581687854823 61.621031458186906
800.0 31.189947485876157 29.136970289841344 62.9863347566566
1000.0 29.934049998698615 26.281615541776937 68.23173512416146
1250.0 28.804920066416592 25.35837631687501 72.65160623462893
1600.0 29.091712814182326 25.780246296745275 92.86700351806023
2000.0 27.885411613466054 24.668718676082374 77.11216044766489
2500.0 27.272514725191616 24.29759590065956 69.88265084063536
3150.0 27.044774522628643 24.289355987064475 70.62307656703035
4000.0 27.96804350430325 25.149385241068856 65.93333352809589
5000.0 28.201004393959373 25.481078088048356 62.52033892733458
6300.0 33.39460194392798 29.18232982337404 63.791460855372634
8000.0 31.42957001418992 28.356561247922514 59.74561820466221
10000.0 29.048496309608893 26.7129789759191 55.35978669914826
12500.0 29.135908066371623 27.80860720298393 54.31129910809918
16000.0 30.411527191811615 29.062520150477052 54.33884829589135
20000.0 28.65506503472534 27.471865999372465 53.57466153606412
Note: for versions prior to v6.0.3 you can calculate the third column from the second (call it X) using the formula:
Sqrt(dBcorrection + dBcalibration + dBvonHann + 10log(X*X))
Where dBcorrection is 20, dBvonHann is 4.2 and dBcalibration is shown in the file header. For v6.0.3 and above, remove the sqrt in the formula above.
The real time analyzer (RTA) has several modes, described below.
Frequency response is shown in the ten ISO 1 octave bands.
(In this screen shot, the Noise Curves are also being shown - see below for details on Noise Curves.)
Frequency response is shown as a function of time: the spectrum at each moment is drawn as one row of a bitmap. The colour of each pixel indicates the intensity of the sound at that position in the spectrum. The most recent time is at the bottom of the display.
You can change the speed of the spectrogram (the rate at which new rows of the bitmap are drawn) between Fast and Slow using the option available in the Menu.
In this mode, AudioTool shows the results of the continuous Leq calculation. Leq is the average of the power sum of the measured instantaneous dB SPL levels over an interval of time. For more details about Leq see, for example, Leq at National Instruments . It is the "equivalent continuous sound level".
The Leq calculation will continue to run indefinitely, but it can be stopped by pressing the RTA "Running" button (top left) - if you press that button again, a new Leq calculation is started afresh.
Shown below is a screenshot of the Leq display. The broadband Leq, and the elapsed time for the calculation is shown, as well as the target duration (in this case 1 minute). (The duration can be adjusted using the Menu option "Set Leq Duration".)
The table shows the 1 octave Leq measurements: the current calculation is shown in the "Now" column. The other columns show prior results ... so the T-1 column is the result from the calculation that last finished, the T-2 the one before that, and so on.
(Normally, Leq measurements are made using the A Weight filter.)
AudioTool stores up to 5,000 Leq measurements internally starting from every time the app is started. The measurements can be saved to an AudioTool .leq file - use the "Store" button for this purpose. The stored file can be opened in a text editor, and imported into e.g. Excel. Here is an extract from an Leq file:
AudioTool Leq File recorded at Sat Jun 15 11:42:18 PDT 2013
MilliSeconds now: 1371321738067 Columns: Time Start, Time Finish, Duration(s), LEQ, LEQ octave1, LEQ octave2 ... 40 LEQ measurements in file
2013-06-15T11:41:13 2013-06-15T11:42:13 60 74.4 47.4 50.9 60.7 65.8 66.6 65.1 64.3 65.9 68.8 58.1
2013-06-15T11:40:13 2013-06-15T11:41:13 60 69.0 43.9 47.0 58.9 63.7 61.8 59.3 53.2 54.1 62.5 51.2
2013-06-15T11:39:13 2013-06-15T11:40:13 60 65.8 43.3 46.4 57.8 60.0 58.7 55.8 49.5 50.4 58.4 51.2
2013-06-15T11:38:13 2013-06-15T11:39:13 60 66.1 43.1 47.0 57.7 62.3 58.4 55.7 49.4 49.2 55.0 51.1
2013-06-15T11:37:13 2013-06-15T11:38:13 60 69.3 44.0 53.5 58.1 63.3 61.0 59.0 54.2 55.6 64.2 52.1
2013-06-15T11:36:13 2013-06-15T11:37:13 60 69.1 43.2 50.3 58.8 63.5 59.4 57.5 51.1 52.6 64.8 52.2
2013-06-15T11:35:13 2013-06-15T11:36:13 60 67.9 44.9 50.2 56.8 62.3 59.2 59.1 53.2 54.7 61.9 51.8
2013-06-15T11:34:13 2013-06-15T11:35:13 60 69.0 45.9 51.0 58.9 64.1 60.1 60.5 55.3 54.9 61.4 52.7
In this mode, AudioTool keeps track of the peak dB values at all measured frequencies. This is useful for e.g. sweeping the frequency response of an audio system. Peak Store mode is a 1/6 octave mode.
To make such a measurement, set the RTA mode to Peak Store (see the screenshot below), and then go to the Generator, select either Sweep or Log Sweep, configure the frequency range you desire, then start the Generator running.
Return to the Analyzer, and watch the peaks set as the Generator sweeps across the frequencies you specified. In this way, the frequency response of the system may be measured.
To reset the peak dB values, stop the data collection by pressing the "Running" button, and press it again to set the peaks to zero and start a new measurement.
You can store a Peak Store measurement into a file, by using the "Store" button. To compare a previous measurement with the current, use the Load button to select the previously stored measurement file. In the screenshot above, a previously made measurement called "ambient" is being compared.
In the RTA and Spectrogram modes, the user may choose to have AudioTool use a logarithmic or a linear scale for the frequency (Hz) axis. The choice is made via the menu, shown below:
Choosing "Set Lin Hz" menu option will change to the linear scale.
The frequency limits for the Hz scale can be adjusted, using the menu option "Set Freq Scale". The following dialog will appear:
In the example screenshot above, the user has set limits of 20Hz to 10kHz. Note that you can set the scale limits back to their default values by tapping the "Use Default" button. Here is what the linear scale looks like:
You can similarly adjust the dB Scale limits, via the Menu.
Note that the Hz scale limits, and the dB scale limits, are saved by AudioTool when the user terminates the app: they are restored when the user restarts AudioTool.
You can adjust the dB and frequency markings in the RTA and the dB marks in the Chart Recorder in the following way:
(Scroll and Pinch of the scales in this way is disabled when the Cursors are visible.)
Again, note that you can set the scale limits back to their default values by tapping the "Use Default" button.
AudioTool will store and remember the calibration number(s) you enter, and will also remember whether you are using the single value or octave based method.
For the 1/3 octave based method you will see a screen similar to that shown below:
Each of the 1/3 octave band's current calibration values (deciBels correction, positive or negative) is shown in a grey disc - when the you first calibrate, all values will be zero. The red disc shows the band currently being adjusted. If you double tap on the left hand side of the screen, the selected disc moves to the left. If you double tap on the right side of the screen, it moves to the right.
To adjust the selected band, place your finger anywhere on the screen and drag the up or down - the selected disc will move in unison, until you see the correction value you want. Take your finger off the screen when you have adjusted the disc, and then double tap to select the next band, and so on.
Your aim is probably to move the discs so as to obtain a flat response, and match the overall SPL to that of an external meter, or to correct for any odd peaks or troughs your Android phone may exhibit in its frequency response.
When satisfied with the results, choose "Finish Calibration" from the Menu, and confirm whether you want to save the values. These values will be retained on your phone and will be loaded every time AudioTool starts.
By default, the dB calibration values in each band are all 0dB. You can apply a global offset to these values using the "Set Cal. Offset" Menu option (which appears when you are using the 1/3 Octave calibration method.)
The "Set Cal. Offset" option will bring up a dialog where you can enter the desired value:
Now, when calibrating, the dB levels in all bands will be offset by the amount you entered:
You can adjust the levels in each band in the way described above. Remember to select "Finish Calibration" from the menu when you are done!
(The observant reader will notice that the current global offset value is handily shown in the Mic display, as O=5.0)
AudioTool supports loading a calibration file for the Dayton Audio iMM-6 microphone. These files have names like "99-0101.txt" when downloaded from Dayton's website. For use in AudioTool, you will simply need to rename the file so that it has the .cal filetype (e.g. "99-0101.cal") and save it in the AudioTool directory on your Android phone. Then, in AudioTool, make sure that in the Menu you have the 1/3 octave calibration method selected. You can then select the "Load Cal" option from the Menu, and choose the Dayton file from the list. The calibration data will be loaded, power summed to the 1/3 octave bins used by AudioTool, and saved in your Preferences - there is no further need to load the file whenever you start AudioTool, unless you change the calibration method or alter the calibration values manually.
Please see the section above on "Global Offset". Just because you have an iMM-6 and have loaded the Dayton cal file, does *not* mean that AudioTool will necessarily agree with an independent pro-grade meter. To get agreement, you should adjust the Global Offset. Even then, if the internal audio circuitry on your device is not flat, your results will vary.
Rex has provided a handy Excel tool and instructions for how to calibrate your Android device.
The time history of SPL readings is shown: the chart recorder "pen" at the right hand side of the screen draws the latest value. The axis is labelled in seconds in the past. At most 10,000 SPL readings are stored, corresponding to a few minutes of history (this value varies from one Android device to another). The chart data can be stored using the Store button, if so desired. (Note the use of the cursors in the example below.) The grey text at the bottom left of the chart indicates the current length of the buffer, in seconds.
You can measure room reverberation times in RT60 mode, selected using the RT60 button.
If the Signal Generator is Off when RT60 mode is started, the system waits for a loud impulse signal, such as a clap to trigger the measurement. This sound will energise the room, and how quickly the sound pressure falls off with time will be measured. The longer the sound takes to die away, the more reverberant is the room.
After the clap is detected, the measurement starts. Since the RT60/reverberation time for a room will be different depending on frequency, AudioTool makes a wideband (all frequencies) measurement, as well as measurements in each of the ISO octave bins. To do this, the data are passed through a bank of IIR octave filters centred on the desired frequencies. The results are displayed in tabular form, and may be exported to a file using the "Store" button.
RT60 measurement can also be made using the signals (e.g. White Noise) from the generator to energise the room. If the Signal Generator is On when RT60 mode is started, then the Trigger button:
can be pressed when the RT60 measurement should be made. When the Trigger button is pressed, the output from the Signal Generator is stopped, and the RT60 measurement of the decaying sound intensity is made.
Technical notes: the RT60 uses a Schroeder integral to work backwards from the noise floor to the detected peak intensity. The Schroeder integral is shown as a red trace on the RT60 display. The RT Early number is the time for the intensity to drop from the peak to 10dB below the peak, multiplied by 6. The 15-20 number is the time for the intensity to drop from 5dB below the peak to 20dB below the peak, multiplied by 4.
The screen shot below shows an example of an RT60 measurement.
The RT60 results table can be hidden or shown by using the Menu option:
Hiding the RT60 table allows closer inspection of the RT60 curve data:
For the periodic signals, like Sine, Square etc., the frequency of the wave may be set using two methods:
To turn the generator output on and off, use the large button so labelled.
The volume of the generated signal can be adjusted using the slider - you can also use the hardware buttons on your device.
By default, the signal is sent to both channels, Left and Right. You can disable output on one or both of the channels using the checkboxes above the volume slider.
Technical note: The precision with which AudioTool can generate a given frequency depends on the internal sample rate being used and the sample buffer length. Typically, you can expect AudioTool to generate a frequency within 10Hz or less of the value you specify.
When the Sweep or Log Sweep button is selected, AudioTool will generate swept sine waves.
To adjust the start and stop frequencies, and the duration of the sweep, use the "Set Sweep Frequency Limits" button to bring up the dialog box shown below:
In the example above, the settings will cause a sine wave starting at 100Hz to be swept up in frequency to 2000Hz, over a duration of 10 seconds.
AudioTool will generate warbles when the Warble button is selected. You can adjust the low and high frequencies of the warble, and the duration between those limits. E.g if you set the low frequency to 400Hz, the high frequency to 800Hz, and the duration to 1.0 seconds, then you will hear a sine wave that starts at 400Hz, rises to 800Hz in half a second, then falls to 400Hz in half a second, and that cycle will repeat.
Note that you can now more conveniently measure frequency response using the Peak Store mode described above (introduced in v7.0).
If the generator is in Sweep mode, then the current sweep frequency is stored for every value of SPL measured by AudioTool. The current sweep frequency is also displayed on the main screen. In addition, if Chart Recorder mode is selected, and the chart saved using the Store button, then the SPL readings coupled with the generator frequency will be saved in the file.
The chart file may then be read in to e.g. Excel and a frequency response curve created by plotting the SPL readings versus the frequency values. Here is an example:
Each row of the Chart Recorder file contains the time, the measured dB SPL, the detected peak frequency, and optionally the sweep generator frequency at that time if sweeps were running at the time.
There are two cursors that can be enabled and disabled via the main menu, using the Show Cursors or Hide Cursors options:
Initially, both cursors are positioned mid-screen - you can move the cursors simply by touching them and sliding your finger to the desired position. In RTA mode, the cursors show the frequency and dB level at the cursor position. In Chart Recorder mode they show the time and dB SPL:
In 1/1 Octave mode you can display the Noise Curve family, via the main menu, and AudioTool will calculate the prevailing NC value.
For more information on Noise Curves see here.
With Valley On, AudioTool keeps track of the minimum dB levels observed at each frequency, and shows these as white bars (or a white line) on the screen. To reset the valley levels, simply turn Valley off then on again. Here is a screenshot showing both peak and valley enabled.
You can adjust the font size used for the text in the AudioTool screens and displays via the Menu. There are three options: Small Font, Large Font and Massive Font. Changing the font cycles through these in order.