$  Copyright(c) 1995 Sun Microsystems, Inc.
$  All rights reserved.

$  #ident  "@(#)audiotest.msg  1.16  99/01/06  SMI"

$ VERBOSE
1	"Msg received: Type %d %s"
2	"Test Options: %s"
3	"Audio crystal test, rate = %d Hz, time = %d usecs"
4	"Using CD device = %s"
5	"CD table of contents (track %d thru %d)"
6	"Track %03d, type %d, mode %03d, lba %06d"
7	"Play CD track %d (%d seconds)"
9	"Audio music test"
10	"Audio music test, Pass = %d"
11	"FFT %s Band %d Hz - %d Hz INVALID TestBandRMS = %f, \
RefBandRMS = %f, Threshold = %f"
12	"Pass = %d"
13	"Error = %d"
14	"Play gain = %d"
15	"rec_play: read/write %d bytes"
16	"Starting loopback test: %s"
17	"Play Gain = %d, Record Gain = %d"
18	\n"Quality Test : Pass = %d"
19	"Sample Rate =%6.0f Hz, Freq =%5.0f Hz  MONO %s"
20	"Sample Rate =%6.0f Hz, left =%5.0f Hz,  right =%5.0f Hz"
21	"	snr =%6.2f dB"
22	"left  : snr =%6.2f dB, gain =%6.2f dB, sep =%7.2f dB"
23	"right : snr =%6.2f dB, gain =%6.2f dB, sep =%7.2f dB"
24	"left  : snr =%6.2f dB, gain =%6.2f dB"
25	"right : snr =%6.2f dB, gain =%6.2f dB"
26	"Input DC offset : left = %6.3f %%, right = %6.3f %%"
27	"Retry = %d"
28	"Retried %d time(s) before passing. Total retries = %d."
29	"User scale set (%3.2f), Maximum 16-bit sinewave amplitude is %d"
30	"Mixer mode set to off successfully"
31	"Mixer mode restored successfully"
32	"left : gain =%6.2f dB"
33	"right: gain =%6.2f dB"

$ INFO
2000	%s specific arguments [defaults]:\n\
    B				(Brief test)\n\
    dev=<device name>		(ex: dev=/dev/sound/<unit_no>)\n\
    I=<ioctl device name>	(ex: I=/dev/sound/<unit_no>ctl)\n\
    L[=Enable|Disable]		(Loopback Test)\n\
    M[=Enable|Disable]		(Music Test)\n\
    Q				(Quality Test)\n\
    S[=Enable|Disable]		(Controls Test)\n\
    O=<speaker|headphone|line-out>	(Music output device)\n\
    V=<0-255>			(Music output volume)\n
2001	\
   T=<0|1|2|3|4|I1|I2|I3|I4|I5>	(Loopback Test Type)\n\
      0=codec-internal (CS4231 audio only)\n\
	NOTE: The codec-internal loopback runs by default on CS4231 audio.\n\
      1=Line-out/Line-in	(requires straight-through loopback)\n\
      2=Headphone/Line-in	(requires straight-through loopback)\n\
      3=Headphone/Microphone	(requires attenuated (-44db) loopback)\n\
      4=Speaker/CD-input\n\
      I1=Internal Line-out/Line-in\n\
      I2=Internal Speaker/Microphone\n\
      I3=Internal Headphone/Aux1\n\
      I4=Internal Speaker/Aux1\n\
      I5=Internal Headphone/Mic\n\
    X[=Enable|Disable]		(Crystal Test)\n\
    E				(Continue on Error)\n\
    LE				(Loop on Error)\n\
    LOOP			(Loop on play signal)\n
2002	\
   CD				(CD Play Test)\n\
    CDD=<CD device name>	(ex: CDD=/dev/rdsk/c0t6d0s0)\n\
    CDT=<[1-N]>			(CD Track)\n\
    CDG=<[0-255]		(CD Play Gain)\n\
    CDL=<[1-N]>			(CD Play Time in seconds)\n\
	NOTE: The above CD options are for Manufacturing test use only.\n\
    W				(Show Warning messages during loopback)\n\
    MF=<music file name>	(optional music file)\n\
    TF=<tolerance file>		(optional tolerance file)"\n
