adt/wdl/tr-3-o1o65 * i ad-a282 iieiiiiiuimii

. .. .. . . ... , . . . .... . .,-,

I ADt/WDL/TR-3-O1O65

* AD-A282 750I IIEIIIIIUImII

ADSTI Interface Requirements Specification

for theProtocol TranslatorofAdvanced Distributed Simulation Technology/Crew Station Research and Development Facility

ILoral Western Development LabsElectronic Defense Systems Software Department T CSoftware Engineering Laboratory3200 Zanker Road ."E L E cT,.-P.O. Box 49041 4Q, .San Jose, CA 95161-9041IBMay 1, 1993IContract No. N61339-91-D-000lCDRL No. Not Applicable \W 94-24949

Prepared for

Simulation Training and Instrumentation CommandNaval Training Systems Center12350 Research ParkwayOrlando, FL 32826-3275

9800 t - .

U ADST/WDL/TR--93--003065 May 1, 1993

I 1 Fwrn aa~mvd

REPORT DOCUMENTATION PAGE o ko2,ISIPid.creoiin bude f thi, coleton of nl ion etaat,,,d to averag I ho. r rns, idcn th time fo revsiei msaglonsaeot mnin dde w,

is ami.hinloniaion, ,inc g suggeom kw reducing INs burdin, to Washington Hmquartus SuMss. Dirsdasor infOrmiOn OPSr& =, s5

Jefleon Da. ighwa, Suie 1204, Arlngton, VA 222M-4302. and to the Offe of tanagement and Budge POd (07044M 60), Washington, DC 205M.1. AGENCY USE ONLY (Leave blank) REPORT ATE 3. REPORT TYPE AND DATES COVERED

4. TITLE AND SUBTITLE S. FUNDING NUMBERSADST Interface Requirements Specification for the Protocol Translator of Contract No. N61339-91-D-0001Advanced Distributed Simulation Technology/Crew Station Researchand Development Facility

C AUTWOIS)Au-Yeung, Annna; Kuczaj, Chuck; Bright. Rick; Thompson, Lynn, Mitchell. Gerry;Kzuck, Mary

7. PERFORMING ORGANIZATION NAME(S) AND ADORESS(ES) S. PERFORMING ORGANIZATION

Loral Systems Company REPORT NUMBERADST Program Office ADST/WDL/TR-93-00306512443 Research Parkway. Suite 303Orlando, FL 32826

9. SPONSORINGMONITORING AGENCY NAME(S) AND ADDRESS(ES) 10. SPONSORING

Simulation, Training and Instrumentation Command ORGANIZATION REPORT

STRICOMNaval Training Systems Center12350 Research ParkwayOrlando, FL 32826-327511. SUPPLEMENTARY NOTES

12a. DISTRIBUTIOWAVAILABILITY STATEMENT 12b. DISTRIBUTION CODEApproved for public release; distribution is unlimited.

I 13. ABSTRACT (Maximum 200 words)

This document describes the following interfaces: DIS Network to Protocol Translator,SIMNET Network to Protocol Translator, Protocol Translator to DIS Shared Memory,Protocol Translator to SIM Shared Memory, Protocol Translator User Interface to DISShared Memory, Protocol Translator User Interface to SIM Shared Memory.

14. SUBJECT TERMS iS. NUMBER OF PAGES

1516. PRICE CODE

17. SECURITY CLASSIFICATION 17. SECURITY CLASSIFICATION 17. SECURITY CLASSIFICATION 20. LIMITATION OF ABSTRACTOF REPORT OF THIS PAGE OF ABSTRACT ULUNCLASSIFIED UNCLASSIFIED UNCLASSIFIED

NSN 754001-280-5500 Standard Fort 298 (Rev. 2-89)msatedby ANSI 5) Z35-182I-02I

I -i-

I ADST/WDL/TR-93--003065 May 1, 1993

ITable of ContentsI 1 Scope ........................................................................... 1

1.1 Identification ...................................................................................... 11.2 System Overview .............................................................................. 1

1.3 Docum ent Overview ........................................................................ 1

2 Applicable Documents ............................... 22.1 Government Documents ................................................................. 22.2 Non-Government Documents ....................................................... 2

U 3 Interface Specification ...................................................................... 43.1 DIS Network to Protocol Translator Interface ............................ 43.1.1 Interface Requirements..............................43.1.2 Data Requirem ents .......................................................................... 53.2 SIMNET Network to Protocol Translator Interface .................. 53.2.1 Interface Requirem ents ................................................................... 53.2.2 Data Requirem ents ........................................................................... 63.3 DIS and SIM Shared Memory to Protocol Translator Interface ..... 63.3.1 Interface Requirements ................................................................... 63.3.2 Data Requirem ents .......................................................................... 63.4 Protocol Translator User Interface to DIS and SIM Shared

