1.\" $OpenBSD: envy.4,v 1.17 2020/05/17 05:48:39 ratchov 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: May 17 2020 $ 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 . 62.It Dv outputs 63There are 8 streams corresponding to data sent by the device to the codecs. 64They are labelled 65.Va line0 66\(en 67.Va line7 . 68Each of them can be individually configured to use any of 69the external inputs or its corresponding playback stream as source. 70Additionally, outputs 71.Va line0 72and 73.Va line1 74can be configured to use 75.Va mon0 76or 77.Va mon1 78as sources. 79.It Dv monitor 80There are 2 streams that can be configured to contain any linear 81superposition of any of the 10 playback and 10 external input streams. 82They are labelled 83.Va mon0 84and 85.Va mon1 . 86From the mixer's point of view they are input streams, 87so they can be used as sources of output streams. 88This feature is specific to Envy24 based cards. 89.It Dv playback 90There are 10 streams corresponding to samples transferred 91from the host to the device. 92They are labelled 93.Va play0 94\(en 95.Va play9 . 96From the mixer's point of view they are input streams, 97so they are usable as sources of output streams. 98.It Dv record 99There are 12 streams corresponding to samples transferred 100from the device to the host. 101They are not controllable by the mixer. 102Streams 0 to 7 are hardwired to external inputs 103.Va line0 104\(en 105.Va line7 106and streams 10 and 11 are hardwired to 107.Va mon0 108and 109.Va mon1 . 110.El 111.Ss Playback and record data formats 112Both playback and record use linear encoding. 113Samples are represented by 32-bit signed numbers in little endian order. 114Only the first 24 most significant bits are used. 115On Envy24-based cards, playback uses 10 channels and record uses 12 channels, 116while on Envy24HT-based cards the number of streams depend on the 117number of codecs physically present on the card. 118.Sh SEE ALSO 119.Xr audio 4 , 120.Xr intro 4 , 121.Xr midi 4 , 122.Xr pci 4 123.Sh HISTORY 124The 125.Nm 126driver first appeared in 127.Ox 4.3 . 128.Sh BUGS 129S/PDIF transmitter/receiver is not supported. 130.Pp 131Ring buffer sizes are limited to 64kB, 132which can be limiting at high sample rates. 133