2003	\
audio debug options:\n\
    LE				(Loop on Error)\n\
    LOOP			(Continuously loop play signal)\n\
    NC				(Do Not Check against tolerances)\n\
    SA=<sample rate>		(user specified sample rate)\n\
    SCA=<scale>			(user specified scale of fullscale sinewave)\n\
    NCL				(Do Not run codec-internal Loopback)\n\
	NOTE: The codec-internal loopback is only supported on CS4231 audio.\n\
    DD=<1|2|3|4|7>		(Dump recorded data and FFT data)\n\
      1 = save the record data and FFT data to a text file\n\
	NOTE: this option creates the following files:\n\
		audio.dump.sample -- data from the last sample rate\n\
		audio.dump.all    -- data from a single test run\n\
		audio.dump.err    -- cumulative data from failing tests\n\
      2 = save an audio file (.au) of the play/record data that caused a failure\n\
      3 = combination of 1 and 2\n\
      4 = save audio files (.au) of all the play/record data\n\
      7 = combination of 3 and 4\n
2010	"%s= must be followed by a valid text string."\n
2011	"%s must be followed by a number."\n
2013	"Invalid loopback type (%s)."\n
2014	"Cannot set Play gain before loopback test selected"\n
2015	"Cannot set Record gain before loopback test selected"\n
2020	"Audio controls test"\n
2021	"Received Volume Up.\n\
PRESS VOLUME DOWN BUTTON ON SPEAKERBOX..."
2022	"PRESS VOLUME UP BUTTON ON SPEAKERBOX..."
2023	"Received Volume Down.\nPRESS MUTE BUTTON ON SPEAKERBOX..."
2024	"Received Mute.\nPRESS ANY BUTTON ON SPEAKERBOX AGAIN..."
2025	"Done.\nControls test passed"\n
2026	"WARNING: Unexpected volume up press."\n
2027	"WARNING: Unexpected volume down press."\n
2028	"WARNING: Unexpected mute press."\n
2030	Mono/Left channel
2031	Left channel
2032	Right channel
2040	"The play time %d sec exceeds time usually expected (%d sec) at \
track %d."
2041	"Invalid play time %d sec, using default %d sec."
2042	"Quality Test passed."
2043	"Quality Test passed with 1 retry."
2044	"Quality Test passed with %d retries."
2045	"LOOPING, Enter ^C to stop (s=%5d,f=%4d,%s)..."\n
2046	"LOOPING, Enter ^C to stop (s=%5d,l=%4d,r=%4d)..."\n
2050	'line-in'
2051	'speaker'
2052	'headphone'
2053	'microphone'
2054 Busy: <%s: Could not open, error = %s>
2055 Idle: <%s: %s>
2056	audio: Playing %d second(s) 1 KHz tone through the %s port...
2057	done.\n
2058 Debug status: <%s: %s, Driver: %s, Driver config: name=%s, \
config=%s, version=%s>
2059 Error: <%s: Could not open, error = %s>

$ WARNING
4000	"clean_up: Failed to open %s: %s.  Could not restore\
 original audio parameters."\n
4001	"clean_up: Failed ioctl %s: %s.  Could not restore\
 original audio parameters."\n
4002	"Overrun error detected after record." \
Probable_Cause(s): \
<Excessive loading on the system.  It usually does not affect test data. \
 If bad data is detected, a retry will be done.>
