Configure the Open DIS module
Settings are edited in HEAT Capture’s module settings UI, under HEAT.DISModule.
Changing UdpPort away from its default (3000) moves the listener outside the firewall scope
HEAT Capture grants this module. Update the workstation’s firewall rule to match before relying
on a non-default port.
Network
| Setting | Type | Default | What it controls |
|---|---|---|---|
UdpPort | integer | 3000 | UDP port the native receiver binds. See the warning above before changing this. |
NetworkMode | Broadcast | Multicast | Broadcast | Whether the receiver joins a multicast group or binds the port for broadcast traffic. |
NetworkGroupAddress | string | 239.255.0.1 | Multicast group to join. Only used when NetworkMode is Multicast. |
LocalCaptureOnly | boolean | false | When enabled, PDUs from any sender that is not one of the workstation’s own local IP addresses are dropped before processing. |
Changing any of UdpPort, NetworkMode or NetworkGroupAddress while the module is running
tears down and rebuilds the native socket in place - including reconnecting the receive loop if a
session is active - without restarting the module itself.
Session trigger
Because this module runs continuously rather than being started and stopped with a capture session (see Overview), it needs its own rule for deciding when a session should start and stop from the DIS traffic it sees.
| Setting | Type | Default | What it controls |
|---|---|---|---|
StartOnAnyPDU | boolean | false | true: any valid PDU starts a session if one is not already running. false: only a PDU whose type is in StartPduTypes does, and only when StartOnSpecificPDU is also enabled. |
StartOnSpecificPDU | boolean | true | Enables the StartPduTypes trigger. Only meaningful when StartOnAnyPDU is false. |
StartPduTypes | set of PDU types | {StartResume} | Which PDU types start a session, when StartOnSpecificPDU is enabled. |
StopOnSpecificPDU | boolean | false | Enables the StopPduTypes trigger. Only meaningful when StartOnAnyPDU is false. |
StopPduTypes | set of PDU types | {StopFreeze} | Which PDU types stop a running session, when StopOnSpecificPDU is enabled. |
StopOnSilence | boolean | false | Only available when StartOnAnyPDU is true. Stops a running session after SilenceThreshold with no PDUs received at all. |
SilenceThreshold | duration | 10s | How long the network can go quiet before StopOnSilence ends the session. |
StartOnAnyPDU and the specific-PDU-type settings are mutually exclusive modes, not layered:
enabling StartOnAnyPDU disables the StartPduTypes/StopPduTypes triggers entirely, and
StopOnSilence only exists in the StartOnAnyPDU mode.
Host settings
This module also exposes the generic settings every HEAT Capture module has - Enabled,
Interval, OverrideNodeId/NodeId, Timeout - with one specific behavior worth calling out:
Enabled disables PDU processing entirely; received packets are still counted but dropped. See
Manage capture modules for what each of these
does generically.