Adapters View

Adapters View

The Adapters View lists and controls the adapters used as a source of network traffic in the application. If the view is not visible, show it by selecting the View > Adapters View menu item. The adapters list will be empty the first time you open the view. You need to populate this list by manually adding each adapter as needed go to Adding Adapters section for instructions.

Once the list has been populated, each adapter will be displayed in an individual control containing the following information: status, extended status, alias, and a switch to change the adapter status (see the figure below).

adapters view

The status will display Unavailable if the adapter is not plugged to your computer, Disconnected if the adapter is plugged but not connected to the application, Available if it is connected but not in use, Running when it is being used, and Running on another instance if it is being used by a different instance; the table below shows the summary of this. The extended status will display additional information related to the role of the adapter in the application. For instance, the extended status of a sniffer adapter capturing packets will show the channel and protocol stack used for decoding.

Icon Status Color Description
Unavailable Gray Unavailable. It might not be plugged or recognized by the OS
Disconnected Brown Available but disconnected from Ubiqua
Available Amber Available and ready to be used
Available disconnected Amber Dimmed Available but connected to another instance of Ubiqua
Running Green The adapter is running
Running on another instance Green Dimmed Being used by another instance of Ubiqua
Error Red An error has occurred

Adding Adapters

To add a new adapter to the list, right click inside the Adapters View and select the Add menu item, or click the Add Adapter button on the top of the Adapters View. After opening the Add Adapter dialog (see the figure below), if your adapter is compatible with Ubiqua (see Supported Sniffer Hardware for details) and was able to identify it, then your adapter will be in the Available list.

If your adapter is in the supported adapters list, but you don’t see it in the Add adapter dialog, make sure you have the correct drivers installed.

add adapter dialog

If your adapter is in the Available list, just select the adapter and click on the Select button. At this point the adapter should have been added to the adapters list, unless the adapter supports multiple applications. If that is the case, you have to select a supported application (see the figure below) and then click in the Select button.

select app dialog

The adapter you want to add to your adapters list, may not have been discovered by the Adapters View automatically. If that is your case, what you need to do is click on the ‘Custom’ button which will open the configuration dialog (see figure below) where you can select interface type (UART or IP), interface ID, and the supported application the adapter is using.

add custom dialog

When setting up a SEWIO Open sniffer for the first time, you must configure the adapter via its web interface, additional information can be found in SEWIO Hardware.

Ubiqua doesn’t offer support for Windows 7, however you could still use it but most adapters wil need to be added though the ‘Custom’ method.

SEWIO Adapter

In order to use the Sewio Open Sniffer in Ubiqua, it must be connected and configured in the same subnetwork as the computer running Ubiqua. Please refer to Part 1 of the Sniffer Installation.

The process of configuring the sniffer in Ubiqua is simple. First, we add the Sewio by right clicking on the Adapters View or via the Adapter main menu, and selecting the Add option.

Add Sewio Adapter

In the Add Adapter window, click on the Custom button to add as a custom adapter.

Add Sewio Adapter

Then select the configuration parameters; Interface Type should be Ethernet, App is Open Sniffer, then Host IP and Port the appropriate for the Sewio adapter.

Start Sewio Adapter

At this point the Sewio adapter is added to Ubiqua.

Configuring Adapters

Once an adapter is added to the list, you can configure its properties by right-clicking on the adapter and selecting the View Properties menu item (see the figure below). This will open the Properties view, where the properties can be edited. As long as the Properties view is open, it will show the properties of the selected adapter in the Adapters View.

adapter properties

Ubiqua provides shortcuts to some of these configurations; configure radio, protocol stack, and channel are options in the adapter contextual menu. Right click on an adapter and make your selection, Ubiqua will automatically restart the adapter if it was running.

Radio configuration

The adapter you select to use may support several radio configurations (modulation, frequency band, data rate), to change between them use the contextual menu item Config Radio (see figure below). Here you can find options to select each of the adapter’s supported radio configurations.

radio configuration

Protocol stack

This option allows you to select the stack which will be used to decode the data captured by the selected adapter.

protocol stack

Channel

The available channels can change depending on the selected radio configuration. You can move the slider to select a channel or directly write it in the text box (see image below).

adapter channel

Capturing Traffic

To start capturing packets click on the adapter switch button or select the Start/Stop on the contextual menu. If a problem was found starting the adapter and you can’t stop or start it anymore, proceed first toggle the Connect/Disconnect option twice. If that doesn’t fix the problem then unplug the adapter and plug it back to your system; usually, this will resolve the problem. If you keep experiencing problems, make sure the port is not being used by another program in your system and try again. Also, please note that according to your license you could be limited to a certain number of adapters started at the same time. Whatever the cause of the problem is, the extended status of the adapter in question (found in Properties View) will display a possible solution.

Removing Adapters

Adapters on the list are maintained by the application and stored in environment files. To remove an adapter right click on it and select the Remove menu item. If you want to remove all adapters right click on the Adapters View view and select the Remove All menu item. Please note that this action can’t be undone.

Scanning Channels

Scan channels allows capturing through all channels or the selected channels. Each selected channel will capture during a specific time, at the end, Ubiqua will show the number of captured packets per channel on a graph. While UBiqua is scanning a channel all captured traffic will be displayed in the Traffic View, you can use this to select which channel you want to set your adapter to capture.

To scan channels, right click on the adapter and select the Scan Channels menu item. After the Scan Channels dialog opens, select the channels to scan and set the scanning time per channel; to start the scanning process press the Start button. The Scan Channels dialog will hide while the scan process is in progress, to stop the process you can open the dialog again from the context menu or jut click on the Stop button in the Adapters View.

The graph in the Scan Channels dialog will display the packets captured per channel when you place the mouse over any channel. Note that the packets captured during the scanning process may appear in the Traffic View and that the channel list may be different, depending on the capabilities of the adapter used for scanning.

scan channels dialog”

Multiple Ubiqua instances

Ubiqua uses a service we called the Adapter Manager. This service manages the resources (adapters) of its host and interacts with the different communication interfaces (UART, USB, IP, etc.) available, multiple instances of Ubiqua connect to one Adapter Manager running in the host as clients, and then consume those resources.

An adapter can only be connected and be used by one Ubiqua instance at a time. Because of this, we have provided an option under the adapter contextual menu to force the connection of an adapter that is Idle but connected to a different instance (see image below). To know if an adapter is connected to another instance but in an idle state, you will see the light blue color in the status indicator and the Start button will be disabled, to connect the adapter to the current instance you can use the Force Connect option in the context menu of the selected adapter, this will effectively steal the adapter from the instance that had it originally.

If another instance of Ubiqua has started an adapter and is using it, the status dot will be dark blue in color; then the force connect will be denied if attempted. You can find the exact status of an adapter its Properties.

force connect