VComm Entity Filter

ID:  2024

Object Description

The VComm Entity Filter object can be used in conjunction with VComm Radio Objects to filter incoming DIS data for that object. Normally, the DIS ID set in the static data for the radio is used for filtering incoming Transmit PDU packets, which cannot be changed without stopping and restarting V+. This object allows dynamic control over these data and overrides the static data for any radio object it attaches to.

To use the object, simply connect the output handle of a radio/intercom object to the radio handle input of this object. The data collected on the input pins is sent to the radio/intercom object and can be changed while V+ is running.

Input Pins

HNDL

This input pin determines which radio is controlled by this object. This pin should be connected to the radio handle output pin of the radio object to be controlled.

SITE

APP

ENTITY

RADIO

These four single precision floating point values create a DIS unique identifier for the filter. The DIS specification requires that each entity participating in a DIS exercise must have a unique site/host/entity identifier. The radio ID is provided to distinguish between multiple radios attached to a single entity (see IEEE 1278.1 DIS standard for details). V+ interprets each of the values as a 16 bit unsigned number, so only whole numbers between 1 and 65535 are valid.

More about DIS Entity Identifiers:

MODE

This parameter defines the filtering mode for incoming Transmit PDU packets. The following values are valid for this pin:

1 - Entity Filter. Filter out the entity specified by the SITE, APP, ENTITY, RADIO pins.

2 - Entity Filter Exclusive. Filter out everything else except the entity specified by the SITE, APP, ENTITY, RADIO pins

3 - Entity Force Reception.Force a match of the frequency for the entity specified by the SITE, APP, ENTITY, RADIO pins (force a reception regardless of incoming radio configuration).

Any other value will be ignored and treated as a non-filtering action.

Example

The figure below presents an example of how the VComm Entity Filter object is used with a VComm GENERIC Radio, V8 DIS Only object. The filter has a Site ID of 1, App ID of 2, Entity ID of 3, and Radio ID of 5. The mode used (Mode = 2) specifies that all incoming transmissions are to be ignored unless they have an Entity ID of 1, 2, 3, 5 (Site, App, Entity, Radio IDs respectively).