AIDA Filter Component

The Filter component implements filtering of events according to their source and/or destination ID.

The component can be parametrized to block events matching a filter rule and let pass the rest or to let pass only events matching a filter rule and block the rest.

Several parameters marked with an unique number ('XXX') together form a filter rule. The parameters used to specify an acceptance code or acceptance mask are split into a low and a high part since IDs are 64 bit wide. If a filter rule is activated, events with a valid Source/Destination ID meeting the condition:

(AcceptanceCode & AcceptanceMask) == (<EventID> & AcceptanceMask)
are considered as matching a filter rule.

Parameters

GeneralPolicy
Specifies the overall operating mode of this Filter component. It controls what to do with events, which don't match at least one of the filter rules.
Implicitly it also controls what to do with the events matching, as of course their treatment is inverted.
inactive   No filtering is applied, all events can pass.
pass All events can pass, except those complying with at least one of the following filter rules.
block All events are blocked, except those complying with at least one of the following filter rules.
NoIDPolicy
Specifies how events without any valid source or destination ID are treated.
no match   No special treatment for these events, the GeneralPolicy is applied.
match These events are considered as matching a filter rule.
pass Events without any valid source or destination ID can pass.
block Events without any valid source or destination ID are blocked.
Timeout
Specifies how long the component waits for the component below to finish the transmission. Units used are ms. This value became obsolete with Versions 1.1.7 and higher!
FilterModeXXX
Specifies the operating mode of filter rule XXX.
0x00000000UL   The filter rule is inactive, no events match.
0x00000001UL   Received events are checked according to the AcceptanceCode and AcceptanceMask settings of this particular filter rule.
DstAcceptanceCodeHighXXX
The higher 32 bits of the acceptance code the event destination address should be compared with.
DstAcceptanceMaskHighXXX
The higher 32 bits of the acceptance mask. The bitmask specifies which parts of the event destination address to compare with the acceptance code.
DstAcceptanceCodeLowXXX
The lower 32 bits of the acceptance code the event destination address should be compared with.
DstAcceptanceMaskLowXXX
The lower 32 bits of the acceptance mask. The bitmask specifies which parts of the event destination address to compare with the acceptance code.
SrcAcceptanceCodeHighXXX
The higher 32 bits of the acceptance code the event source address should be compared with.
SrcAcceptanceMaskHighXXX
The higher 32 bits of the acceptance mask. The bitmask specifies which parts of the event source address to compare with the acceptance code.
SrcAcceptanceCodeLowXXX
The lower 32 bits of the acceptance code the event source address should be compared with.
SrcAcceptanceMaskLowXXX
The lower 32 bits of the acceptance mask. The bitmask specifies which parts of the event source address to compare with the acceptance code.

See Also

AIDA Overview, list of AIDA components