To create a new capture filter, click in the active log window, or bring it to the front using the Window menu. Select the New Filter File item from the Filter menu.
This displays the Edit Filter dialog box as shown in figure 6.1.
Figure 6.1 The Edit Filter Dialog Box To create a new filter, follows these steps:
1
Set global packet-type options. To do this, click on the Global button from the Edit Filter dialog box. This displays the Set Global Filter Options dialog box as shown in figure 6.2.Figure 6.2 The Set Global Filter Options Dialog Box
From this dialog box, you select the types of packets to filter, whether both the source and the destination must match to pass the filter, and whether to log all packets that pass the filter, or all packets that fail to pass the filter.
The good packet types that can be filtered are:
Ackd Acknowledged message or network variable update
ACK Acknowledgment
Unackd Unacknowledged message or network variable update UnackdRpt Unacknowledged repeated message or network variable
update
Request Request message or network variable poll
Response Response message or network variable poll response Reminder Multicast message or network variable reminder Challenge Authentication challenge
Reply Authentication reply Unknown Invalid PDU type
The bad packet type filter specifies which error types to filter. The error conditions that can be filtered are:
• Bad CRC
• Timeout
• Packet too short
• Packet too long
• Preamble too short
• Preamble too long
The dialog box also includes an ALL button which selects all types and a NONE button which deselects everything.
2
Set global address type options. To do this, click on the Addr Modes button of the Set Global Filter Options dialog box. This displays the Select Address Modes dialog box as shown in figure 6.3.Figure 6.3 The Select Address Modes Dialog Box
This filter allows filtering on the following destination address modes:
• Neuron ID
• Subnet + node identifiers
• Group identifiers
• Broadcast (subnet or domain)
3
Select the node or nodes to filter messages to and/or from. To do this, click on the Add button from the Edit Filter dialog box. This displays the Select Node to Add dialog box as shown in figure 6.4.Figure 6.4 The Select Node To Add Dialog Box
The Domains list box shows all of the domains in your network. To select a domain, click on the name with the left mouse button. The Nodes list box shows all of the nodes within the selected domain. If the first entry in the Domains list box, labeled all, is selected, the Nodes list box shows all nodes in all domains.
To select a node, click on its name with the left mouse button and then click the Add button. To close the dialog box without selecting a node, click Cancel.
After you select a node, it appears in the Edit Filter node list. For example, if you select the node named Fan in the Select Node to Add dialog box, the Fan node will appear in the Edit Filter dialog box as shown in figure 6.6.
To remove a node from the list, select a node in the Edit Filter dialog box and click the Delete button.
If no nodes are added, then packets from all nodes pass the filter.
4
For each node, select specific network variables or message codes to filtermessages to and/or from. To do this, click on the appropriate cell in the node list of the Edit Filter dialog box as shown in figure 6.5.
Click here to change input options
Click here to change output options
Click here to change the list
of filtered network variables Click here to change the list of filtered message codes
Figure 6.5 Setting Specific Node Filter Options
Based upon the cell in which you click, an appropriate dialog box will appear to let you set specific options. If you click on either the input or output cell, a dialog box like the one shown in figure 6.6 appears.
Figure 6.6 The Input Mode Dialog Box
From this dialog box you can select one of three options for how message to or from this node are filtered:
Pass all packets
<TO|FROM> this node In the case of the input cell, all packets to this node pass the filter. In the case of the output cell, all packets from this node pass the filter.
Don’t pass packets
<TO|FROM> this node In the case of the input cell, no packets to this node pass the filter. In the case of the output cell, all packets from this node do not pass the filter.
Pass only packets qualified by a NV or Msg Code
In the case of the input cell, all packets to the node to the specified network variable(s) or with the specified message codes pass the filter. In the case of the output cell, all packets from this node from the specified network variable(s) or with the specified message codes pass the filter.
If you click on the network variables cell, a dialog box like the one shown in figure 6.7 appears.
Figure 6.7 The Select Network Variables Dialog Box
This dialog box contains two lists. The Input NVs list shows all of the node’s input network variables. The Output NVs list shows all of the node’s output network variables. Clicking the left mouse button on a network variable name adds or removes the network variable from the filter. When the input mode is set to Pass only packets qualified by a NV or Msg Code, only messages directed to a selected network variable pass the filter. When the output mode is set to Pass only packets qualified by a NV or Msg Code, only messages sent from a selected network variable pass the filter.
If you click on the message codes cell, a dialog box like the one shown in figure 6.8 appears.
Figure 6.8 The Select Messages Dialog Box
This dialog box contains two lists, both show all the message code names that you have defined. See Chapter 4 for information on how to define message code names. When the input mode is set to Pass only packets qualified by a NV or Msg Code, only messages with a selected message code pass the filter.
When the output options is set to Pass only packets qualified by a NV or Msg Code, only messages sent with a specified message code pass the filter.