Release notes for the LynxTwo driver
====================================

NOTICE! This version of the LynxTwo OSS driver is a beta test version.
This means that the driver has not been tested completely. You need to be very
carefull before using this driver version in production environment.
Also some features are still missing (see the problems section below).

The LynxTWO driver of OSS is based on the same "HAL" code than the
Windows and Mac drivers. For that reason the functionality is practically
identical with them. However the interface (API) to applications is 100%
pure OSS so practically all OSS compatible applications will work with the
driver.

Usage
-----

Just like in Windows/Mac there are 8 playback device files and 8 recording
device files available to the applications. To find out the actual device
numbering you need to take a look at the printout produced by
"cat /dev/sndstat" command.

The routings between these
rcording and playback devices are handled by the on board mixer.
Due to size of the mixer there are three OSS mixer devices. You can change
the mixer/control panel settings using the ossxmix program included in the
OSS package.

The actual device numbering will be different if you have some other audio
devices in your system. However by defaut you can access the mixers with:

ossxmix -d0 (Adapter window)
ossxmix -d1 (Record/Play window)
ossxmix -d2 (Outputs window)

Please refer to the LynxTwo Installation and Users Guide (shipped with the card)
for more information about the mixer windows. There may be some differences
between the Windows/Mac driver and OSS but mostly the information given in
this guide is valid for OSS too.

Known problems
==============

At this moment the only known "bug" is that concurrent applications using the
LynxTWO card will fail if they don't use exactly the same sampling rate. This
must be handled manally at this moment.

However please note that OSS 3.99.0-test -version itself is a beta test release
so there may be some other bugs in some other parts of the driver.

Limitations
-----------

The following features are missing from this LynxTWO driver version. Some of
them will be automatically implemented in near future. Some of them will be
implemented only if somebody needs them.

- The LStream 2 port is not supported.
- The C and D inputs of the output mixer channels are not supported.
- The LTC generator/detector is not supported.
- Digital output status bits are not changeable.
- The ossxmix mixer screen require at least 1200x1600 display resolution
to fit on the screen. It's possible to use smaller screen resolutions but
all controls will not fit on the screen at the same time.