0
|
1 |
======================================================================
|
|
2 |
R E A D M E . F R E E B S D
|
|
3 |
doc: Thu Jan 19 09:43:38 2006
|
5
|
4 |
dlm: Fri Dec 10 15:23:45 2010
|
0
|
5 |
(c) 2006 A.M. Thurnherr
|
5
|
6 |
uE-Info: 96 7 NIL 0 0 72 3 2 4 NIL ofnI
|
0
|
7 |
======================================================================
|
|
8 |
|
5
|
9 |
This file contains FreeBSD-specific notes for installing and running
|
0
|
10 |
bbabble and the LDEO LADCP operator scripts.
|
|
11 |
|
|
12 |
======================================================================
|
|
13 |
PREREQUISITE SOFTWARE
|
|
14 |
======================================================================
|
|
15 |
|
|
16 |
-------
|
|
17 |
1. perl
|
|
18 |
-------
|
|
19 |
|
|
20 |
perl is part of the standard FreeBSD installation. In order to test it,
|
|
21 |
run
|
|
22 |
|
|
23 |
/usr/bin/perl -e 'use threads'
|
|
24 |
|
|
25 |
If there is an error, a threaded perl has to be installed (possibly by
|
|
26 |
local compilation).
|
|
27 |
|
|
28 |
If the perl executable does not reside in /usr/bin, the 1st line of
|
|
29 |
[bbabble] has to be modified.
|
|
30 |
|
|
31 |
|
|
32 |
------
|
|
33 |
2. gcc
|
|
34 |
------
|
|
35 |
|
|
36 |
gcc, a C pre-processor, is part of the developer tools. In order to
|
|
37 |
test it, run
|
|
38 |
|
|
39 |
gcc -E /usr/include/stdio.h > /dev/null
|
|
40 |
|
|
41 |
If you don't have gcc installed you'll have to modify [bbabble]. This is
|
|
42 |
for perl/system programming experts only.
|
|
43 |
|
|
44 |
|
|
45 |
------
|
|
46 |
3. lrb
|
|
47 |
------
|
|
48 |
|
|
49 |
lrb is the receiver-component of a public-domain implementation of the
|
|
50 |
ymodem protocol called lrzsz. It can be downloaded from
|
|
51 |
http://www.ohse.de/uwe/software/lrzsz.html. However, since the version
|
|
52 |
has not changed since December 1998 (version 0.12.20) the corresponding
|
|
53 |
tar file (lrzsz-0.12.20.tar.gz) is included in this directory.
|
|
54 |
|
|
55 |
In order to test whether lrb is already installed, run
|
|
56 |
|
|
57 |
lrb --help
|
|
58 |
|
|
59 |
In order to install lrb, run the following commands:
|
|
60 |
|
|
61 |
tar xfz lrzsz-0.12.20.tar.gz
|
|
62 |
cd lrzsz-0.12.20
|
|
63 |
./configure
|
|
64 |
make
|
|
65 |
sudo make install
|
|
66 |
|
|
67 |
|
|
68 |
---------
|
|
69 |
4. expect
|
|
70 |
---------
|
|
71 |
|
|
72 |
expect is NOT part of the standard FreeBSD installation and must be
|
|
73 |
installed separately (e.g. from /usr/ports/lang/expect). In order to
|
|
74 |
test it, run
|
|
75 |
|
|
76 |
/usr/bin/expect < /dev/null
|
|
77 |
|
|
78 |
If expect does not reside in /usr/bin, you'll have to edit all the
|
|
79 |
operator scripts (grep -l /usr/bin/expect *).
|
|
80 |
|
|
81 |
|
5
|
82 |
-------------------
|
|
83 |
5. mkProfile/scanbb
|
|
84 |
-------------------
|
|
85 |
|
|
86 |
mkProfile is part of the LADCP_perl-tools collection available
|
|
87 |
from the LDEO LADCP repository.
|
0
|
88 |
|
|
89 |
scanbb is part of Eric Firing's LADCP processing software, which is
|
|
90 |
available from http://moli.soest.hawaii.edu/software/ladcp. While
|
|
91 |
binary versions are available for a variety of systems, FreeBSD is not
|
|
92 |
one of them (although the linux binary may work). Compilation is
|
5
|
93 |
non-trivial and requires hacking of the source.
|
|
94 |
|
|
95 |
If neither mkProfile nor scanbb are available, LADCP-data-file checking
|
|
96 |
can be disabled by modifying the procedure check_data in
|
|
97 |
[CRUISE_SETUP.expect]. This is not recommended, however.
|
0
|
98 |
|
|
99 |
|
|
100 |
======================================================================
|
|
101 |
TTY DEVICE NAMES
|
|
102 |
======================================================================
|
|
103 |
|
|
104 |
Each serial port on a FreeBSD system is associated with two separate
|
|
105 |
tty special files, e.g. /dev/ttyd0 and /dev/cuad0 in case of the first
|
5
|
106 |
built-in RS-232 port (com1 to those from underprivileged backgrounds).
|
0
|
107 |
ONLY THE CALLOUT VERSION (/dev/cu*) CAN BE USED. THE NON-CALLOUT VERSION
|
|
108 |
(/dev/tty*) WILL CAUSE bbabble TO BLOCK ON STARTUP WITHOUT ANY ERROR
|
|
109 |
MESSAGE!
|
|
110 |
|