Ubiqua Protocol Analyzer

Install the Required Software

Download and install the following software:

• Ubiqua Protocol Analyzer software
• SmartRF Protocol Packet Sniffer, which contains sniffer firmware for the CC2531
• Flash Programmer, used to program the CC2531

Note

Download SmartRF Protocol Packet Sniffer and SmartRF Flash Programmer, not SmartRF Packet Sniffer 2 and SmartRF Flash Programmer 2.

Required Hardware

It is recommended to use the CC2531 USB Dongle with Ubiqua Protocol Analyzer. The device comes pre-programmed with the packet sniffer firmware. However, if it is not programmed with the sniffer firmware, the CC-Debugger is required to flash the device.

The Cebal driver must be installed to use the CC-Debugger. The driver should already be installed if you have installed Flash Programmer. This can be verified by connecting a device to the debugger, opening up Flash Programmer, and observing the device showing up as connected.

Ubiqua Protocol Analyzer also provides the necessary files for installing the Cebal driver. The installation files are found under C:\Program Files (x86)\Ubilogix\Drivers\TI\, with cebal2.* files for 32-bit Windows and cebal2_x64.* files for 64-bit Windows. Depending on which Windows version you are using, refer to a corresponding guide for how to install Windows drivers.

Hardware Setup

• Connect the CC2531 USB Dongle to the computer with Ubiqua installed.

• If the device is not programmed with the sniffer firmware, connect a CC-Debugger to it and use Flash Programmer to program the sniffer firmware.

  • The firmware image for CC2531 is called sniffer_fw_cc2531.hex, and is found under bin/general/firmware in the SmartRF Protocol Packet Sniffer installation.
  • Refer to the CC-Debugger User’s Guide for how to flash the firmware.

Running the Packet Sniffer

1. Connect the CC2531 USB Dongle.

2. Start Ubiqua Protocol Analyzer.

3. Select Device → Add Device, and choose the CC2531.

   

   Figure 40. Add a new sniffer device

4. Set the Default Protocol to Thread. Select Tools → Options then select General → Default Protocol Stack and set it to Thread.

   

   Figure 41. Ubiqua options

   

   Figure 42. Select Thread protocol

5. In options, select Security Tab → KeyChain. Click Add, then select type Thread Master Key. By default, the Thread Master Key for OpenThread is 00112233445566778899aabbccddeeff. Click OK.

   

   Figure 43. Add Thread encryption keys

6. Choose the Channel.

   CLI device:to choose the channel via the channel command. NCP device:is told via wpantund what channel to use via various configuration steps. See Linux Border Router Quick Start for more details.

   

   Figure 44. TI-OpenThread channel configuration

   In Ubiqua, select Device → Channel, and select the matching channel.

   

   Figure 45. Channel selection in Ubiqua

7. Start a sniffer capture.

   In Ubiqua, select Device → Start Device.

   

   Figure 46. Start sniffer capture in Ubiqua

8. If required, select View → Traffic View (or other selections) to view activity.