ASTi Telestra User Guide (Ver. 3, Rev. G.1)
Copyright © 1999-2006 Advanced Simulation Technology inc. 145
Appendix C: HF Server ICD
This appendix provides the specification for the software interface between the HF Server and the
simulation host computer. The HF Server is provided with certain configuration data, on a per-
exercise basis, via an ethernet packet. The host software provides the input data to the HF Server
in the format specified in this ICD.
Data is provided to the HF Server via an ethernet connection between the host computer and the
HF Server. This connection need not be dedicated, but may be part of the Local Area Network
infrastructure. Packets are standard IEEE 802.3 format using a UDP-level protocol. The HF
Server is set up to receive host configuration packets on UDP Port # 33000 by default.
Typically, this interface would be used in the beginning of an exercise to initialize the HF Server
parameters. Once the parameters for a particular exercise have been set, they will remain constant
until the host sends another packet to overwrite them. Note that the HF Server stores exercise-spe-
cific data. Multiple, independent exercises can run simultaneously using the same HF Server.
Input Control Data Types
In_Bool
Boolean parameter. Data word is a single bit wide only - no other bits are checked within a word.
Specific bit location is specified in the Bit field in Table 18.
In_Uint
Unsigned Integer parameter. Data word can be of variable length, as specified by the Start and
End fields in Table 18. All data is in network-byte order.
In_Float
Floating point input. Data word is in IEEE floating point format and is 4 bytes wide.
Table 19: HF Server ICD
* OFFSET is the time difference, in hours, between the clock on the HF Server (system time in
GMT) and simulation time, expressed in GMT. This can be a negative number.
Note: HF ICD Messages must be exactly 21 bytes long.
Variable Type Description Port # Start End Bit Default
Set_SSN_flag In_Boot True to set current value of
Smoothed Sunspot Number
33000 11 11 0
Set_OFFS_flag In_Boot True to set current value of OFF-
SET*
33000 11 11 1
Exercise ID In_Uint Exercise ID to set parameters (1
to 255)
33000 15 15
SSN In_Uint Current value of Smoothed Sun-
spot Number (0-250 typically)
33000 16 17 100
OFFSET In_Float Current value of OFFSET* (in
hours)
33000 18 21 0.0
Comments to this Manuals