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 con-
trollers embedded in Intel ICH, nVidia nForce, and AMD 8111
chips.
APLICATION 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 AUDIOGETDEV
ioctl(2) to determine which audio device is being used. The
audio810 driver returns the string SUNW,audio810 in the name
field of the audiodevice structure. The version field con-
tains 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.modports and record.modports fields of the audioinfo
structure (see audio(7I)) indicate which ports may be mani-
pulated.
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.
SunOS 5.11 Last change: 20 Nov 2006 1
Devices audio810(7D)
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 audioinfo 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 inter-
rupt 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.
ERORS
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.
SunOS 5.11 Last change: 20 Nov 2006 2
Devices audio810(7D)
/kernel/drv/audio810.conf audio810 driver configuration
file.
ATRIBUTES
See attributes(5) for a descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE 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 /kernel/drv/audio810.conf to power-up
the amplifier.
DIAGNOSTICS
In addition to being logged, the following messages may
appear on the system console:
initstate() 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.
SunOS 5.11 Last change: 20 Nov 2006 3
Devices audio810(7D)
initstate() 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.
initstate() 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 mes-
sage. Update audio810.conf to a higher record interrupt
rate.
initstate() 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 inter-
rupt rate.
SunOS 5.11 Last change: 20 Nov 2006 4
|