1[Home](README.md) 2 3# How to Use OboeTester 4 5## Loopback Adapter Needed for Some Tests 6 7Some of these tests require an [audio Loopback Adapter](https://source.android.com/devices/audio/latency/loopback) that plugs into a 3.5 mm jack. 8If the phone does not have a 3.5 mm jack then you can combine that with a USB to 3.5mm adapter. 9 10Loopback adapters can be purchased from [PassMark Software](https://www.passmark.com/products/audio-loopback-plug/). 11 12## Test Activities 13 14Launch OboeTester and then select one of the test Activities. 15 16### Test Output 17 18Tap the green bar to expand the Settings display. 19 20Test opening, starting, stopping and closing a stream. 21Various stream parameters can be selected before opening. 22While the stream is playing, the frame counts and stream state are displayed. 23The latency is estimated based on the timestamp information. 24 25Experiment with changing the buffer size to see if there are glitches when the size is high or low. 26 27Experiment with changing the "Workload". 28Watch the frame counters and the #XRuns. 29The audio is expected to glitch when the workload is high because there is too much work 30and the audio task misses its delivery deadlines. 31 32The extra workload is generated by calculating a random number in a loop and then adding the result to the output at an inaudible level. This technique prevents the compiler optimizer from skipping the work. The workload fader is in arbitrary units that determines the number of loops. 33You can see the affect of the changing workload in the "% cpu" report in the status area. 34The extra workload will always cause glitching when you get close to 100% CPU load. 35If the workload is causing glitching at a low % CPU load then there may be a problem with the callback timing. 36 37Instructions for using TEST OUTPUT for 4 or more chanels is in 38[Wiki/OboeTester_MultiChannelOutput](https://github.com/google/oboe/wiki/OboeTester_MultiChannelOutput). 39 40### Test Input 41 42Test input streams. Displays current volume as VU bars. 43 44### Tap to Tone Latency 45 46Measure touch screen latency plus audio output latency. 47Open, Start, then tap on the screen with your fingertip. 48The app will listen for the sound of your fingernail tapping the screen 49and the resulting beep, and then measure the time between them. 50 51If you use headphones then you can eliminate the latency caused by speaker protection. 52If you use USB-MIDI input then you can eliminate the latency due to the touch screen, which is around 15-30 msec. 53MIDI latency is generally under 1 msec. 54This test works well for measuring the latency of Bluetooth headsets. 55 56More instructions in the [Wiki/OboeTester_TapToTone](https://github.com/google/oboe/wiki/OboeTester_TapToTone). 57 58### Record and Play 59 60* Tap RECORD to record several seconds of audio. You should see the red VU meters move. 61* Tap STOP then PLAY to play it back. 62* Tap SHARE button to the recorded WAV file to GDrive, GMail or another app. 63You can then examine the WAV file using a program like Audacity. 64 65### Echo Input to Output 66 67This test copies input to output and adds up to 3 seconds of delay. 68This can be used to simulate high latency on a phone that supports low latency. 69Try putting the phone to your ear with the added delay at 0 and try talking. 70Then set it to about 700 msec and try talking on the phone. Notice how the echo can be very confusing. 71 72The test will also display estimated "cold start latency" for full duplex streams. 73 74### Round Trip Latency 75 76This test works with either a [loopback adapter](https://source.android.com/devices/audio/latency/loopback) or through speakers. 77Latency through the speakers will probably be higher. 78It measures the input and output latency combined. 79 801. Set the Input or Output settings by tapping the green bar to expose the controls. 812. Set the volume somewhere above the middle. The test works at almost any volume. But the confidence will be higher at higher volumes. 823. Tap "MEASURE" to make a single measurement. 834. Or tap "AVERAGE" to run the test several times and report an average and Mean Absolute Deviation. 84 85The test starts by setting up a stable full-duplex stream. 86Then it outputs a random series of bits encoded using smoothed Manchester Encoding. 87We record the Input and Output stream together for about a second. 88Then we correlate the two streams by sliding the portion of the output stream that contains the random bits over the input stream at different time offsets. 89The Manchaster Encoded signal provide a very sharp peak when the offset matches the combined input and output latency. 90 91Source code for the analyzer in [LatencyAnalyzer.h](https://github.com/google/oboe/blob/main/apps/OboeTester/app/src/main/cpp/analyzer/LatencyAnalyzer.h). 92 93### Glitch Test 94 95This test works best with a loopback adapter. But it can also work in a quiet room. 96It plays a sine wave and then tries to record and lock onto that sine wave. 97If the actual input does not match the expected sine wave value then it is counted as a glitch. 98The test will display the maximum time that it ran without seeing a glitch. 99 100Look for the #XRuns display. 101If #XRuns increments when a glitch occurs then the glitch is probably due to preemption of the audio task. 102If #XRuns is not incrementing then the glitches may be due to AAudio MMAP tuning errors in the HAL. 103 104### Auto Glitch Test 105 106Measure glitches for various combinations of input and output settings. 107Change the test duration to a high value and let it run for a while. 108If you get glitches in one configuration then you can investigate using the previous manual Glitch Test. 109The Share button will let you email the report to yourself. 110 111### Test Disconnect 112 113You can test whether the disconnect logic is working in Android by plugging or unplugging a headset. 114Just follow the instructions in red. You will get a report at the end that you can SHARE by GMail or Drive. 115 116### Data Paths 117 118This checks for dead speaker and mic channels, dead Input Presets and other audio data path problems. 119 1201. Tap "DATA PATHS" button. 1211. Unplug or disconnect any headphones. 1221. Set volume to medium high. 1231. Place the phone on a table in a quiet room and hit START. 1241. Wait a few minutes, quietly, for the test to complete. You will hear some sine tones. 1251. You will get a report at the end that you can SHARE by GMail or Drive. 126