Whereami - SeaSpace TeraScan 1.5M Operation And Maintenance Manual

10.3.11 whereami

Determines the current antenna site location.
Format:
whereami
whereami
whereami
whereami
whereami
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
194 SeaSpace Corporation
list
once
once list
delay &
{press Control+C to break}