M em ory Interfaces ........................................................................... 93.4.1 Interface Requirements ................................................................... 93.4.2 Data Requirem ents ........................................................................... 9

4 Quality Assurance .......................................................................... 10

I 5 Preparation for Delivery ................................................................ 11

6 N otes ................................................................................................... 12

Acoession For

DTIT; 0

I)

-ii- :i

I -

i ADST/WDL/TR--93--003065 May 1, 1993

List of Figures

I Figure 3.1 Protocol Translator External Interfaces ................................ 4

IList of Tables

I Table 3.1.2.1 DIS Network Interface Data Element Definition Table ......... 5Table 3.2.2.1 SIMNET Network Interface Data Element Definition Table .. .6Table 3.3.2.1 Protocol Translator to DIS Shared Memory Interface Data

Element Definition Table ......................................................... 7Table 3.3.2.2 Protocol Translator to SIM Shared Memory Interface Data

Element Definition Table ......................................................... 8

IIIIIIIIIiI

i - IUi -

U

_ ADST/WDL/TR-93-003065 May 1, 1993

U 1 Scope

1.1 Identification

The approved identification number for ADST/CSRDF Protocol TranslatorInterface Requirements Specification is ADST/WDL/TR--93--003065. Thisdocument describes the following interfaces:

DIS Network to Protocol TranslatorSIMNET Network to Protocol TranslatorProtocol Translator to DIS Shared MemoryProtocol Translator to SIM Shared MemoryProtocol Translator User Interface to DIS Shared Memory

IProtocol Translator User Interface to SIM Shared MemoryProtocol Translator User Interface to SIM Shared Memory

1.2 System Overview

The Protocol Translator (PT) translates Protocol Data Units (PDUs) from oneprotocol format to another. The Protocol Translator is compatible withDistributed Interactive Simulation (DIS) protocol version 1.0 and SimulationNetworking (SIMNET) protocol version 6.6.1. The Protocol Translatorreceives DIS Protocol Data Units (PDUs) from the DIS network, translatesthem to SIMNET format, and sends the translated PDUs to the SIMNETnetwork. A similar process applies to the SIMNET to DIS translation.

The Protocol Translator logs translation statistics to shared memory for accessby the DIS-to-SIM and SIM-to-DIS processes. This information is then used bythe "Protocol Translator User Interface", a Protocol Translator utility whichshows Protocol Translator statistics, such as the rate of PDUs translated, persecond. The translation statistics are also written to a statistical file forarchival purposes, and post-exercise review.

I 1.3 Document Overview

This document describes the interface requirements for the ProtocolTranslator (PT) and Protocol Translator User Interface (PTUI). This documentconsists of the following sections: applicable documents, interfacespecification, quality assurance, preparation for delivery, and notes.

II

-1-I

I ADST/WDL/TR-93--003065 May 1, 1993

2 Applicable Documents

2.1 Government Documents

The following documents of the exact issue shown form a part of thisspecification to the extent specified herein. In the event of conflict betweenthe documents referenced herein and the contents of the specification, the

I contents of this specification shall be considered a superseding requirement.

SPECIFICATIONS:

Other Government Agency

[1.1] Interface Control Document (ICD) for the BDS-D NetworkInterface 14 February, 1992 (Last updated: 21-Feb-92 17:58)

I STANDARDS:

3 Military

(2.1] N61339-91-C-0091, Protocol Data Units for Entity Informationand Entity Interaction in a Distributed Interactive SimulationDIS standard 1.0 with Extension, May 8, 1992.

[22] BBN Report No. 7627, The SIMNET Network and Protocols,version 6.6.1, June 1991.

Copies of specifications, standards, drawings, and publications required bysuppliers in connection with specified procurement functions should beobtained from the contracting agency or as directed by the contracting office.

2.2 Non-Government Documents

The following documents of the exact issue shown form a part of thisspecification to the extent specified herein. In the event of conflict betweenthe documents referenced herein and the contents of this specification, thecontents of this specification shall be considered a superseding requirement.

III

i -2-

I ADST/WDL/TR-93--003065 May 1, 1993

SPECIFICATIONS:

[5.1] Software Requirements Specification for the Protocol Translatorof Advanced Distributed Simulation Technology (ADST)/CrewStation Research and Development Facility (CSRDF) Rev. Basic:June 16, 1992, Contract No.N61339-91-D-0001. Prepared by LoralWestern Development Labs.

