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

                    R E A D M E . M A C O S X 

                    doc: Thu Jan 19 09:43:38 2006

                    (c) 2006 A.M. Thurnherr

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

This file contains MacOSX-specific notes for installing and running the

LDEO LADCP operator scripts.

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

PREREQUISITE SOFTWARE

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

NOTE: It it necessary to have the developer tools installed (supplied

on DVD with new computer).

-------

1. perl

-------

perl is part of the standard Mac installation (or perhaps of the

developer tools --- I am not sure). 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 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 part of the standard Mac installation (or perhaps of the

developer tools --- I am not sure). 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, MacOSX is not

one of them. Compilation is non-trivial and requires hacking of the

source. If scanbb is not available, LADCP-data-file checking can be

This is not recommended, however.

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

TTY DEVICE NAMES

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

Since modern Apple computers do not have any RS-232 ports the ADCPs

must be connected via another interface, usually USB. Every

USB-to-serial adapter uses different device names, but the devices

appear in /dev only only when the adapter is connected, i.e. you can

find the device names by  comparing the contents of /dev with and

without the adapter connected.

In case of the KeySpan adapters that we are using at Lamont, each

serial line has two associated /dev entries: /dev/tty.* and /dev/cu.*

--- ONLY /dev/cu.* WORKS!!! With the current driver version, the first

device is called /dev/cu.KeySerial1, but the second one has a

"geographical" (containing bus number, &c) name, such as

/dev/cu.USA49W3b13P2.2. The name depends on where it is plugged in,