antenna - Antenna tracking diagnostic command

SYNOPSIS

antenna unit pass_number satellite telemetry start_date start_time duration now align

All parameters for this command must be entered at the command line.

DESCRIPTION

antenna is a higher-level diagnostic command that tests the following components of the antenna subsystem: orbital elements still valid, earth-location calculations, site location, antenna configuration files, antenna controller, antenna controller communications, antenna motors, and antenna position pots. The commands are sent to the antenna in a real time sequence. The sequence can be run when the specified starting date and time is reached or it can be run as soon as the command is invoked by pressing the Return key, thus running the antenna diagnostic on a "phantom" pass. To monitor the progress of the antenna, use the trackeye command to call up the trackeye window. The antenna command does not store any data on the pass disk (see rdframe). Normally, you would check the list of scheduled passes in TeraCapCon or XCapCon to determine the date and time of a pass to begin tracking one of the satellites. To retrack a pass recently received, first use lspass to display the starting date, time, and duration.

PARAMETERS

unit

Specifies the telemetry chain whose antenna is being controlled. Telemetry chains are numbered 1,2,3.

pass_number

Specifies the number of the pass to be associated with this tracking sequence. Passes are numbered 1,2,3.... A response of -1 will exclude all pass- related actions.

satellite

Specifies the name of the satellite to be tracked.

telemetry

Specifies the name of the telemetry format to be received by the telemetry chain.

start_date

Specifies the date to begin tracking the satellite.  The format is yy/mm/dd.

start_time

Specifies the time to begin tracking.  The format is hh:mm:ss.

duration

Specifies the duration of the time to track.  The format is mm:ss.

now

OPTIONAL.  If now is included on the command line, tracking will begin NOW.  If now is not included on the command line, tracking will begin at the specified start date and time.  This parameter should be used for diagnostic purposes only.

align

OPTIONAL. If align is included on the command line, the autoalignment of the antenna will be performed while the antenna is being tracked.   See autoalign.

EXAMPLES

Track the antenna associated with chain 2, data written to pass 4, for satellite noaa-11, telemetry is hrpt, beginning 92/1/31, at 11:22:30 and lasting for 8:30.   Begin tracking now.

[1]% antenna 2 4 noaa-11 hrpt 92/1/31 11:22:30 8:30 now

FILES

system.config, antenna.calib, antenna.config, $PASSDIR/ant_lock_dev_term_X, magnetic_model

SEE ALSO

ac, lspass, trackeye, dataacquisition, autoalign, align, whereami, sunclock, nmea_monitor

NOTES

1. This command will not run if another copy of the antenna program is already running using the same antenna. To terminate the first antenna program, use trackeye abort, trackeye noabort and then run the antenna command. All other functions that access the antenna will be blocked while the antenna command is running.  If a user-scheduled copy of the antenna program is running, it will interfere with the normal requests issued by the antenna tracking program that is automatically scheduled by tsched.

2. The antenna program will update the shipheading value in $PASSDIR/last_location at the end of the pass, if the shipheading is valid.


Last Update: $Date: 2000/12/07 19:51:10 $