======================================================================

                    R E A D M E . F R E E B S D 

                    doc: Thu Jan 19 09:43:38 2006

                    (c) 2006 A.M. Thurnherr

======================================================================

This file contains FreeBSDE-specific notes for installing and running

bbabble and the LDEO LADCP operator scripts.

======================================================================

PREREQUISITE SOFTWARE

======================================================================

-------

1. perl

-------

perl is part of the standard FreeBSD installation. In order to test it,

run

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

If there is an error, a threaded perl has to be installed (possibly by

local compilation).

If the perl executable does not reside in /usr/bin, the 1st line of

[bbabble] has to be modified. 

------

2. gcc

------

gcc, a C pre-processor, is part of the developer tools. 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. lrb

------

lrb is the receiver-component of a public-domain implementation of the

ymodem protocol called lrzsz. It 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, run

lrb --help

In order to install lrb, run the following commands:

tar xfz lrzsz-0.12.20.tar.gz

cd lrzsz-0.12.20

./configure

make

sudo make install

---------

4. expect

---------

expect is NOT part of the standard FreeBSD installation and must be 

installed separately (e.g. from /usr/ports/lang/expect). 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 *).

---------

5. scanbb

---------

scanbb is part of Eric Firing's LADCP processing software, which is

available from http://moli.soest.hawaii.edu/software/ladcp. While

binary versions are available for a variety of systems, FreeBSD is not

one of them (although the linux binary may work). Compilation is

non-trivial and requires hacking of the source. If scanbb is not

available, LADCP-data-file checking can be disabled by modifying the

however.

======================================================================

TTY DEVICE NAMES

======================================================================

Each serial port on a FreeBSD system is associated with two separate

tty special files, e.g. /dev/ttyd0 and /dev/cuad0 in case of the first

built-in RS-232 port (com1 to those from underpriviledged backgrounds).

ONLY THE CALLOUT VERSION (/dev/cu*) CAN BE USED. THE NON-CALLOUT VERSION

(/dev/tty*) WILL CAUSE bbabble TO BLOCK ON STARTUP WITHOUT ANY ERROR

MESSAGE!