Graph View

Graph View

This view is a graphic representation of the network topology as interpreted by the current capture data. Each time a new node and address is detected on an incoming packet, such node is included into the representation. The Graph View is composed of a canvas and a toolbar (see the figure below). The canvas contains a network graph showing the current network nodes. The toolbar offers access to options such as adding a background, customizing the network graph layout, selecting what data is shown, and controlling the zoom. This chapter details each of those options.

The Graph View

Changing The Background

To change the background of the canvas, click on the Background Image toolbar button and click the Load Image menu item from the context menu, the Open dialog will appear. Select the new background image and click the Open button. You can use images in the .bmp, .gif, .jpg, or .png file formats. To background image can be remove by clicking Clear Image under the Background Image option.

The Graph View

After adding a background to the canvas click the Background Image toolbar button and then click the Show Tool menu item, following this action the Background Tool will appear in the canvas area, this tool allows the user to move, zoom and change the transparency of the background image. This tool can be hidden by clicking on the X button which appears in the middle of the circular control.

The Background Tool

Customizing Nodes

Ubiqua has 4 different default node type icons for Zigbee networks, represented with colored hexagons in 4 different tones. A blue icon represents a router node, a green one represents an end device, a red icon represents a coordinator node and a gray one represents any other case.

Icon color code

For Thread networks, every node state is represented with the initials of every node’s role and type. The L letter represents a Leader node, the R letter represents a Router node, the End Devices are represented with an E letter, the BR acronym represents a Border Router, and the LBR acronym is for a Leader Border Router.

Icon color code

The appearance, position and alias of the nodes can be customized by you. You can change the position of the nodes by clicking and dragging each one within the Graph View. The connecting arrows will move as the node does for persistence. Also, note that for this action is recommended that the Graph and the Network Explorer views are not hidden or auto-hidden.

If you want to easily identify the nodes of your network, Ubiqua allows you to visually customize them by letting you change their alias and their icon. To do so, right click on one of your Graph View’s nodes and select the Customize option in the context menu to open this window. The node’s IEEE Address and Alias will be displayed in it, being only the second one available for you to modify.

Graph View context menu

The Customize window can also be opened from the Properties view, clicking the Customize button located in the Customizable Properties expander below the Alias input, as well as from the Properties window, under Network > Devices tabs, a list of devices is displayed where each of them can be identified by their IEEE Address. Right clicking on them and selecting Customize option will also open that window, unlike the window opened from the Graph View, the window opened from the device list displays the Short Address of the selected device. Note that if the device has previously appeared in the network with different short addresses, they will be displayed in a list under the Existing Short Addresses expander.

Network Window

The Customize window also has the function to let you change the node’s icon. In the left side of the window you will see a circle with the legend Change Icon, click on it to open the Set Node Image dialog, which is compound of 2 columns, the left one lists the different categories of the Ubiqua Icon Set for your devices, the right one shows the correspondent icons of the selected category. To assign an icon to your node, click on one of the listed icons and then click on the Set Icon button at the bottom right of the dialog, following this action the icon will be set and previewed in the Customize window. If you prefer to add your personal image files to the network nodes, click on the Custom option at the bottom of the Categories column, after this a drag and drop area will be displayed for you to place your images, below this a button with the Choose an image legend will also appear as an alternative option to open a file locator in your computer to load your images. The chosen images with the Custom option will also be previewed in the Customize dialog. If you want to return the node’s icon to it’s default image you can use the option Remove Icon that is in the context menu of the circle with the image of the node.

Customize Window

Once you have performed the previously mentioned steps, click the Save Changes button to visualize the node customization, or Cancel to keep the node’s previous properties. If you saved the changes the Graph View will be updated with your new given Alias and Icon properties. When you modify a node alias or icon, this is saved in your configuration, this will help to remember your choice, and when the node appears again in the capture it will use the previously saved data.

Set Node Image Window

Create Filter

Right clicking on your nodes gives you the possibility to filter your Traffic View capture, select the Create New Filter menu item, and a customized filter option for your selected node will appear for you to click it, following this action the Results View will only display those packets related to the selected node.

Changing the Network Layers

Ubiqua shows two kind of relationships between network nodes: Topology and Routing. Each one of these are represented in the Graph View as layers. The Topology Layer for Zigbee captures is constructed by examining the information of the MAC association request/response message and are represented by blue color edges. The Routing Layer for Zigbee captures is constructed by examining the information contain in the Zigbee Network Link Status messages and are represented by green color edges.

Topologies

A set of graphical representations for different network’s behaviors can be displayed in the Graph View. The Joining Topology, Link Status Topology and One Hop Link Topology are the algorithms that take the data capture as input and visually display different aspects of the network.

To visualize the different topologies click the Layers button in the Graph View toolbar and then check any of the topology radio buttons, following this action the graph will re-accommodate in the view and the edges will be painted with a different color based on the selected topology.

Joining Topology

This Graph View’s topology representation is given from the association of the nodes to the network according to the rules of the Join Process, where every node has to pass the association process before being allowed to send data over the network.

Joining Topology

This topology displays the current connections of the network according to the Link Status (Routers) and Data Request (End Devices) messages of the data capture.

Link Status Topology

This topology displays the network’s connections using one hop communication between devices, one hop is defined as the MAC source and MAC destination pair in a packet.

One-Hop Link Topology

Spanning and Zooming

To span the Graph View, click on any free space on the canvas and drag the mouse cursor. For zooming use the mouse wheel button.

Exporting Images

The Graph View has a useful feature to share the visual representation of the network. You can export the contents of the view as an image. To do so, click on the Save Image toolbar button. The Save dialog will appear, select the location and the file format and click the Save button. You can save images in the .bmp, .gif, .jpg, .png, or .tif file formats.

Filtering Nodes

The Graph View has the ability to show or hide nodes based on their PAN ID or corresponding communication Channel. To do this click the Filters toolbar button and select either Filter By PAN ID or Filter by Channel; next a checkbox list with the available Channels or PAN ID’s will appear, check the items to show their corresponding nodes in the Graph View canvas, uncheck the items to hide their nodes.

Ghost Nodes

The Graph View is the visual representation of the nodes that are part of the network, Ubiqua also allows you to see those nodes that have joined and then leaved the network during a current capture, these nodes are visualized in the topology with a clearer opacity than those nodes that are currently connected to the network, the incidence to the nodes to which they were connected will also be displayed.

If a node connects multiple times to the network, will also be reflected in the topology, drawing each one of the times that this node joined the network during the capture in the Graph View. To be able to see this behavior click the Show ghost nodes button in the Graph View toolbar.

Ghost Nodes