OTHER PUBLICATIONS:

Manual

[6.1] ADST/SW/TR--93--003064, ADST Software MaintenanceManual for the CSRDF Protocol Translator February 26,1993.Contract No.N61339-91-D-0001. Prepared by Loral WesternDevelopment Labs.

[6.2] SUN Microsystems: part #800-3850-10, Network ProgrammingGuide, Revision A of @7 March, 1990.

I

I3

I ADST/WDL/TR-93-003065 May 1, 1993

I3 Interface SpecificationI

SIMNET Ethernet Network

IIEthernet Network Interface

II SharedyM

Protocol Translator Protocol Translator

UDP/IP Network Protocol 't

DIS Ethernet Network

- Figure 3.1. Protocol Translator External Interfaces

The Protocol Translator External Interfaces are outside the bounding box ofFigure 3.1. The DIS and SIM Shared Memories also interface to a ProtocolTranslator utility software, "Protocol Translator User Interface", where on-line or off-line translation statistics will be displayed.

I 3.1 DIS Network to Protocol Translator Interface

The DIS interface supports PDU communication between the ProtocolTranslator's DIS to SIM translation process and the DIS Ethernet Network.

3.1.1 Interface Requirements

Refer to SRS section 3.1. for CSCI external interface requirements.

XLAT001 Application Interface Service - refer to SRS section 3.1.1-1

XLAT002 Network Protocol Services - refer to SRS section 3.1.1-2 forrequirement description. Refer to [6.1] section 4.1.1 NetworkInterface Software and section 4.3 Runtime EnvironmentDescription for examples and details.

I-4-

I ADST/WDL/TR-93-003065 May 1, 1993

IXLAT007 DIS Protocols - refer to SRS section 3.1.2-5 for requirement

description. Refer to [6.2] section 10.7 "Datagrams in the InternetDomain" for examples.

I3.1.2 Data Requirements

The UDP/IP hides the topology and characteristics of the underlying networkfrom its user. Refer to [2.1] and [5.1] for DIS PDU contents. The followingtable lists data elements that are communicated between the DIS Network

1and the Protocol Translator and are accessible by the user:

Table 3.1.2.1. DIS Network Interface Data Element Definition Table

IIDENTI K DESCRION SOURCEPDIU001 source address DIS Network Protocol TranslatorPTD002 port numberI"PTDff003 Interet FamiluPTDI004 inaut 1315 POOPTDI011 d estinaton address Protocol Translator 015 NetworkPTDIOI2 FortnumberPTDI013 Internet Famil "PTDI014 output DIS PDU

3.2 SIMNET Network to Protocol Translator Interface

The SIMNET interface supports PDU communication between the ProtocolTranslator's SIM'to DIS translation process and the SIMNET EthernetNetwork. Refer to [6.1] section 4.1.1 Network Interface Software.


Refer to SRS section 3.1. for CSCI external interface requirements.

XLAT002 Network Protocol Services - refer to SRS section 3.1.1-2 forrequirement description. Refer to [6.1] section 4.1.1 Network

Interface Software and section 4.3 Runtime EnvironmentIDescription for examples and details.

XLAT008 SIMNET Protocols - refer to SRS section 3.1.2-6.

IIIi -5-

ADST/WDL/TR-93--003065 May 1, 1993

3.2.2 Data Requirements

