ASTi Logo

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 tasks. This application note discusses using the DIS gateway to set up a variety of networking configurations. For more information about setting radio parameters, go to 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 the canvas. Select Edit File to edit the DIS Gateway file. See the examples below.

Caution: Do not select Wizard. Modifying anything in the DIS Gateway window and selecting OK overwrites everything in the manually edited text file.

The [interfaces] section sets the DIS networking configuration, including port, interface, and IP scheme. The [interfaces] section also allows for flexible control of DIS networking for each DIS exercise ID. Below is a typical example that sets the DIS version, Ethernet interface, 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 has its own multicast 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

You can also use separate ports for transmit and receive. If none are specified, the default is 53000:

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

Enhance the [interfaces] section to apply different rules for each DIS exercise. The example below applies special rules for a range of exercise IDs from 23–35 that use different interfaces, ports, and multicast addresses.

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

To give each exercise its own set of DIS network configurations, use multiple [interfaces:##] sections. To create multicast groups, add the exercise ID to the last octet. The following shows 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 show how to configure the DIS gateway. The first file is a "quick glance" DIS gateway that 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