Telestra App Note

Using the DIS Gateway to Configure Multiple Interfaces in Telestra (#101)

Telestra uses the DIS gateway file to configure many of the DIS parameters for radios, as well as other networking configuration. This application note discusses using the DIS gateway to set up a variety of networking configurations. For more information about setting radio parameters see Application Note 93: Using the Waveform Mapping File to Set DIS Transmitter PDU Enumerations in Telestra.

In ACE Studio, select the Project and Layout. To add a DIS Gateway file select the "servers" folder in the ACE Studio Project Manager and select the DIS Gateway or add a new DIS gateway by right-clicking on the canvas. Click the "Edit File" button to edit the DIS Gateway file. See the examples below.

Warning!! Do Not click the "Wizard" button. Modifying anything in the DIS Gateway window and selecting "OK" will overwrite everything in the manually edited text file.

The [interfaces] section sets the DIS networking configuration includingport, interface, and IP scheme. The [interfaces] section also allows forflexible control of DIS networking on a per DIS exercise ID basis.Below is a typical example, which sets the DIS version, ethernetinterface, UDP Port, and broadcast address for all DIS traffic.

[interfaces]
main_bcast = 10.2.255.255
port = 53124
if = eth0

Here is an enhanced example, where each PDU type is put their ownmulticast address:

[interfaces]
signal_mcast = 224.11.11.11
receiver_mcast = 224.12.13.14
main_mcast = 224.10.10.10
entity_mcast = 224.10.10.220
port = 53124
if = eth0

Separate ports may also be used for transmit and receive. If noneare specified the default is 53000:

[interfaces]
main_bcast = 10.2.255.255
port = 53124
tx_port = 53001
if = eth0

The [interfaces] section may be enhanced to apply different ruleson a per DIS exercise basis. The example below applies specialrules for a range of exercise IDs from 23 to 35, using a differentinterface, port, and multicast address.

[interfaces:23]
end_exercise_range = 35
main_mcast = 224.1.1.31
port = 3334
if = eth2

Each exercise can have its own set of DIS network configsby using multiple [interfaces:##] sections. Multicast groupscan also be created based on adding the exercise ID to the lastoctet. A simple mcast by exercise example:

# Will use 224.1.1.1 thru .30
[interfaces:1]
end_exercise_range = 30
main_xmcast = 224.1.1.0
port = 3334
if = eth0

# Will use 224.1.1.31 thru .255
[interfaces:31]
end_exercise_range = 255
main_xmcast = 224.1.1.0
port = 3334
if = eth2

Below are two files that can be used as a quick reference on how to configure the DIS gateway.The first file is a "quick glance" DIS gateway, which includes nearly all of the relevant commands in a single, valid DIS gateway file. The second file is an exhaustive, fully commented file with descriptions of what each field does.

Examples Filename size
"Quick Glance" DIS Gateway file asti_quick_disgateway.txt 4k
Full DIS Gateway file asti_full_disgateway.txt 8k