WorryFree Wi-Fi
Analyzer
for Version 3.0.x
Administrator Guide
for
Android ™
MN-003373-02
Copyright
ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in
many jurisdictions worldwide. All other trademarks are the property of their respective owners. ©2019
Zebra Technologies Corporation and/or its affiliates. All rights reserved.
COPYRIGHTS & TRADEMARKS: For complete copyright and trademark information, go to
www.zebra.com/copyright
.
WARRANTY: For complete warranty information, go to www.zebra.com/warranty
END USER LICENSE AGREEMENT: For complete EULA information, go to www.zebra.com/eula
Terms of Use
• Proprietary Statement
This manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries
(“Zebra Technologies”). It is intended solely for the information and use of parties operating and
maintaining the equipment described herein. Such proprietary information may not be used,
reproduced, or disclosed to any other parties for any other purpose without the express, written
permission of Zebra Technologies.
• Product Improvements
Continuous improvement of products is a policy of Zebra Technologies. All specifications and designs
are subject to change without notice.
• Liability Disclaimer
Zebra Technologies takes steps to ensure that its published Engineering specifications and manuals
are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors
and disclaims liability resulting therefrom.
• Limitation of Liability
In no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of
the accompanying product (including hardware and software) be liable for any damages whatsoever
(including, without limitation, consequential damages including loss of business profits, business
interruption, or loss of business information) arising out of the use of, the results of use of, or inability to
use such product, even if Zebra Technologies has been advised of the possibility of such damages.
Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so
the above limitation or exclusion may not apply to you.
.
.
Revision History
Changes to the original guide are listed below:
Change Date Description
-01 Rev A 9/2018 Initial release.
-02 Rev A 7/2019 Add support for logging and password procurement.
2
Table of Contents
Terms of Use ................................................................................................................... 2
Revision History ..............................................................................................................2
About This Guide ............................................................................................................................... 6
Introduction ..................................................................................................................... 6
Product Support .............................................................................................................. 6
Best Practices ................................................................................................................. 6
Chapter Descriptions ....................................................................................................... 7
WFW Analyzer Use Cases .............................................................................................. 7
Notational Conventions .................................................................................................. 9
Provide Documentation Feedback .................................................................................. 9
Using WFW Analyzer ....................................................................................................................... 10
Introduction ................................................................................................................... 10
Opening WFW Analyzer ............................................................................................... 11
Home Screen ............................................................................................................... 12
Status .................................................................................................................... 12
Connected IP Network ........................................................................................... 13
Device Information ................................................................................................. 14
Scan List ...................................................................................................................... 15
Scan Interval .......................................................................................................... 16
Filter Options ......................................................................................................... 16
Detailed Capabilities for BSSID ............................................................................. 17
Display Refresh Options ................................................................................. 18
Connection Analysis ..................................................................................................... 19
Module Selections ................................................................................................. 20
Results ................................................................................................................... 20
Setting Network Parameters .................................................................................. 21
Roaming Analysis ........................................................................................................ 23
Roaming Analysis Settings .................................................................................... 24
3
Table of Contents
Save Data Options ................................................................................................ 25
Clear Sessions ................................................................................................ 25
Export Saved Data .......................................................................................... 26
Advance Reports ................................................................................................... 26
Monitor and Reports ........................................................................................ 26
Ping Refresh Settings ..................................................................................... 31
Voice Analysis .............................................................................................................. 33
Voice Analysis Settings ......................................................................................... 34
Save Data Options ................................................................................................ 35
Clear Sessions ................................................................................................ 35
Export Saved Data .......................................................................................... 36
Advance Reports ................................................................................................... 36
Monitor and Reports ........................................................................................ 36
Networking Tools ......................................................................................................... 42
Ping ....................................................................................................................... 42
Ping Settings ................................................................................................... 43
Device’s Coverage View .............................................................................................. 44
Auto Reachability Test ........................................................................................... 45
Logging ........................................................................................................................ 46
Fusion Advanced Configuration ................................................................................... 47
About ............................................................................................................................ 48
Camera Preview ........................................................................................................... 49
Configuration ................................................................................................................................... 50
Configuration Using Mobility Extensions ....................................................................... 50
Configuration Using StageNow ..................................................................................... 50
Setting the Password ............................................................................................. 50
Report Logger Content ................................................................................................................... 54
Introduction ................................................................................................................... 54
Content Structure .......................................................................................................... 54
Header .......................................................................................................................... 54
Roaming and Voice Analysis Headers .................................................................. 54
INFO Severity Class Headers ......................................................................... 54
WARNING or ERROR Severity Class Headers .............................................. 55
Voice Analysis Only Headers ................................................................................ 55
INFO or WARNING Severity Class Headers .................................................. 55
Parameters ....................................................................................................................55
Reasons ........................................................................................................................ 56
Roaming and Voice Analysis Reasons .................................................................. 56
Analyzed Reason Strings ................................................................................ 56
Standard IEEE Codes for De-Authentication Packets .................................... 58
4
Table of Contents
Voice Analysis Only Reasons ................................................................................ 58
WARNING Severity Class Headers ................................................................ 58
Packet Capture ................................................................................................................................. 59
Introduction ................................................................................................................... 59
Features ........................................................................................................................ 59
Supported Packet Types .............................................................................................. 60
Supported Headers and Content .................................................................................. 60
5
About This Guide
Introduction
This guide provides information for the WorryFree Wi-Fi Analyzer (WFW Analyzer) app (formerly
SmartMU), which analyses WLAN network connectivity in real-time. View reports of performance and
errors in real-time, off-line, or as log files.
Product Support
WFW Analyzer version 3.0.x is available on the following devices running Android Nougat with LifeGuard
update 12 or later.
• MC33
• TC51
• TC51-HC
• TC56
• TC70x
• TC75x
Best Practices
For the best experience while using WFW Analyzer:
• It is not recommended to change the Font size and Display size on the device from the default.
Adjusting the Font size or Display size may cause the WFW Analyzer app to not display correctly.
• It is not recommended to use Multi-Window mode. Using Multi-Window mode may cause the WFW
Analyzer app to not display correctly.
• Ensure the primary user is logged into the device. The Android multi-user feature is not supported by
the WFW Analyzer app.
• Do not change the Wi-Fi settings on the device while actively using a WFW Analyzer feature. This
applies to the WFW Analyzer app or WFW Analyzer configuration using a Mobile Device Manager
(MDM).
• Packet capture and networking tools can run at the same time as another WFW Analyzer feature. This
applies to the WFW Analyzer app or WFW Analyzer configuration using an MDM.
• Do not run Ping using a short time interval if also running other WFW Analyzer feature(s) at the same
time. This applies to the WFW Analyzer app or WFW Analyzer configuration using an MDM.
6
• If the Connection Analysis feature is started using a staging tool or an MDM, do not start another
feature from the WFW Analyzer app until the connection analysis is complete.
• Each time the Connection, Roaming, and Voice Analysis features start, the device disconnects and
then reconnects to the network. When using these features to analyze the Wi-Fi connection of a device
and test the traffic of another app, it is highly recommended to start the analysis feature before starting
the other app. This prevents interruption of the Wi-Fi connection during the test. Other WFW Analyzer
features do not interrupt the Wi-Fi connection.
Chapter Descriptions
Topics covered in this guide are:
• Using WFW Analyzer describes how to use the WFW Analyzer app.
About This Guide
• Configuration
• Report Logger Content
• Packet Capture provides detailed information about SmartMU packet captures.
describes how to provide a WFW Analyzer password.
WFW Analyzer Use Cases
Analysis data provided by WFW Analyzer saves time and cost by allowing administrators to quickly
improve or mitigate performance issues. Actions may include reconfiguring the RF or WLAN system,
reconfiguring the device, or locating an issue that requires further investigation.
The following table describes some of the common WFW Analyzer use cases.
Table 1 Use Cases
Summary Detailed Description WFW Analyzer Feature
Basic connectivity information. View the status of the connected
WiFi surveys and coverage from
the mobile device view.
Live Wi-Fi Roaming Analysis
while using a mobile device in
motion
provides a list of report headers and analyzed reasons.
Home screen
device, including the connected AP,
RSSI, channel, and IP/DHCP/DNS.
View multiple networks and access
points (APs) from locations within radio
frequency (RF) range of the device.
View connectivity and roam events.
Perform an auto reachability test from
connected APs to the gateway.
Verify the APs over-the-air advertised
data, retrieved directly from the
information elements of the AP packets.
While roaming, view real-time data
about the performance and health of the
WLAN, AP-handoffs, and network
traffic.
View real-time detection of issues,
causes, and RF environmental
parameters.
Scan List
Device Coverage View
Roaming Analysis
7
About This Guide
Table 1 Use Cases
Summary Detailed Description WFW Analyzer Feature
Live voice quality analysis while
using a mobile device in motion.
WiFi connection analysis. On demand troubleshooting of initial
Packet capture for off-line
analysis using a computer.
Troubleshoot and compare
Fusion configuration parameters.
Network reachability and
performance testing.
View real-time data about the
performance of simulated voice traffic,
combined with Roaming Analysis data.
View real-time detection of voice traffic
issues, reasons quality measures
exceeded thresholds, and RF
environmental parameters.
and full associations to the SSID and IP
network, including reasons and
sub-protocols triggering a connection
failure.
Enabled packet capture to automatically
save packets to pcap format. Content
includes 802.11-header and radiotap.
ViewChange the band preference or
power save parameters to compare
configurations.
Test configurations on-site without
waiting for a configuration update from a
software patch or central staging.
Run one or two independent pings at
the same time, each with a separate
configuration of the packets and
destination.
Validate performance and simulate an
app's required concurrency of network
destinations.
Voice Analysis
Connection Analysis
Logging
Fusion Advanced Config
Network Tools > Ping
8
Notational Conventions
This document uses the following conventions:
•Bold text is used to highlight the following:
• Dialog box, window and screen names
• Drop-down list and list box names
• Check box and radio button names
• Icons on a screen
• Key names on a keypad
• Button names on a screen.
• Bullets (•) indicate:
• Action items
• Lists of alternatives
• Lists of required steps that are not necessarily sequential.
• Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.
About This Guide
Provide Documentation Feedback
If you have comments, questions, or suggestions about this guide, send an email to
EVM-Techdocs@zebra.com
.
9
Using WFW Analyzer
Introduction
This chapter describes the following WFW Analyzer features:
• Opening WFW Analyzer on page 11
• Home Screen on page 12
• Scan List on page 15
• Connection Analysis on page 19
• Roaming Analysis on page 23
• Voice Analysis on page 33
• Networking Tools on page 42
• Device’s Coverage View on page 44
• Logging on page 46
• Fusion Advanced Configuration on page 47
• About on page 48
• Camera Preview on page 49.
10
Opening WFW Analyzer
Before using WFW Analyzer, ensure that Wi-Fi is enabled on the device. For information on how to enable
Wi-Fi, refer to the user guide for your device.
To open the WFW Analyzer app, swipe up from the bottom of the Home screen and touch .
Figure 1 WFW Analyzer Screen
Using WFW Analyzer
11
Home Screen
The Home screen displays:
• Status
• Connected IP Network
• Device Information.
Figure 2 Home Screen
Using WFW Analyzer
Status
Displays the current device status.
•Status - Current connection status
• SSID - Name of the connected WLAN network
•IP Address - IP address of the device
• AP/BSSID - Basic Service Set ID (BSSID) of the connected access point
• RSSI - RSSI of the connected access point
• Channel (Band) - Displays the channel.
12
Connected IP Network
To view the following details of the connected IP network, touch the down arrow next to Connected IP
Network.
Figure 3 Connected IP Network
Using WFW Analyzer
• Gateway - IP address of the network gateway
• DHCP Server - IP address of the DHCP server
• Lease Duration - Amount of time the IP address of the device is leased. The device renews the lease
before the lease duration expires.
• Netmask - Server subnet mask address
• DNS1 - Domain Name System 1 (DNS1) address
• DNS2 - DNS2 address.
13
Device Information
To view the following device information, touch the down arrow next to Device Info.
Figure 4 Device Info
Using WFW Analyzer
• Device Product Name
• Device MAC
• Operating System.
14
Scan List
Using WFW Analyzer
The Scan List main screen displays a list of BSSIDs and their corresponding SSIDs, RSSI, and channels.
The first row displays the currently connected BSSID, unless the connected SSID is filtered out using
Select Filter Options, or the device is not connected at all. All other rows are sorted and filtered according
to the filter options. See Filter Options on page 16.
The Scan List includes all BSSIDs with the same country, band, configuration, and WLAN protocols as the
current channel. Wi-Fi Direct SSIDs are not supported.
To view the Scan List, touch > Scan List.
Figure 5 Scan List
For each BSSID, the following displays:
• BSSID - MAC address of the access point BSSID
• RSSI - Received signal strength in dBm. The closer the dBm number is to zero, the stronger the signal.
• SSID - Name of an 802.11 wireless local area network (WLAN)
• Channel/Band - Channel and frequency band.
15
Scan Interval
Use Scan Interval to change the time interval between scans (range: 5 - 15 seconds, default: 5 seconds).
Figure 6 Monitor and Reports
To change the time interval between scans:
1. Touch > Scan List > > Scan Interval.
2. Use the slider to set the interval.
3. Touch OK.
Using WFW Analyzer
Filter Options
From the Scan List screen, touch Select Filter Options to filter networks.
Figure 7 Filter Options
• Modify Filtering Options - Select to filter the Scan List using one of the following options:
• All SSID - Display BSSIDs of all SSIDs (default)
16
Using WFW Analyzer
• Connected SSID - Display BSSIDs of only the connected SSID
• Filter by SSIDs - Touch to display a list of SSIDs. Select an SSID to enable or disable view of its
corresponding BSSIDs in the Scan List.
•Sort By - Select to sort the Scan List by Received Signal Strength (RSSI) (default), or Channel.
• Group by SSID - Select to group SSIDs with the same name together. SSIDs are listed in alphabetical
order.
Detailed Capabilities for BSSID
From the Scan List screen, touch a BSSID to display detailed capabilities.
Figure 8 Detailed Capabilities for BSSID
• AP/BSSID - Displays the MAC address of the access point BSSID.
• SSID - Displays the WLAN network name corresponding to the BSSID.
•AP MAC OUI - Displays the Organizationally Unique Identifier (OUI). When an organization was not
assigned an identifier, or an identifier was recently assigned by the IEEE Registration Authority, this
value is empty.
• Supported Bands - Displays the notation of the supported 802.11 standard for the associated 2.4 GHz
or 5 GHz band.
A physical AP is typically dual-band, where each band of the AP has a unique BSSID identifier, so each
BSSID of the AP is listed as a unique item on the Scan List main screen.
• Beacon Params - Touch the down arrow next to Beacon Params to view the beacon interval.
• 11d Country, Power, Channels - Touch the down arrow to view details.
17
• QoS and Power Save - Touch the down arrow next to QoS and Power Save to view QoS and Power
Save information.
Some APs do not support QoS and Power Save. If Not Supported displays, it is recommended to
check the AP’s Wi-Fi Multimedia (WMM) settings in the AP packets using packet capture. See Packet
Capture on page 56.
•Security - Touch the down arrow next to Security to view security WLAN information.
Display Refresh Options
Use Display Refresh Options to enable or disable the automatic refresh of the detailed capabilities
information.
Touch Display Refresh Options and use the toggle switch, then select OK.
Figure 9 Display Refresh Options
Using WFW Analyzer
IMPORTANT: When Roaming Analysis is running with default settings, the Scan List displays only
ROAM events. To change the type of scans displayed, see Roaming Analysis Settings on page 24.
18
Connection Analysis
Use Connection Analysis to perform a one-time connection analysis on the selected SSID network.
Selecting a network layer in the Module Selections tab automatically selects all of the dependent layers
below it. The order that the connection analysis runs is based on standard WLAN networking dependency,
from the bottom (MAC) to the top (Connectivity). If any of the dependent layers fail, all layers above it also
fail.
By default, the analysis is run on the connected WLAN network, unless configured in settings. See Setting
Network Parameters on page 21.
Figure 10 Connection Analysis
Using WFW Analyzer
• Connectivity - This test is initiated by the WFW Analyzer app, and analyzes the ICMP (ping)
reachability test using the selected SSID network.
To run a full connection analysis on all layers, select the Connectivity layer.
• Address Resolution Protocol (ARP) - This test is initiated by the WFW Analyzer app, and analyzes
the ARP process using resolved parameters from the DHCP layer.
• Dynamic Host Configuration Protocol (DHCP) - The DHCP is initiated automatically by Android, and
analyzes the native Android DHCP process.
• Extensible Authentication Protocol over LAN (EAPOL) - This analyzes the EAPOL process of the
WLAN network stack. If the EAPOL is not required, for example, with an open network, the analysis is
skipped.
• Media Access Control (MAC) - This analyzes the MAC-based communications used for 802.11
authentication and association with an access point.
19
Loading...