.\" $OpenBSD: envy.4,v 1.2 2007/10/29 11:38:27 ratchov Exp $
.\"
.\" Copyright (c) 2007 Alexandre Ratchov <alex@caoua.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: October 29 2007 $
.Dt ENVY 4
.Os
.Sh NAME
.Nm envy
.Nd VIA Envy24 audio device
.Sh SYNOPSIS
.Cd "envy* at pci?"
.Cd "audio* at envy?"
.Sh DESCRIPTION
The
.Nm
driver supports sound cards based on VIA Envy24 PCI chips,
such as the M-Audio Delta-1010LT PCI card.
The Envy24 chip, formerly known as the ICE1712, is a versatile digital
PCI chip that can be attached to
up to 4x2 external analog converters and 2x2 S/PDIF transmitter/receivers.
Currently only Asahi Kasei AK4524 codecs are supported.
.Ss Mixer device
The chip features a digital mixer that routes and mixes the
streams below as follows:
.Bl -tag -width playback
.It Dv inputs
There are 10 streams corresponding to data received by the
device from the codecs.
They are labelled
.Va in0
\(en
.Va in9
in the
.Xr mixer 4
interface.
Streams
.Va in0
to
.Va in7
correspond to analog inputs and
.Va in8
to
.Va in9
correspond to
digital inputs.
.It Dv outputs
There are 10 streams corresponding to data sent by the device to the codecs.
They are labelled
.Va out0
\(en
.Va out9 .
Streams
.Va out0
to
.Va out7
correspond to analog outputs and
.Va out8
to
.Va out9
correspond to digital outputs.
Each of them can be individually configured to use any of
the external inputs or its corresponding playback stream as source.
Additionally,
.Va out0 , out1 , out8 ,
and
.Va out9
can be configured to use
.Va mon0
or
.Va mon1
as sources.
.It Dv monitor
There are 2 streams that can be configured to contain any linear
superposition of any of the 10 playback and 10 external input streams.
They are labelled
.Va mon0
and
.Va mon1 .
From the mixer's point of view they are input streams,
so they can be used as sources of output streams.
.It Dv playback
There are 10 streams corresponding to samples transferred
from the host to the device.
They are labelled
.Va play0
\(en
.Va play10 .
From the mixer's point of view they are input streams,
so they are usable as sources of output streams.
.It Dv record
There are 12 streams corresponding to samples transferred
from the device to the host.
They are not controllable by the mixer.
Streams 0 to 9 are hardwired to external inputs
.Va in0
\(en
.Va in9
and streams 10 and 11 are hardwired to
.Va mon0
and
.Va mon1 .
.El
.Ss Playback and record data formats
Both playback and record use linear encoding.
Samples are represented by 32-bit signed numbers in little endian order.
Only the first 24 most significant bits are used.
Playback uses 10 channels and record uses 12 channels.
.Sh SEE ALSO
.Xr audio 4 ,
.Xr intro 4 ,
.Xr pci 4
.Sh HISTORY
The
.Nm
driver first appeared in
.Ox 4.3 .
.Sh BUGS
PGAs and deemphasis filters on the AK4524 codecs are not yet accessible
through the
.Xr mixer 4
interface.
.Pp
MIDI and S/PDIF transmitter/receivers are not yet supported.
.Pp
The current
.Xr audio 4
driver doesn't allow playback and record blocks to have the same duration,
making the device hardly usable for block based I/O in full-duplex.
Playback and capture cannot be started atomically.
Ring buffer sizes are limited to 64kB,
which can be limiting at high sample rates.