This is the README for the release 1.0.3 of the Communication
Automation Corporation Bullet33 Linux Software Package.

This release was tested using RedHat Enterprise Linux WS version 4.0.  With
the following Linux kernel versions:

       2.6.9-5.EL        (RedHat Enterprise Linux WS version 4)  

To build the software included in this release run the 'make' command
in the top level directory.  The command should build the user
application interface library, the diagnostic programs and the demo
program.  A pre-built version of the driver for kernel version
2.6.9-5.EL is included in the release.  To use the pre-built driver,
rename the driver, removing the OS version number, for example:

     bullet33_cs_2.6.9-5.EL.ko  ==> bullet33_cs.ko

And then run make install as super user in the linuxdev-2.6 device
driver directory.

This release of the driver supports multiple bullet33 cards.  The
device name for the bullet33 is '/dev/bulletX'.  Where 'X' is based on
the Card Socket number the device is plugged into.   See the INSTALL
file for instructions on how to install the device driver module.


==== 
DEMO
====

Included in this release is one demo program.  The program is called
'audio'.  The program downloads a DSP program called c33audio and
configures the CODEC interface.  The DSP program downloaded by the
'audio' application plays back the incoming audio data.  The user can
connect an audio source such as a CD player to the CODEC inputs and a set
of speakers to the CODEC output.  The DSP program will loop back the
incoming audio data to the CODEC outputs.  The 'audio' application
allows the user to control the initialization parameters of the CODEC.
To run the 'audio' application, change directories to the demo
sub-directory and enter the following command:

      ./audio

The 'audio' application must be run in the same directory that the
c33audio DSP program is located in so that the host application can
locate the DSP program to download it.


===========
DIAGNOSTICS
===========

Included in this release are three diagnostic programs.  The
diagnostic programs perform basic check-out of the Bullet33 card and
can be used to ensure that the Bullet33 Linux device driver module is
properly installed.  The 'diag' diagnostic program tests the SRAM and
DRAM memories on the Bullet33 card.  To run the 'diag' program, change
directories to the diag sub-directory and enter the following command:

      ./diag

The 'tifft' and 'tiscp' diagnostic programs test the CODEC interface
and they require a loop back adapter on the external card connector.
The loop back adapter connects the CODEC output to the CODEC input.
Both of these applications download a DSP program to the Bullet33
card.  The current versions of these application sometimes show errors
the first time they are run.  Typically if the application is
terminated by issuing a control-C and restarted the application will
run cleanly. To run these applications, change directories to the diag
sub-directory and enter one of the following commands:

      ./tifft -e 
          or 
      ./tiscp


The 'tifft' and 'tiscp' applications must be run in the same directory
that the their DSP programs are located in so that the host application
can locate the DSP program to download it.


=======
SUPPORT
=======

For technical support via email send emails to support@cacdsp.com,
for phone support we can be reach at (800) 367-6735 (USA only) or 
(610) 692-9526 or visit our web site at www.cacdsp.com.