SeaSpace TeraScan 1.5M, Operation And Maintenance Manual

Page: 210 / 232

194
SeaSpace Corporation
10.3.11 whereami
Determines the current antenna site location.
Format:
whereami
whereami list
whereami once
whereami once list
whereami delay &
Description:
whereami is used to determine the current location of the antenna. This command calls site-specific
code to read the location information from an outside source. The command reads the data (if it is
available) and stores it in the file $PASSDIR/last_location. Other commands such as antenna or teracon
in TeraScan then read the current site location from last_location.
This command has several forms.
The first form (whereami) runs forever and displays a reading only when a change in location occurs.
The second form (whereami list) runs forever and displays the current reading whether or not a change
in location has occurred. whereami once runs once, without retries, as a diagnostic, and will report the
equipment status. whereami once list runs once and reports the location. wherami
delay & runs once
and delays for the period specified by delay before running again. This form does not display the
current location. It updates the file last_location only. This form is used by the system in $PASSDIR/
tscan.rc.local.
Not all systems have site-specific code. If the system has a GPS, the site location is determined by
standard code.
If [ system ] gps.index=nmea , the site location is read from NMEA shared memory specified by
[ system ] gps.data.source (=1 or 2)
This command can verify the location entered by the command newsite if the system does not have any
external equipment that defines the site location.
Examples:
Example 1:
Read the current location forever, waiting for a change. Heading is shown if it is valid.
[1]% whereami
Location:32 53.51 N 117 9.23 W Altitude:61.7 m
Magnetic declination:13.287 degrees Dip:58.192 degrees
^C
{press C to break}