Round Trip Test (Manual) - Certification
This manual test verifies the full-duplex requirement for audio devices.
This test verifies that an audio device can stream end to end by using the following verification mechanisms:
The first mechanism operates on device jack pairs, rendering to one endpoint and simultaneously capturing from another. If the captured buffer contains the signal that was rendered, the test passes.
The second mechanism uses an in-air process to verify the functionality of endpoints.
Test details
Associated requirements |
Device.Audio.Base.BasicDataFormats Device.Audio.Base.ExposedAudioEndpointsAreFunctional Device.Audio.Base.JackDetection Device.Audio.Base.ProperUSBDescriptors Device.Audio.Base.TimeSynchronizedSampleRates Device.Audio.Base.TipRing Device.Audio.UAACompliance.UAA Device.Audio.USB.USB |
Platforms |
Windows 7 (x64) Windows 7 (x86) Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows Server 2012 (x64) Windows Server 2008 R2 (x64) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86 Windows Server 2012 R2 |
Expected run time |
~15 minutes |
Categories |
Certification |
Type |
Manual |
Running the test
Before you run the test, complete the test setup as described in the test requirements: Audio Device Testing Prerequisites.
In addition, this test requires the following hardware:
For loopback tests, loopback cables must be plugged into all jacks that you are testing. These cables link render jacks to capture jacks.
For in-air tests, a microphone or other active capture source must be attached to all capture endpoints. (An example of an active capture source is an S/PDIF cable that is attached to an audio/video receiver [AVR] that is actively playing back audio.) Speakers or headphones must be attached to all render endpoints.
Before you run this test, note the following:
In loopback mode, the test verifies end-to-end streaming by using a hardware loopback cable. This cable must be connected before you run the test. This is usually a regular 3.5-mm audio cable that is plugged into both audio jacks. The test sends a signal out a render endpoint. The hardware cable then conveys this signal to the capture endpoint. The test captures this signal and compares it to the signal that was rendered.
In in-air mode, the test verifies basic functionality for all endpoints on the system. In the case of render endpoints, a sound file that contains a number from 1 through 9 is played back, and the test prompts you to correctly identify the number. For capture endpoints, the test prompts you to make noise. If the amplitude of the captured sound information is above the required threshold, the test passes.
Troubleshooting
For troubleshooting information, see Troubleshooting Audio Testing.
If you do not adjust the setting of the volume to unity gain (playback to 100 percent and recording to 0 percent), you may receive a failure for the external microphone. You can change the setting of the volume to unity gain for the test for a no-loopback-detected failure of the external microphone only.
More information
For loopback tests, the test checks each render device/capture device pair for the presence of a loopback signal. If the test cannot find a loopback signal, the test will fail. In this case, you can check the ShellRunner.wtl log file to determine which endpoints were tested.
If the test reports that it could not find a loopback, the reasons may include the following:
No loopback cable is connected for that type of device.
The render endpoint that is in use is not working.
The capture endpoint that is in use is not working.
The loopback volume is too low or too distorted to detect a signal.
For in-air render tests, the test plays back a sound file to each render endpoint that you are testing. In each case, the test prompts you to identify the word that is spoken in the file from a list of possible choices. If you select the incorrect word, or if the test encounters an error while it is rendering audio, the test will fail. In this case, you can check the ShellRunner.wtl log file for more information about the failure.
If you cannot hear the word that the test plays back, the reasons may include the following:
No speakers or headphones are attached to the endpoint.
The endpoint is muted, or the endpoint volume is set too low.
The endpoint is not working.
For in-air capture tests, the test records data from each capture endpoint on the system. If the recorded audio is not loud enough, the test prompts you to make noise. If the test still cannot identify any recorded sound, or the test encounters an error at any point while it is capturing audio, it will fail. In this case, you can check the ShellRunner.wtl log file for more information about the failure.
If the test cannot detect recorded sound, the reasons may include the following:
No microphone or active audio source is attached to the endpoint.
The endpoint is muted, or the endpoint volume is set too low.
The endpoint is not working.
An acoustic echo cancelling (AEC) algorithm can negate the signal used for in-air roundtrip testing. If your product implements an AEC and you’re seeing failures in this test, using an external audio device (such as the USB speakerphone needed for the WHCK Communications Audio Fidelity Test) as the control will workaround this issue. This entails using the external device to capture the render endpoints under test and to produce the signal for the capture endpoints under test.
Command syntax
| Command option | Description |
|---|---|
ShellRunner |
Without any options, the test enumerates devices. |
-c <filename>.pro |
This option starts the application and runs the test cases that are specified in the <filename>.pro file. |
-h [string] |
This option specifies the Plug and Play (PnP) ID of the device to be tested. |
Logo_win7_roundtrip.pro |
This is the .profile file of test cases to be run for Windows 7. |
Logo_Vista_Roundtrip.pro |
This is the .profile file of test cases to be run for Windows Vista. |
Note
For command-line help for this test binary, type /h
File list
| File | Location |
|---|---|
ShellRunner.exe |
<testbinroot>\nttest\multimediatest\Common\WDK\ |
Roundtrip.dll |
<testbinroot>\nttest\\multimediatest\AVCore\Audio\bin\ |
Audiostreaming.dll |
<testbinroot>\nttest\multimediatest\AVCore\Audio\bin\ |
Sndanlyz.dll |
<testbinroot>\nttest\multimediatest\common\ |
Logo_win7_roundtrip.pro |
<testbinroot>\nttest\multimediatest\AVCore\Audio\Profiles\ |
Logo_Vista_Roundtrip.pro |
<testbinroot>\nttest\multimediatest\AVCore\Audio\Profiles\ |
S98wtt_u.dll |
<testbinroot>\nttest\multimediatest\common\ |
Note
ShellRunner.exe is the shell test binary, Roundtrip.dll is the test binary, Audiostreaming.dll is the streaming helper binary, and Sndanlyz.dll is the analysis helper binary.