1.\" $OpenBSD: envy.4,v 1.16 2011/03/07 19:56:10 jmc Exp $ 2.\" 3.\" Copyright (c) 2007 Alexandre Ratchov <alex@caoua.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: March 7 2011 $ 18.Dt ENVY 4 19.Os 20.Sh NAME 21.Nm envy 22.Nd VIA Envy24 audio device 23.Sh SYNOPSIS 24.Cd "envy* at pci?" 25.Cd "audio* at envy?" 26.Cd "midi* at envy?" 27.Sh DESCRIPTION 28The 29.Nm 30driver supports sound cards based on VIA Envy24 and Envy24HT PCI chips. 31The following sound cards are currently supported: 32.Pp 33.Bl -bullet -compact -offset indent 34.It 35Dynex DX-SC51 36.It 37ESI Julia 38.It 39M-Audio Delta 1010, 1010LT, 66 and 44 40.It 41M-Audio Audiophile 2496 42.It 43M-Audio Revolution 5.1 44.It 45M-Audio Audiophile 192k 46.It 47Terratec EWX 24/96 48.It 49VIA Tremor 5.1 50.El 51.Ss Mixer device 52The chip features a digital mixer that routes and mixes the 53streams below as follows: 54.Bl -tag -width playback 55.It Dv inputs 56There are 8 streams corresponding to data received by the 57device from the codecs. 58They are labelled 59.Va line0 60\(en 61.Va line7 62in the 63.Xr mixer 4 64interface. 65.It Dv outputs 66There are 8 streams corresponding to data sent by the device to the codecs. 67They are labelled 68.Va line0 69\(en 70.Va line7 . 71Each of them can be individually configured to use any of 72the external inputs or its corresponding playback stream as source. 73Additionally, outputs 74.Va line0 75and 76.Va line1 77can be configured to use 78.Va mon0 79or 80.Va mon1 81as sources. 82.It Dv monitor 83There are 2 streams that can be configured to contain any linear 84superposition of any of the 10 playback and 10 external input streams. 85They are labelled 86.Va mon0 87and 88.Va mon1 . 89From the mixer's point of view they are input streams, 90so they can be used as sources of output streams. 91This feature is specific to Envy24 based cards. 92.It Dv playback 93There are 10 streams corresponding to samples transferred 94from the host to the device. 95They are labelled 96.Va play0 97\(en 98.Va play9 . 99From the mixer's point of view they are input streams, 100so they are usable as sources of output streams. 101.It Dv record 102There are 12 streams corresponding to samples transferred 103from the device to the host. 104They are not controllable by the mixer. 105Streams 0 to 7 are hardwired to external inputs 106.Va line0 107\(en 108.Va line7 109and streams 10 and 11 are hardwired to 110.Va mon0 111and 112.Va mon1 . 113.El 114.Ss Playback and record data formats 115Both playback and record use linear encoding. 116Samples are represented by 32-bit signed numbers in little endian order. 117Only the first 24 most significant bits are used. 118On Envy24-based cards, playback uses 10 channels and record uses 12 channels, 119while on Envy24HT-based cards the number of streams depend on the 120number of codecs physically present on the card. 121.Sh SEE ALSO 122.Xr audio 4 , 123.Xr intro 4 , 124.Xr midi 4 , 125.Xr pci 4 126.Sh HISTORY 127The 128.Nm 129driver first appeared in 130.Ox 4.3 . 131.Sh BUGS 132S/PDIF transmitter/receiver is not supported. 133.Pp 134Ring buffer sizes are limited to 64kB, 135which can be limiting at high sample rates. 136