The following table lists data elements that are communicated between theSIMNET Network and the Protocol Translator (refer to (2.2] and [5.11 forSIMNET APDU and SIMNET PDU contents):

Table 3.2.2.1. SIMNET Network Interface Data Element Definition Table

DENTIFR I DESCRIPTION SOURCE D.STIN

PTDI21I source address SIMNET Network Protocol TranslatorPTD1022 destination addressPTD1023 input packet lengthPTD1024 D&AP

PTDI025 SSAPPTDI026 control fieldPTDf027 Protocol 1PTDI028 Ether TypePTDI029 _IMET APDUPTD1030 SIMNET PDUPTD1031 source address Protocol Translator SIMNET NetworkPTD1032 destination addressPTD1033 oupu pc0-te-gTPTD034 _ _PTDI035 SSAPPTDI036 control fieldPTD1037 Protocol 1DPTDI038 EtherTypePTDI039 SIMNET ADUPTDI040 SIMNET PDU

3.3 DIS and SIM Shared Memory to Protocol Translator Interface

The Protocol Translator interfaces to DIS and SIM shared memories to recordtranslation statistics. The DIS Shared Memory contains DIS to SIMtranslation statistics while the SIM Shared Memory contains SIM to DIStranslation statistics. These statistics are written to a file and are rtad by theProtocol Translator User Interface utility.


PTIF021 The DIS and SIM shared memories to Protocol TranslatorInterface shall utilize SUN Microsystems' library functions toattach and detach a shared memory.


The following table lists data elements that are written by the ProtocolTranslator to DIS Shared Memory:

-6-

ADST/WDL/TR-93--003065 May 1, 1993

Table 3.3.2.1. Protocol Translator to DIS Shared Memory Interface DataElement Definition Table

____________ DESCFRWTION SOUKCEDETNIO S(

PTD1061 start time Protocol Translator's rdMmyDIS to SIM translation

PTD1062 erd time pro__ _ __ _ _ __ _ __ _ __ _ _

PTDIO64 #_________ ___________ ________received

P ffg # of PDUs tran-slate ___________ _________

PTD1066 ro transaO Ds not

PTD1067 # of PDUs not translated __________________

PTDIO85 - # of PDn it ba ds

PTD1069 # of Ent it ad

PTD1070cotoflea numberi

Th Tflowing tal last ateltemet htaewite ytePooo

Tranlatr toSIMShae Memtory

Tble4 #.32.2 Protoco trasla btor t I hrdMmoyItraeDt

EsoiailenthDfnto alPTD107 # f PDs wih bA

assciaionpro -7- i

ADST/WDL/TR--93--003065 May 1, 1993

PTDI061 start time Protocol Translator's SIM Shared MemorySIM to DIS translation

PTD1062 erkd time _ process

PTDI063 elapse time

PDI1064 # of PDUs received

PTDI065 # of PDUs translated

PTDI066 # of translated PL)Us notsent

PTDI067 # of PDUs not translated

PTD1068 .. of vehicle appearancePDUs

PTDI069 # of unknown PDUs

PTD1070 # of PDUs trashed uponreceipt

PTDI071 # of PDUs trashed beforetransmit

PTDI072 # of PDUs with badassociation kind

PTDI073 # of PDUs with badassociation lenathPTD1074 # of PDUs with bad

association protocol-id

P1D1075 # of PDUs with badExercise ID

PTD1076 # of PDUs with excess,_ _radar targets

PTDI077 # of PDUs withunknown fire ty/pes

PTDI078 # of PDUs withuiknown vehicle

statisticsPTD1079 # of PDUs with bad

Ethernet tye

PTDI080 # of PDUs with badprotocol-id

PTDI081 # of PDUs with badDSAP

PTD1082 # of PDUs with badSSAP

PTD~i083 # of PDUs with badcontrol number I

PTD1084 last 100 statistics I

3.4 Protocol Translator User Interface to DIS and SIM Shared MemoryInterfaces

The Protocol Translator User Interface is utility software for displaying PTon-line or off-line translation statistics. The PTUI reads DIS and SIM SharedMemories to retrieve translation statistics. The Protocol Translator UserInterface. reads the DIS to SIM translation statistics from the DIS sharedmemory and reads the SIM to DIS translation statistics from the SIM sharedmemory.


-8-

m ADST/WDL/TR-93-003065 May 1, 1993

m PTIF031 The Protocol Translator User Interface to DIS and SIM sharedmemories shall utilize SUN Microsystems' library functions toattach and detach a shared memory.


Refer to table 3.3.2.1 for data elements communicated between the ProtocolTranslator User Interface and the DIS Shared Memory.

Refer to table 3.3.2.2 for data elements communicated between the ProtocolTranslator User Interface and the SIM Shared Memory.

Refer to Appendix C of referepce [5.11 for DIS and SIMNET external inter-ices '

data requirements (subsets of DIS 1.0 standard PDUs and subsets of SIMNET6.6.1 standard PDUs).

IImIIIIIIIIm -9-

I ADST/WDL/TR--93--003065 May 1, 1993

I4 Quality Assurance

Not applicable.

IIIIIIIIIIIIIII

- 10-

I

I ADST/WDL/TR-93-003065 May 1,1993

U 5 Preparation for Delivery

Not applicable.

IIIUIIIIIIIIIII

-11-

I

I ADST/WDL/TR--93--003065 May 1, 1993

6 Notes

List of Acronyms:

ADST Advanced Distributed Simulation TechnologyAPDU Association Protocol Data Units (Association Layer)CSRDF Crew Station Research and Development FacilityDIS Distributed Interactive SimulationUDP User Datagram ProtocolPT Protocol TranslatorPTDI Protocol Translator Data ItemPTIF Protocol Translator InterfacePTUI Protocol Translator User InterfaceSIMNET Simulation Networking

IIIIIIIIIII

N - 12-

Im• m mi