Multicast Streams with Failure Protection¶

Goals¶

In this example we replicate the multicast stream example from the IEEE 802.1 CB standard.

INET version: 4.4

Source files location: inet/showcases/tsn/framereplication/multicastfailureprotection

The Model¶

In this configuration we a use a network of TSN switches. A multicast stream is sent through the network from one of the switches to all other switches.

Here is the network:

Here is the configuration:

[General]
network = MulticastFailureProtectionShowcase
sim-time-limit = 10ms
description = "Automatic multicast static stream redundancy configuration with failure protection"

# disable automatic MAC forwarding table configuration
*.macForwardingTableConfigurator.typename = ""

# enable freme replication and elimination
*.*.hasStreamRedundancy = true

# all Ethernet interfaces have 100 Mbps speed
*.*.eth[*].bitrate = 1Gbps

# application
*.a.numApps = 1
*.a.app[0].typename = "EthernetApp"
*.a.app[0].io.remoteAddress = "01:00:00:00:00:00"
*.a.app[0].source.packetLength = 1200B
*.a.app[0].source.productionInterval = 1ms

# stream redundancy
*.streamRedundancyConfigurator.typename = "StreamRedundancyConfigurator"

# TSN configurator
*.failureProtectionConfigurator.typename = "FailureProtectionConfigurator"
*.failureProtectionConfigurator.gateScheduleConfiguratorModule = ""
*.failureProtectionConfigurator.configuration = [{name: "S", application: "app[0]", source: "a", destination: "not a",
                                                  pcp: 0, packetFilter: "*", destinationAddress: "01:00:00:00:00:00",
                                                  packetLength: 1200B, packetInterval: 1ms, maxLatency: 100us,
                                                  linkFailureProtection: [{any: 1, of: "*->*"}]}]

# visualizer
*.visualizer.failureProtectionConfigurationVisualizer.displayTrees = true
*.visualizer.failureProtectionConfigurationVisualizer.lineStyle = "dashed"
*.visualizer.streamRedundancyConfigurationVisualizer.displayTrees = true
*.visualizer.streamRedundancyConfigurationVisualizer.lineColor = "black"

Results¶

Sources: omnetpp.ini, MulticastFailureProtectionShowcase.ned

Try It Yourself¶

If you already have INET and OMNeT++ installed, start the IDE by typing omnetpp, import the INET project into the IDE, then navigate to the inet/showcases/tsn/framereplication/multicastfailureprotection folder in the Project Explorer. There, you can view and edit the showcase files, run simulations, and analyze results.

Otherwise, there is an easy way to install INET and OMNeT++ using opp_env, and run the simulation interactively. Ensure that opp_env is installed on your system, then execute:

$ opp_env run inet-4.4 --init -w inet-workspace --install --chdir \
   -c 'cd inet-4.4.*/showcases/tsn/framereplication/multicastfailureprotection && inet'

This command creates an inet-workspace directory, installs the appropriate versions of INET and OMNeT++ within it, and launches the inet command in the showcase directory for interactive simulation.

Alternatively, for a more hands-on experience, you can first set up the workspace and then open an interactive shell:

$ opp_env install --init -w inet-workspace inet-4.4
$ cd inet-workspace
$ opp_env shell

Inside the shell, start the IDE by typing omnetpp, import the INET project, then start exploring.

Discussion¶

Use this page in the GitHub issue tracker for commenting on this showcase.