UWB Sniffer Debugging platform for RTLS Integrators and Developers Fully integrated with industry standard Wireshark 6 channels (802.15.4a UWB PHY) Ethernet Communication interface Easy to automate via HTTP interface Received Signal Strength Indication Injection Mode for sending packet Support for dissecting Decawave Two Way Ranging protocol Dimensions: 51 x 51 mm Package Content 1x UWB Sniffer 1x USB to DC 1.3mm Power Cable 1x Ethernet Cable Sewio Networks, s.r.o www.sewio.net, email:[email protected] Requirements Wireshark (Linux/ Windows) USB port or DC Adapter 5V/500mA

Sewio Networks, s.r.o www.sewio.net, email:[email protected]

UWB Sniffer provides following two operation modes: Sniffing and Injection. In the first one the sniffer device captures all the 802.15.4 UWB frames transmitted over the air and forward them to Wireshark. Injection mode enables to send arbitrary UWB frames directly from the sniffer’s web interface. Sniffing Mode Injection Mode This is default mode of operation for the UWB Sniffer device. User needs to select desired channel and some other parameters. All captured frames on the particular channel are feed to Wireshark which is an open source industry-standard software for analyzing wired and wireless...

2.1 Hook up cables to UWB Sniffer Connect Ethernet cable and power cable to UWB Sniffer as it is depicted in picture below. 2.2 Setting TCP/IP at the host side In this section we are going to adjust TCP/IP settings at PC host in order to be able to communicate with the UWB Sniffer device. Default sniffer's settings are: IP address 10.10.10.2, mask 255.255.255.0 Host’s IP address must be within the same network scope as the UWB Sniffer device. Set host IP to 10.10.10.1 and network mask to 255.255.255.0. This can be done via “Network and Sharing Center” in Windows. Press CTRL+R and type “ncpa.cpl”...

2.3 Connect to the UWB Sniffer homepage Now, point a browser to sniffer’s home address http://10.10.10.2, homepage should appear. Sewio Networks, s.r.o www.sewio.net, email:[email protected]

UWB Sniffer acts as a probe which capturing 802.15.4 frames and forwards them to a remote host computer. In order to be able to work with those frames Wireshark software is used. Download, install and run Wireshark. Please select the latest stable appropriate for your operating system and architecture. Select the Ethernet interface (linked to UWB Sniffer) from the available capture interfaces and start capturing frames. Wireshark implicitly shows all frames from wired and wireless networks delivered to the selected interface. Therefore, it is useful to apply 802.15.4 filter which is referred...

3.5 Adjusting Wireshark for IEEE 802.15.4 Networks The previous chapter describes process of data capture and initial Wireshark configuration. User may download the sample file uwb_twr_demo. Wireshark has default columns settings for wired Ethernet network, see picture below. Columns are defined for the default Wireshark profile as follows: Column name Frame number counted from the start of capture in Wireshark. This is NOT number of a frame received from UWB Sniffer. It includes all packets (wired&wireless) delivered to the host’s ethernet interface Ethernet timestamp of the frame assigned by...

From the table above it is obvious the default column settings are not associated with 802.15.4. Therefore, user can adjust them to the 802.15.4 frame info. Let’s refresh the encapsulation scheme for each 802.15.4 frame delivered to the host (see picture below). While the grey colored protocols are used only to transport the 802.15.4 frame through a network infrastructure, the ZEP – Zigbee Encapsulated Protocol carries all the important information such as sequence number, timestamp or channel number related to the every 802.15.4 captured by the UWB Sniffer device. Although, Wireshark natively...

zepv3.device_id unique ID of the sniffer, based on MAC address zepv3_lqi_mode LQI/CRC either LQI is send to Wireshark or CRC value zepv3.lqi LQI value, not used in UWB Sniffer Time elapsed since sniffing was started at UWB Sniffer Relative time since sniffing was started at UWB Sniffer Absolute time converted to host timezone Differential time among packets Sequence number of packet send from UWB Sniffer IEEE 802.15.4 frequency band zepv3.chanpage IEEE 802.15.4 channel page zepv3.length IEEE 802.15.4 frame length 3.8 Adjusting Wireshark columns to IEEE 802.15.4 compliant frame Note: The procedure...

Adjusted Wireshark columns should seem like this: Sewio Networks, s.r.o www.sewio.net, email:[email protected]

4 UWB Sniffer Configuration 4.1 Home Page Home page contains following summary information about an analyzer: MAC address, IP address, current channel, (non)standard frame delimiter, crc filter and data rate. Below summary section the counters are displayed. Counters (see picture below) have 12 bit resolution and they are related to selected events on PHY UWB layer. They might be quite useful during the network debugging and trouble shooting. At the very bottom of the homepage a firmware version is displayed. Sewio Networks, s.r.o www.sewio.net, email:[email protected] RUN/STOP button and status...

Radio parameters, network configuration and host settings are done via this page Channel Center Frequency (MHz) Pulse Repetition Frequencies (PRF) 16 MHz / 64 MHz Preamble Length 4096, 2048, 1536, 1024, 512, 256, 128, 64 Data Rate 110 / 850 / 6800 kbps Preamble Code 1,2,3,4,5,6,7,8,9,10,11,12,17,18,19,20 PAC Size (symbols) 8 / 16 / 32 / 64 Frame Delimiter Standard / Non Standard LQI/CRC mode LQI mode – frames are forwarded to Wireshark with signal strength values CRC mode – frames are forwarded to Wireshark with CRC value received CRC filter On/Off – 802.15.4 frames with wrong CRC are discarded...

UWB Sniffer 4.3 Sniffer IPv4 Settings • • • • IP mode – DHCP client / Static IP address IP address Netmask Gateway Host IP address – IP address of the host computer where Wireshark is running Host UDP port – should be set 17754, this identifies 802.15.4 flow in Wireshark 4.5 Injection Mode This mode is dedicated for a frame transmission. User needs to set UWB PHY settings as well as the payload, number of packet repetition and time gap among the packets. User might also set whether sniffing mode should be started right after the transmission ends. Sewio Networks, s.r.o www.sewio.net, email