======================================================================
                    R E A D M E . L I N U X 
                    doc: Thu Jan 19 09:43:38 2006
                    dlm: Thu Jan 19 12:28:19 2006
                    (c) 2006 A.M. Thurnherr
                    uE-Info: 90 53 NIL 0 0 72 3 2 4 NIL ofnI
======================================================================

This file contains Linux-specific notes for installing and running the
LDEO LADCP operator scripts.

======================================================================
PREREQUISITE SOFTWARE
======================================================================

-------
1. perl
-------

perl is part of most standard Linux installations. See Linux
documentation on how to install missing software. In order to test it,
run

/usr/bin/perl -e 'use threads'

If perl is not in /usr/bin, the 1st line of [bbabble] has to be
modified. 


------
2. gcc
------

gcc, a C pre-processor, is part of all Linux distributions, as far as I
am aware. In order to test it, run

gcc -E /usr/include/stdio.h > /dev/null

If you don't have gcc installed you'll have to modify [bbabble]. This is
for perl/system programming experts only.


---------
3. rb/lrb
---------

[l]rb is the receiver-component of a public-domain implementation of
the ymodem protocol called lrzsz. It exists as modules for most popular
Linux distributions. Alternatively, the source can be downloaded from
http://www.ohse.de/uwe/software/lrzsz.html. However, since the version
has not changed since December 1998 (version 0.12.20) the corresponding
tar file (lrzsz-0.12.20.tar.gz) is included in this directory.

In order to test whether lrb is already installed, at least one of the
following commands must work:

lrb --help
rb --help

Otherwise, you must install lrb. The following commands might work:

tar xfz lrzsz-0.12.20.tar.gz
cd lrzsz-0.12.20
./configure
make
sudo make install


---------
4. expect
---------

expect is part of most Linux distributions, I think. In order to test
it, run

/usr/bin/expect < /dev/null

If expect does not reside in /usr/bin, you'll have to edit all the
operator scripts (grep -l /usr/bin/expect *).


======================================================================
TTY DEVICE NAMES
======================================================================

The native RS-232 tty devices in Linux are called /dev/ttyS0,
/dev/ttyS1, ...  Most modern computers do not have multiple RS-232
ports the ADCP heads will most likely be connected to the acquisition
computer via USB-to-serial converters. The ones that we use at LDEO
have tty device names /dev/ttyUSB0, /dev/ttyUSB1, ...