4003	"Underrun/Overrun error detected after record." \
Probable_Cause(s): \
<Excessive loading on the system.  It usually does not affect test data. \
If bad data is detected, a retry will be done.>
4004	"Loopback testing enabled, but no loopback test type selected."\n
4005	"Failed to open %s: %s.  Cannot save data."\n
4006	"Invalid encoding (%s) for audio file.  Cannot save data."\n
4007	"Failed to write %s: %s.  Cannot save data."\n
4008	"Using alternative method to determine platform."
4009	"kvm_* call failed.  Retrying..."
4010	"Audio play exceeded %d second time limit at track %d"
4011	"audio_quality: Retrying with data window offset %3.2f\n"
4012	"playrecord: incomplete write, wrote = %d, expected %d, errno = %d"
4013	"playloop: incomplete write, wrote = %d, expected %d, errno = %d"
4020	"%s: '%s(%s=0x%x, %s=0x%x, %s=0x%x)' system call hanging.  \
No response after %d seconds.  Device = %s.  retries left = %d." \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures do to \
excessive loading on the system.)>
4021	"Mixer control mode not available on device %s" \
Probable_Cause(s): \
<Mixer not supported on this platform> \
<System software problem>
4022	"Mixer control BUSY, could not get mode on device %s" \
Probable_Cause(s): \
<Mixer being used by another process> \
<System software problem>

$ ERROR
6000	"Signal To Noise ratio too low (%s) on %s, SNR =%7.2f db, Min \
SNR =%7.2f db (%s)" \
Probable_Cause(s): \
<Loopback cable is missing or faulty> \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6001	"Channel Separation too low (%s), SEP =%7.2f db, Min SEP =%7.2f \
db (%s)" \
Probable_Cause(s): \
<Loopback cable is faulty> \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6002	"Loop gain is out of range (%s), %s GAIN =%6.2f db, Min =%6.2f \
Max =%6.2f db (%s)" \
Probable_Cause(s): \
<Loopback cable is missing or faulty> \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6003	"Quality Test Failed, total number of errors = %d"
6010	"Signal To Noise ratio too low (%s) on %s, SNR =%7.2f db, Min \
SNR =%7.2f db (%s)" \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6011	"Channel Separation too low (%s), SEP =%7.2f db, Min SEP =%7.2f \
db (%s)" \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6012	"Loop gain is out of range (%s), %s GAIN =%6.2f db, Min =%6.2f \
Max =%6.2f db (%s)" \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6013	"Gain variation between channels exceeds tolerance (%s), \
Tolerance =%7.2f db, left GAIN =%7.2f db, right GAIN =%7.2f db (%s)" \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6014	"Gain variation between channels exceeds tolerance, (%s) \
Tolerance =%7.2f db, left GAIN =%7.2f db, right GAIN =%7.2f db (%s)" \
Probable_Cause(s): \
<Loopback cable is faulty> \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6015	"Signal-to-noise Ratio variation between channels exceeds \
tolerance (%s), Tolerance =%7.2f db, left SNR =%7.2f db, \
right SNR =%7.2f db (%s)" \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
6016	"Signal-to-noise Ratio variation between channels exceeds \
tolerance (%s), Tolerance =%7.2f db, left SNR =%7.2f db, \
right SNR =%7.2f db (%s)" \
Probable_Cause(s): \
<Loopback cable is faulty> \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>

