|
|  以 PDF 格式下载本书
- CHAPTER 4
Audio Test (audio)
-
audio test verifies the hardware and software components of the audio subsystem. This test supports all Sun audio implementations.
- The audio device is an exclusive use device. Only one process or application can interface with it at a time. This test is not scalable.
- The availability of the following subtests depends on the particular audio implementation being tested.
audio Subtests
-
TABLE 4-1 audio
| Subtest | Description |
|
| Record/Play Test | This test plays and records one second of data. No data checking is
done. This test is run on all audio implementations |
| Crystal Test | The crystal test measures the accuracy of the crystal that generates the sample rate clock. It does this by playing a one-second signal and then measuring the actual time required to play the signal. This measurement is performed for each of the eight standard sample rates. This test is available for dbri(7) and audiocs(7) audio implementations |
| Loopback Tests | This test verifies the functionality and signal quality of the audio ports. The test simultaneously plays and records a known signal. The recorded signal is analyzed for loop gain and signal-to-noise ratio plus distortion. This is repeated at various sample rates, encodings, precisions and channels. The audio ports that are supported depend on the audio implementation under test. The audiocs(7) implementation supports loopbacks from/to headphone, line-out, microphone, and line-in. The dbri(7)/ speakerbox implementation supports fewer ports. The audioamd(7)implementation does not support loopback tests. Most tests require a stereo loopback cable. NOTE: The microphone loopback tests require special hardware and are used by manufacturing centers and special test facilities. Do not invoke the microphone loopback tests unless you have the required hardware |
| Controls Test | This test verifies the three control buttons on the Sun Speakerbox. The controls test plays music while the user is prompted to press the Volume Down, Volume Up, and Mute buttons in a specific order. If no button is pressed, the music plays for about 30 seconds, then stops, and returns an error. This test is only supported on the dbri(7)/speakerbox implementation |
| Audio Test | This test plays a 30-second music file out of the speaker or headphone. The user must decide if the test passes or fails. Badly distorted audio, or no audible music indicates a problem. This test is supported on all audio implementations |
audio Options
- Upon start-up, the SunVTS probe utility determines which audio implementation is present and adjusts the audio option menu appropriately. The possible option menus are as follows:
FIGURE 4-1 audioaudioamd(7)
- The audioamd(7) is an 8-bit mono, telephone-quality, audio device.
FIGURE 4-2 audiodbri(7) audio
- The speakerbox dbri is a high-quality 16-bit stereo multimedia codec.
FIGURE 4-3 audio dbri(7
- with no Speakerbox Attached
- This is an on-board, high-quality 16-bit stereo multimedia codec.
FIGURE 4-4 audiodbri(7)
- and S240
- This is an on-board, high-quality 16-bit stereo multimedia codec.
FIGURE 4-5 audioaudiocs(7)
- The audiocs(7)is an on-board, high-quality 16-bit stereo multimedia codec.
FIGURE 4-6 audioaudiocs
- The audiocs(7) is an on-board, high-quality 16-bit stereo multimedia codec.
-
Note - The internal loopbacks are only active if the audio jacks are unused (nothing connected).
- Some options can only be selected through the command line. See the command line option descriptions in "audio Command Line Syntax" on page 34.
-
TABLE 4-2 audio
| Option | Description |
|
| Audio test | Enables or disables the music play test. This test is enabled by default |
| Audio Output | Selects the output port for the music play test |
| Volume | Sets the volume for the music play test |
-
TABLE 4-2 audio(Continued)
| Option | Description |
|
| Loopback test | enables or disables the loopback test. A loopback cable must be installed between the selected ports to run this test. This test is disabled by default |
| Loopback type | selects the type of loopback test to run |
| Crystal test | enables or disables the crystal test. This test is disabled by default |
| Controls test | enables or disables the speakerbox controls test. This is an interactive test and the user is prompted to press the control buttons on the speakerbox. This test is disabled by default |
-
Note - Do not run the crystal test while running other SunVTS tests. The crystal test is timing-dependent. If the system is too busy, it fails due to time-out errors.
audio Test Modes
-
TABLE 4-3 audio
| Test Mode | Description |
|
| Connection Test | A simple open and close is done on the audio device. No data is transferred. The test returns a pass if the device can be opened and closed successfully. If the device cannot be opened because it is busy, then it is assumed that the device is successfully connected to another process and the test passes |
| Functional Test | The record/play test is run and the user can optionally run any of the tests described earlier. In this mode, the test will fail if the device is busy. If you invoke SunVTS through SyMON, the following Functional Test description applies: The record/play test is run. If the device cannot be opened because it is busy, then it is assumed that the device is successfully connected to another process and the test passes
|
audio Command Line Syntax
-
-
/opt/SUNWvts/bin/audio standard_arguments -o dev=/dev/sound/
<unit_no>,I=/dev ioctl_device, M, L, Q, S,
T=loopback_test_type,X,E,LE,CD,CDD=CD_device_name,
CDT=track_number,CDG=play_gain,CDL=play_time,W,
MF=filename,TF=filename
-
TABLE 4-4 audio
| Argument | Explanation |
|
dev=/dev/
audio_device | Specifies the audio device to be tested. The
default is dev=/dev/audio |
| I=/dev/ioctl_device | Specifies the audio ioctl device to be tested; the default is
/dev/audioctl.
|
| M | Enables the music play test. |
| L | Enables the loopback test. |
| Q | Enables the quality test. This option does the same thing as L option except that it prints an extra status message upon completion. |
| S | Enables the speakerbox controls test. |
| T=loopback_test_type | Specifies the type of loopback test. The default is 1; the choices are listed below. 0 Speaker/Microphone 1 Line-in/Line-out 2 Headphone/Line-in 3 Headphone/Microphone 4 Speaker/CD-input I1 Internal Line-in/Line-out I2 Internal Spk/Mic I3 Internal Headphone/Aux1
Note: Test types 0, 3, an 4 require special hardware, and are used by manufacturing centers and special test facilities. Do not invoke these tests unless you have the required hardware.
|
| X | Enables the Audio Crystal test. |
| E | Continues testing if an error occurs. |
-
TABLE 4-4 audio(Continued)
| Argument | Explanation (Continued) |
|
| LE | Loops on Error. This plays the signal data in a continuous loop. |
| CD | Enables the cdtest. This is for systems with an internal CD-ROM drive. A CD disc with music tracks must be loaded prior to running this test. |
| CDD=CD_device_name | Specifies the raw device name for the CD-ROM drive. The default is CDD=/dev/rdsk/c0t6d0s0. |
| CDT=number | Specifies the track number of CD-ROM to play. The default is to play the first track on the disc. |
| CDG=play_gain | Specifies the play gain of the CD Play test (0 to 255). The default is 120. |
| CDL=play_time | Specifies the number of seconds to run the CD Play test. The default is 30 seconds. |
| W | Shows warning messages during the loopback test. |
| MF=filename | Selects an optional music file. |
| TF=filename | Specifies an optional tolerance file. Note: The tolerance file is used by manufacturing centers and special test facilities. Do not use this option unless you are familiar with the tolerance file format. |
audio Error Messages
-
TABLE 4-5 audio
| Error Message | Probable Cause(s) | Suggested Action (if applicable) |
|
| 6000 | Signal To Noise ratio too low (<name>) on <name>, | Loopback cable is missing or faulty |
|
| SNR =<number> db, Min SNR =<number> db (<text>) | Audio hardware (usually consistent failures) |
|
|
| System software problem (usually intermittent failures) |
|
-
TABLE 4-5 audio(Continued)
| Error Message | Probable Cause(s) | Suggested Action (if applicable) |
|
| 6001 | Channel Separation too low | Loopback cable is faulty |
|
| (<name>), SEP =<number> db, Min SEP =<number> db (<text>) | Audio hardware (usually consistent failures) |
|
|
| System software problem (usually intermittent failures) |
|
| 6002 | Loop gain is out of range (<name>), <name> GAIN | Loopback cable is missing or faulty |
|
| =<number> db, Min =<number> Max =<number> db (<text>) | Audio hardware (usually consistent failures) |
|
|
| System software problem (usually intermittent failures) |
|
| 8000 | Must be super user (root) to execute | The user does not have root privileges. |
|
| 8012 | Invalid audio device (<device_name>) for Crystal test | The crystal test is not supported on the system audio device |
|
| 8013 | Invalid audio device (<device_name>) for Controls test | The system audio device does not support a speakerbox |
|
| 8014 | Invalid audio device (<device_name>) for Loopback Quality test | No loopback tests are supported on the system audio device |
|
| 8015 | Invalid audio device (<device_name>) for Loopback Quality test | The specified loopback test is not supported on the system audio device |
|
| (T=<number>) | The specified loopback type is not supported on this audio device |
|
| 8020 | Incomplete button press sequence | The required button presses were not detected in the time allowed |
|
| 8023 | Underrun/Overrun error failure | The audio driver detected underrun or overrun errors while transferring data to the audio device. These errors usually happen when the loopback test is run while there is heavy system activity |
|
-
TABLE 4-5 audio(Continued)
| Error Message | Probable Cause(s) | Suggested Action (if applicable) |
|
| 8027 | <name>: | The system call is hanging |
|
| '<name>(<name>=<number>,
<name>=<number>,
<name>=<number>)' system | Audio hardware (usually
consistent failures) |
|
| call timeout. No response after <number> seconds. Device = <device_name> | System software problem (usually intermittent failures) |
|
| 8028 | Audio crystal test did not complete in the expected time, rate = <number> Hz, time = <number> usecs, min = <number>, max = <number> | Excessive loading on the system | Disable all other tests and try again |
| 8029 | Speaker is an invalid output port for device | The system does not have an on-board speaker |
|
| 8032 | Failed ioctl <name> (<error_message>) | The ioctl( ) system call failed. | See the appended error message |
| 8033 | Failed mmap
(<error_message>) | The mmap( ) system call failed. | See the appended error
message |
| 8034 | Failed fstat
(<error_message>) | The fstat( ) system call failed. | See the appended error
message |
| 8035 | Failed ftruncate
(<error_message>) | The ftruncate( ) system call
failed. | See the appended error
message |
| 8036 | Write to audio device returned error condition (<error_message>) | The write( ) system call failed. | See the appended error message |
| 8037 | Read from audio device returned error condition (<error_message>) | The read( ) system call failed. | See the appended error message |
| 8038 | Failed to allocate <number> bytes of memory (<error_message>) | The memory allocation system call failed, most likely due to a lack of system memory resource. | See the appended error message |
| 8051 | Unknown audio device (name=<device_name>, config=<name>) |
|
|
| 8052 | Unable to get platform name |
|
|
| 8053 | Unknown architecture/audio = <name> / <device_name> |
|
|
-
TABLE 4-5 audio(Continued)
| Error Message | Probable Cause(s) | Suggested Action (if applicable) |
-
-
8055 Could not open
- The open( ) system call failed Examine system message
-
-
<device_name>: files (/var/adm/messages)
- <error_message>
- Device does not respond
- for other information
-
| No mmcodec device found |
| Unable to communicate with speakerbox |
-
| 8075 | Invalid audio file format | Specified audio file is not in
expected format |
|
| 8077 | Invalid audio encoding | An unknown audio encoding
type was specified |
| 8090 | Only one <name> loopback
can be selected at a time | The user specified more than
one loopback test on the same
port |
| 8091 | Cannot enable loopback
testing without selecting
a loopback type | The user enabled loopback
testing but did not specify
a loopback type |
|
|
