audio810(7D)							      Devices							      audio810(7D)

NAME

       audio810 - Intel ICH series, nVidia nForce series and AMD 8111 audio core support.

DESCRIPTION

       The audio810 driver provides support for AC 97 audio controllers embedded in Intel ICH, nVidia nForce, and AMD 8111 chips.

APPLICATION PROGRAM INTERFACE

       This interface is described in the mixer(7I) and audio(7I) man pages.

   Driver Versions
       Applications  that  open  /dev/audio  may  use the AUDIO_GETDEV ioctl(2) to determine which audio device is being used. The audio810 driver
       returns the string SUNW,audio810 in the name field of the audio_device structure. The version field contains a letter "a"  and  the  config
       field contains the string onboard1.

       Platform 			  Ver.	 Out   H. Phone 		      Spkr.   In   Mic.   CD
       Sun  W1100z/ W2100z workstation	  a	 Y     Y			     Y	      Y    Y	  Y

       Key to the above table: Ver. = Version. Out = Line Out. H. Phone = Head Phone. Spkr = Internal Speaker. In = Line In. Mic. = Microphone. CD
       = CD=ROM.

       The audio810 device provides support for the internal speaker, headphone, line  out,  line  in,	and  microphone.  The  play.mod_ports  and
       record.mod_ports fields of the audio_info structure (see audio(7I)) indicate which ports may be manipulated.

   Audio Mixer Mode
       This driver supports the mixer mode only. (Compat mode is not supported).

   Audio Data Formats
       The  audio810  device  supports	16-bit linear encodings in stereo. With the mixer enabled, a continuous range of sample rates from 5510 to
       48000 Hz is  supported. With the mixer disabled, only sample rate 48000 Hz is supported. This is limited by hardware capability. The device
       can be opened for simultaneous play and record whether the mixer is enabled or not.

   Sample Granularity
       Because the audio810 device manipulates buffers of audio data, the reported input and output sample counts will vary at any given time from
       the actual sample count by no more than the size of the buffers the audio810 driver is transferring. In general, programs should  not  rely
       on the absolute accuracy of the play.samples and record.samples fields of the audio_info structure.

   Interrupt Rate
       The  driver  determines	how  often play and record interrupts should take place. For playing audio, this determines how often and how much
       audio is requested from the audio mixer. The impact of interrupts on recording is minimal. However, if a very small  read  buffer  size	is
       set,  the record interrupt rate should be increased to prevent the buffer from overflowing. The play and record interrupt rates are tunable
       in the /kernel/drv/audio810.conf file.

   Audio Status Change Notification
       As described in the audio(7I) and mixer(7I) man pages, it is possible to request asynchronous notification of changes in the  state  of	an
       audio device.

ERRORS

       audio810 errors are described in the audio(7I) man page.

FILES

       /dev/audio		      Symbolic link to the system's primary audio device. (Not necessarily an audio810 audio device).

       /dev/audioctl		     Control device for the primary audio device.

       /dev/sound/0		     Represents the first audio device on the system. (Not necessarily an audio810 audio device).

       /dev/sound/0ctl		     Audio control for /dev/sound/0.

       /usr/share/audio/samples      Audio sample files.

       /kernel/drv/audio810.conf     audio810 driver configuration file.

ATTRIBUTES

       See attributes(5) for a descriptions of the following attributes:

       +--------------------+--------------------------------------+
       |  ATTRIBUTE TYPE    |		ATTRIBUTE VALUE 	   |
       +--------------------+--------------------------------------+
       |Architecture	    |PC-based system			   |
       +--------------------+--------------------------------------+
       |Availability	    |SUNWaudd, SUNWauda 		   |
       +--------------------+--------------------------------------+
       |Stability level     |Evolving				   |
       +--------------------+--------------------------------------+

SEE ALSO

       mixerctl(1), sdtaudiocontrol(1), ioctl(2), attributes(5), audio(7I), mixer(7I), streamio(7I)

       AMD-8111 HyperTransport I/O Hub Data Sheet -- Advanced Micro Devices Inc.

       ALC655 Specification -- Realtek Inc.

       http://www.sun.com/io

NOTES

       Some  laptops  (including Sony VAIO, among others), have their on-board amplifier powered down by default, meaning that audio is suppressed
       even if hardware and the audio810 driver are  working  normally.  To  correct  this,  set  the  ac97-invert-amp=1  property  in	the  /ker-
       nel/drv/audio810.conf to power-up the amplifier.

DIAGNOSTICS

       In addition to being logged, the following messages may appear on the system console:

       init_state() play interrupt rate set too low

	   The	play  interrupt rate in audio810.conf is set too low. It has been reset to the rate specified in the message. Update audio810.conf
	   to a higher play interrupt rate.

       init_state() play interrupt rate set too high

	   The play interrupt rate set in audio810.conf is set too high. It  has  been	reset  to  the	rate  specified  in  the  message.  Update
	   audio810.conf  to a lower play interrupt rate.

       init_state() record interrupt rate set too low

	   The record interrupt rate in audio810.conf is set too low. It has been reset to the rate specified in the message. Update audio810.conf
	   to a higher record interrupt rate.

	init_state() record interrupt rate set too high

	   The record interrupt rate in  audio810.conf is set too high.  It  has  been	reset  to  the	rate  specified  in  the  message.  Update
	   audio810.conf  to a lower record interrupt rate.

SunOS 5.11							    20 Nov 2006 						      audio810(7D)