$ FATAL
8000  "Must be super user (root) to execute" \
Probable_Cause(s): <User does not have root privileges>
8010	"Invalid audio device (%s) for Calibration test"
8011	"Invalid audio device (%s) for cdplay test" \
Probable_Cause(s): \
<Only (audiocs) SPARCstation-5 CS4231 on-board audio is supported>
8012	"Invalid audio device (%s) for Crystal test"
8013	"Invalid audio device (%s) for Controls test"
8014	"Invalid audio device (%s) for Loopback Quality test" \
Probable_Cause(s): \
<Loopback testing is not supported on this audio device>
8015	"Invalid audio device (%s) for Loopback Quality test (T=%d)" \
Probable_Cause(s): \
<The specified loopback type is not supported on this audio device>
8016	"Scale out of range (%3.2f), it must be between 0.1 and 1.0"
8020	"Incomplete button press sequence"
8021	"failed"
8022	"failed due to exceeding error limit"
8023	"Underrun/Overrun error failure"
8024	"Illegal Tolerance : %s"
8025	"Cannot open %s.  No data will be dumped."
8026	"Selected sample rate (%d) not supported in %s loopback test"
8027	"%s: '%s(%s=0x%x, %s=0x%x, %s=0x%x)' system call \
timeout.  No response after %d seconds.  Device = %s" \
Probable_Cause(s): \
<Audio hardware (usually consistent failures)> \
<System software problem (usually intermittent failures)>
8028	"Audio crystal test did not complete in the expected time, \
rate = %d Hz, time = %d usecs, min = %d, max = %d" \
Probable_Cause(s): \
<Excessive loading on the system> \
Recommended_Actions: <Disable all other tests and try again>
8029	"Speaker is an invalid output port for device"
8030	"Failed to open %s (%s)"
8031	"Failed to open %s (%s)" \
Probable_Cause(s): \
<The specified CD player is not attached or is being used by another process.> \
<The CD must be an audio CD, or have at least 1 audio track.  \
The Sun Demo Disk 1.0 has an audio track.>
8032	"Failed ioctl %s (%s)"
8033	"Failed mmap (%s)"
8034	"Failed fstat (%s)"
8035	"Failed ftruncate (%s)"
8036	"Write to audio device returned error condition (%s)"
8037	"Read from audio device returned error condition (%s)"
8038	"Failed to allocate %d bytes of memory (%s)"
8039	"Failed to open %s (%s), assuming device is okay and is being \
used by another process."
8050	"%s(%d, %s, 0x%x) failed: %s"
8051	"Unknown audio device (name=%s, config=%s)."
8052	"Unable to get platform name."
8053	"Unknown architecture/audio  = %s / %s."
8054	"%s failed."
8055	"Could not open %s: %s" \
Probable_Cause(s): \
<device does not respond> \
<no mmcodec device found> \
<Unable to communicate with speakerbox> \
Recommended_Actions: \
<Examine system message files (/var/adm/messages) for other information>
8056	"%s(%s, 0x%x) failed: %s"
8057	"Could not open %s: %s" \
Probable_Cause(s): \
<external speakerbox not attached> \
<device does not respond> \
<no mmcodec device found> \
<Unable to communicate with speakerbox> \
Recommended_Actions: \
<Examine system message files (/var/adm/messages) for other information>
8060	"CD track %d is not a valid track"
8061	"CD track %d is not an audio track"
8062	"There is no audio track on the current CD"
8063	"Invalid TOC header, first track %d, last track %d"
8064	"Audio stop before complete at track %d"
8065	"Unexpected audio status %d received at track %d"
8066	"Error occurred during audio play at track %d"
8070	"Signal still clipped"
8071	"Signal not clipped"
8072	"Signal is invalid"
8073	"Left channel of signal is invalid"
8074	"Right channel of signal is invalid"
8075	"Invalid audio file format"
8076	"A-law and u-law require 8 bit precision"
8077	"Invalid audio encoding"
8078	"FFT calculation failed"
8079	"RMS = %f out of tolerance, Lower Limit = %f, Upper Limit = %f, \
Reference RMS = %f"

8080	"Mixer is turned on. Please turn mixer off with "mixerctl -o" before running this test again."
8081	"Failed call to AUDIO_MIXERCTL_GET_MODE on device %s; errno = %d"
8082	"Call to sysinfo() failed"
8083	"Mixer was busy"
8084	"Failed call to AUDIO_MIXERCTL_SET_MODE on device %s; errno = %d"

8090	"Only one %s loopback can be selected at a time"
8091	"Cannot enable loopback testing without selecting a loopback type"
8092	"SunOS releases prior to 5.6 do not support internal CODEC \
loopback (t=%d)"

$ PROBE

10001	"WARNING: audio probe error: "
10002	"ERROR: Only one %s loopback can be selected at a time"
10003	"ERROR: Cannot enable loopback testing without selecting a loopback type"
