Host(n)

NAME

Host - Create simulated Host object within a SIRS (Stand-alone Interfacility and Radar Simulator) scenario.

SYNOPSIS

Host name [-dev interfacility_device] [-srv radar_input] [-artsid artsid] [-fp flight-plan file] [-wx wx_input] [-adaptation filename] [-map mapList] [-rec record_file] [-rxclock rate] [-txclock rate] [-msgs msgs] [-delay ms] [-if_timeout secs] [-if_retries num] [-new_NAS_if [0/1]] [-ho_range range] [-ho_file file] [-utc [0/1]] [-dynamic_ecids [0/1]] [-cenrap lrrfile] [-cenrap_quiet [0/1]]

DESCRIPTION

Host creates a Host object which will functionally act as a HOST system during a SIRS scenario. The Host object assumes that the system it is communicating with is a Ter- minal ATC system. The Host requires a radar input, which can be either live data through a /dev/rdrrx device, or from a pre-recorded file. The Host optionally uses a flight-plan file, which is used to generate and send FP, AM, and CX messages over the interfacility link. Each FP message is dynamically assigned and ECID and transmitted over the line. Each CX and AM msg in the flight-plan file has a bcn code to allow the Host to associate a pre- assigned ECID to them. The Host object also generates the following Interfacility data messages dynamically during the scenario: TI, TU, TA, and TR. These messages are sent based on radar input and received interfacility messages.

CREATION ACTION

On creation, a "tabbed notebook" type window is created in the 2nd column of the virtual X-display. The interfacil- ity device is initialized (starts idling), and the radar file position is set based on the global variable SimTime (unless a radar device is specified). The fp file posi- tion is set based on SimTime. The map files are read into an internal table and the first map specified is displayed in the rappi window.

START ACTION

Host processing will be scheduled to run 4 times per sec- ond (default). Internal processing performed can be gen- erally described as: 1. interfacility input processing 2. interfacility timer/retransmission processing 3. VFR processing 4. Flight Plan output processing 5. Radar track update / TI generation 6. TU generation 7. Cenrap processing

In addition, the Host object will respond to severalasynchronous events, such as relaying ARTS-ARTS messages, and responding to user control msgs.

Options

-dev Specifies the interfacility device to use. Inter- facility devices are named /dev/if0 thru /dev/ifx, where x = 8*number of if cards in system. (each device uses 1 channel, or 8 devices per card). Default is /dev/null.

-srv Specifies the filename or device from which surveillance msgs will be received. Either a file- name or a radar receiving device ( /dev/rdrrx0 thru /dev/rdrrx) may be specified. Default is /dev/null.

-fp Specifies the flight plan file to download over the if line. The flight plan file is a plain ASCII file containing a list of time-stamped FP, CX, and AM messages. The time stamps are embedded within the msg header, for example: ZCD1455105 would be sent at simtime 14:55:10.5. The last 3 digits of the header field will are dynamically overlayed with an assigned ECID before going out over the line. All occurrences of the characters :: in this file are replaced with an LRC PREPARE character (0xb3) and an LRC checksum befor going out over the line. All occurences of the character * are replaced with an EOM character (0xb1) before going out over the line. Default is none.

-wx Specifies the filename from which wx msgs will be received. If the -srv option specified a device, this option will be ignored, and srv device will be used as the wx source. The arts object will adjust the wx msg timestamps to agree with the srv file beiong used. This allows the use of a separately recorded wx file, with arbitrary start time. Default is none.

-adaptation Specifies an adaptation file to be used. The adap- tation file is a plain ASCII file which specifies fixes are to be used for ARTS-ARTS processing. Each line in the adaptation file is of the format FIX OWNER1 OWNER2. FIX is a 3-character ATC fix found in FP messages. OWNER1 and OWNER2 are 3 character IDs specifying the owner of this fix. Usually, OWNER1 and OWNER2 are specified to be two ARTS ID's, specifying any FlightPlans with FIX to be handled as an ARTS-ARTS transfer.

-artsid 3-character id of the system on the remote end ofthe interfacility link. This is used for sending TR's.

-map A list of map files, enclosed in double quotes if there is more than one. This is used for rappi display purposes only. The maps must be in NOAA form, with each line segment specified by a pair of Lat/Lon points. The Lat/Lon center of the map and desired rotation may also be specified - see an existing map file for examples.

-rec A recording file where all IF msgs and status msgs will be stored in ASCII format. If this option is not specified, a default record filename of name.rec will be used.

-txclock Specifies the speed of the transmit clock to be used for the interfacility device. A value of 0 configures the card to accept transmit clock from the modem (this option only works with 8Si-232 cards, and Emulex PCI cards which have been jumpered for that mode. Default value is 2400.

-rxclock Specifies the speed of the receive clock to be used for the interfacility device. A value of 0 config- ures the card to accept receive clock from the modem. A non-0 value will cause the receive clock to be generated using an internal crystal. Default value is 0.

-delay The delay in ms between each Host processing loop. The default is 250 ms, meaning the Host processing will run 4 times per second.

-msgs Number of flight plans to download per processing loop. Default is 5, combined with a default rate of 4 HZ, limits outgoing FPS to 20 per second.

-new_NAS_if Use the new NAS IF protocol.

-cenrap Specifies a long-range radar file to be used for cenrap processing, and enables cenrap output.

-cenrap_quiet Turns off logging of cenrap msgs. Cenrap process- ing will continue.

-ho_range Set the default handoff range for arrivals. Default is 53 nmi.

-ho_file Specify a file describing handoff ranges by azimuth wedge, for arrivals. The format of the file is ASCII lines consisting of three space separated columns: start ACP, end ACP, ho range.

-if_timeout Set the timeout parameter (in seconds) for message retransmission. Default is 5 seconds.

-if_retries Set the retries parameter for message retransmis- sion, before the message is removed from the retransmit queue. Default is 8.

-utc Use universal time for IF msg times. The coordina- tion time field specified in the flight plan file is interpreted as an offset from the start time. This option alleviates the need to set the system time on the Terminal ATC system under test.

-dynamic_ecids Setting to 0 forces the ECIDS specified in the flight plan file to be used, instead of the Host dynamically creating them. Use this option with care!

-max_tus Set maximum number of TUs allowed per TU msg. Default is 6.

-enhanced_timestamps IF msgs will be logged to a precision of .01 sec- onds, and the time of transmission is returned from the card, instead of the time of download to the card.

FILES

/dev/ifx The interfacility device

/dev/rdrrx The radar input device

SEE ALSO

SIRS(n), Arts(n), RadarSim(n), RadarRec(n)