Manual - QualiPoc Android 12.0.0
Manual - QualiPoc Android 12.0.0
Manual - QualiPoc Android 12.0.0
SwissQual License AG Allmendweg 8 CH-4528 Zuchwil Switzerland t +41 32 686 65 65 f +41 32 686 65 66 e info@swissqual.com www.swissqual.com
SwissQual has made every effort to ensure that eventual instructions contained in the document are adequate and free of errors and omissions. SwissQual will, if necessary, explain issues which may not be covered by the documents. SwissQuals liability for any errors in the documents is limited to the correction of errors and the aforementioned advisory services. Copyright 2000 - 2012 SwissQual AG. All rights reserved. No part of this publication may be copied, distributed, transmitted, transcribed, stored in a retrieval system, or translated into any human or computer language without the prior written permission of SwissQual AG. Confidential materials. All information in this document is regarded as commercial valuable, protected and privileged intellectual property, and is provided under the terms of existing Non-Disclosure Agreements or as commercial-in-confidence material. When you refer to a SwissQual technology or product, you must acknowledge the respective text or logo trademark somewhere in your text. SwissQual, Seven.Five, SQuad, QualiPoc, NetQual, VQuad, Diversity as well as the following logos are registered trademarks of SwissQual AG.
Diversity Explorer, Diversity Ranger, Diversity Unattended, NiNA+, NiNA, NQAgent, NQComm, NQDI, NQTM, NQView, NQWeb, QPControl, QPView, QualiPoc Freerider, QualiPoc iQ, QualiPoc Mobile, QualiPoc Static, QualiWatch-M, QualiWatch-S, SystemInspector, TestManager, VMon, VQuad-HD are trademarks of SwissQual AG. SwissQual acknowledges the following trademarks for company names and products: Adobe, Adobe Acrobat, and Adobe Postscript are trademarks of Adobe Systems Incorporated. Apple is a trademark of Apple Computer, Inc. DIMENSION, LATITUDE, and OPTIPLEX are registered trademarks of Dell Inc. ELEKTROBIT is a registered trademark of Elektrobit Group Plc. Google is a registered trademark of Google Inc. i.Scan is a trademark of CommScope, Inc. Intel, Intel Itanium, Intel Pentium, and Intel Xeon are trademarks or registered trademarks of Intel Corporation. INTERNET EXPLORER, SMARTPHONE, TABLET are registered trademarks of Microsoft Corporation. Java is a U.S. trademark of Sun Microsystems, Inc. Linux is a registered trademark of Linus Torvalds. Microsoft, Microsoft Windows, Microsoft Windows NT, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries U.S. NOKIA is a registered trademark of Nokia Corporation. Oracle is a registered US trademark of Oracle Corporation, Redwood City, California. SAMSUNG is a registered trademark of Samsung Corporation. SIERRA WIRELESS is a registered trademark of Sierra Wireless, Inc. TRIMBLE is a registered trademark of Trimble Navigation Limited. U-BLOX is a registered trademark of u-blox Holding AG. UNIX is a registered trademark of The Open Group.
Contents
1 Product Overview ................................................................................................................................ 4 Service Tests ......................................................................................................................................... 4 Device Support ...................................................................................................................................... 4 Post-Processing Software ..................................................................................................................... 4 QualiPoc Monitors ................................................................................................................................. 4 2 Installing QualiPoc Android ............................................................................................................... 6 GPS Configuration ................................................................................................................................. 6 Updating QualiPoc Android ................................................................................................................... 6 3 QualiPoc Settings ................................................................................................................................ 7 Map Settings .......................................................................................................................................... 7 BTS Information ..................................................................................................................................... 7 Layer 3 ................................................................................................................................................... 8 IP Monitor .............................................................................................................................................. 8 Customization ........................................................................................................................................ 9 Notification ............................................................................................................................................. 9 Technology Forcing ............................................................................................................................. 10 Unit Configuration ................................................................................................................................ 10 4 Measurement Job Types ................................................................................................................... 12 Single CALL Job Call 2 Any Number................................................................................................ 12 Single CALL Job Call MOC .............................................................................................................. 12 Single CALL Job Answering Station ................................................................................................. 13 Single DATA Job FTP DL and UL .................................................................................................... 13 Single DATA Job HTTP Transfer DL and UL ................................................................................... 13 Single DATA Job Ping ...................................................................................................................... 14 Single DATA Job HTTP Browser...................................................................................................... 14 Single DATA Job Capacity DL .......................................................................................................... 15 Single DATA Job Email Send and Receive ...................................................................................... 15 Single MESSAGE Job SMS Send and Receive ............................................................................... 16 Single MESSAGE Job MMS Send and Receive .............................................................................. 16 Multiple Jobs Multi-Data / Multi-Mix / Multi-RAB / Parallel ............................................................... 16 Advanced Settings ............................................................................................................................... 17 5 Using QualiPoc .................................................................................................................................. 18 Main Toolbar ........................................................................................................................................ 18 Creating and Running Basic Jobs ....................................................................................................... 18 Creating and Running Advanced Jobs ................................................................................................ 19
ii CONFIDENTIAL MATERIALS
Contents |
Loading and Running an Advanced Measurement Jobs ............................................................... 20 Viewing Results ................................................................................................................................... 21 Status and Log Monitors ...................................................................................................................... 22 Technology Monitors ........................................................................................................................... 22 Serving Cell Monitor ....................................................................................................................... 22 Data Monitor ................................................................................................................................... 23 Cells and Coverage Monitors ......................................................................................................... 23 Layer 3 Monitors ............................................................................................................................. 24 Map Monitors ....................................................................................................................................... 24 Outdoor Map Monitor ..................................................................................................................... 24 Offline Positioning with Open Street Map ............................................................................................ 25 Saving a Selection of an Open Street Map .......................................................................................... 25 Using BTS information on the Map Monitor ......................................................................................... 26 Indoor Map Monitor ........................................................................................................................ 26 IP and PCAP Logging Monitors ........................................................................................................... 27 Test and Events Monitors .................................................................................................................... 27 6 Measurement Files Post-Processing ............................................................................................... 29 Measurement File Logging .................................................................................................................. 29 Replaying Measurements on the Phone ............................................................................................. 29 Replaying Measurement Files in NetQual NQView............................................................................. 29 Analysing Measurement Data with NetQual NQDI .............................................................................. 30
iii
Product Overview
SwissQual QualiPoc Android has been designed for handheld radio network optimization and quality assessment. This software supports a variety of devices and technologies including GSM, GPRS, EDGE, WCDMA, HSDPA, HSUPA and LTE. Due to the ease of use, you can use QualiPoc to collect data and voice services statistics. SwissQual offers the following QualiPoc Handheld Android versions: Android RF: RF optimization and troubleshooting for scenarios where MOS testing is not a consideration. This tool has been designed for indoor and outdoor use for easy and fast data collection on various technologies. Android RF is ideal for field engineers who perform daily tasks such as site verification and commissioning, troubleshooting, and optimization. Android QA: Combines the functionality of Android RF with MOS quality testing algorithms such as SQUAD, and P.863 (POLQA). Android QA is a mobile network quality assessment tool that has been designed to allow customers to easily evaluate the quality of services, such as voice calls and video streaming, while providing the RF parameters and application layer information that are crucial to troubleshooting.
Service Tests
QualiPoc Android includes the following test functionality: CALL: Uses the Call2anynumber test to set up a speech call connection to a number that automatically responds. Uses the Call MOC test to measure intrusive speech quality (MOS) on speech call connection to a responding station. The answering station job could be used to answer calls for a MOC DL job. DATA: Sets up a PS data connection to an access point name. This functionality includes FTP UL/DL, HTTP Browser, HTTP Transfer GET/PUT, Ping, Email and Capacity DL testing. MESSAGE: Test SMS and MMS functionality Multi-Data, Multi-Mix, Multi-RAB, and Parallel: Execute data and call tests sequential or parallel. Idle Monitoring: Allows you to monitor RF parameters during normal use of the phone.
Device Support
QualiPoc Android is available for several smartphone and tablet models that run on Android OS. For a complete list of the supported devices, see the Release Notes QualiPoc Android.pdf document.
Post-Processing Software
SwissQual offers the following NetQual products for the post-processing of QualiPoc measurement files: NetQual NQView: PC application that replays tests from measurement files. NetQual NQDI: PC-based post-processing tool with in-depth data analysis, mapping, and reporting functionalities
QualiPoc Monitors
QualiPoc provides you with the ability to control and to monitor the tests on your QualiPoc Android smartphone. By default, the QualiPoc Android workspace contains several technology, mapping, and result monitors. However, you can also customize and save personal workspaces.
4 CONFIDENTIAL MATERIALS
Table 1-1 Description of the monitors that are available in QualiPoc Android
Monitor
Status
Description
Includes general information about the operator, technology, GPS, and general test results statistics. Provides test execution information. Displays the main serving cell information based on the actual technology. Provides details on HSDP and HSUPA data technology information. This monitor is only available for WCDMA technology. Provides details on GPRS or EDGE data technology information. This monitor is only available for GSM technology. Provides details on LTE data technology information. This monitor is only available for LTE technology. Provides an overview of serving and neighbour cells status and coverage. The content of this monitor depends on the main technology that the mobile phone is connected to. Displays serving and neighbour cell coverage. The content of this monitor depends on the main technology that the mobile phone is connected to. Displays the summary of the on-going tests including KPI bar chart. Displays a list of signalling layer 3 headers including the option to decode each l3 message Displays the HTTP, FTP, TCP, DNS and ICMP messages that have been captured including the option to decide the messages. Displays a list of voice and data call related events as well as Wi-Fi scanning results. Displays the current position, route and BTS information on a map based on Google maps or open street map. Displays a floor plan for indoor marking navigation.
GPRS/EDGE
LTE DL/LTE UL
Cells
Coverage line-chart
Test Layer3
IP
Events
Map
Indoor
QualiPoc Android arrives pre-installed on a supported smartphone. SwissQual has modified the firmware and the Android operating system to enable the full feature set of the QualiPoc application. The first start is also part of the delivery. However, you need a valid licence key to use QualiPoc, which you can obtain from SwissQual Support. Important: Ensure that you read the Release Notes QualiPoc Android.pdf document before you use QualiPoc Android and also before you update the software.
GPS Configuration
QualiPoc Android can use the internal GPS of the smartphone or an external Bluetooth GPS to log the current location and display this location on the outdoor mapping monitor. Important: You need to enable the internal GPS on the phone to use GPS capability in QualiPoc. You can pair Bluetooth GPS device with the phone and then select the device in the Map settings. In this case you can disable the internal GPS to save battery power. Otherwise you can use the internal GPS as a backup location provider in the event that the Bluetooth GPS disconnects or has insufficient coverage.
QualiPoc Settings
To access the QualiPoc settings, press Menu . You can also touch the up arrow and then touch Settings on the toolbar. at the bottom of the screen and touch Settings
You can use the menus on your smartphone to easily configure QualiPoc Android.
Map Settings
The Map settings page allows you to configure the settings for indoor and outdoor maps. Map Engine: Select the map source, that is, Google Maps or Open Street Maps Map Mode (Google Maps only): Enables satellite mode. Online Mode (Open Street Map only): Enables online or offline mode for Open Street Maps. BTS monitor: Displays BTS information on the map monitor.
Note: You need to load a BTS list for this feature to work. GPS Device: Select the internal GPS or an external Bluetooth GPS device Indoor Map: Select the image file in JPEG or PNG format to use as a floor plan for indoor navigation Show signal information: Show value label by each indoor marker
BTS Information
The BTS Information page allows you to activate the BTS information display and to select your GSM, WCDMA or LTE BTS lists. You can copy the file to any location on the SD card of the phone.
Layer 3
The Layer 3 page lists the available Layer 3 filtering options, which you can enable to filter out the layer3 headers, for example, by group or by subgroup.
IP Monitor
The IP Monitor page allows you to selectively filter out messages that belong to the HTTP, FTP, DNS, and ICMP protocols.
Customization
The customization page allows you to customize the QualiPoc workspace to display your preferred monitors as well as create and save different custom workspace configurations. You can then load different workspaces for different monitoring tasks. To customize your workspace, press Menu the page, select one of the following actions: Add: Adds a new monitor Remove: Deletes the monitor that you select. Move left: Moves the monitor one position to the left. Move right: Moves the monitor one position to the right. and touch Settings > Customization, and at the bottom of
The Workspace editor provides you with an overview of the monitors in the current workspace. To save a custom workspace, press Menu To load a custom workspace, press Menu workspace. and touch Save workspace. and touch Load workspace, and then select a
Notification
You can configure notifications based on layer3 messages or on display values. A standard Android notification informs you about a new QualiPoc notification. You can also use a custom sound or vibration for each QualiPoc notification. To view the event history of the notification, touch the occurrence of the notification in the list.
Technology Forcing
On the Forcing page you can select the technology and bands that you want to force the phone to use.
To enable forcing
1. Press Menu , touch Settings, and then touch Forcing. 2. Touch Technology Forcing. 3. Touch Select Network Type, and then touch a network technology in the list, for example, WCDMA + GSM. Note: The list of available frequency bands for the technology depends on the capabilities of the device.
Unit Configuration
On the Unit configuration page you can specify the unit name, the connection parameters to the media server, and the structure of the results folder. The unit name is useful for identifying the measurement files of a particular phone during post processing. If you manually upload measurement files from a phone to the media server, that is, with the Results command on the main menu, the unit name is also used for the folder on the media server that contains the file. You can configure the folder structure as flat, for example, 2011-12-10_Custom HD or as a hierarchy, for example, 2011-12-10/Custom HD/. You can use the following types of information for the folder names: Date (for example, 2011-12-10 System (always QualiPoc) Device Task/Job (Task or job name)
10
11
You can create and configure a measurement job in QualiPoc directly on your smartphone, save the job locally, and run the job immediately. This section describes the types of measurement jobs that you can create and run in QualiPoc.
For speech quality tests, you can use the SQUAD08 or POLQA (P.863) algorithm.
12
Important: You need a valid QualiPoc Android license for the algorithm that you want to use.
these tests. Host address: IP address of the host server File: Name of the remote file that you want to transfer Credentials: Login information for the HTTP server Advanced settings: Specify advanced timeouts and test options Number of cycles: Number of times to repeat a single test before the job ends
14
URL: HTTP address of the site that you want to browse Advanced Settings: Specify advanced timeouts and test options Number of cycles: Number of times to repeat a single test before the job ends
15
16
Multi-Data: Sequence of data tests in which all the tests occur in one session Multi-Mix: Sequence of data and call tests in which a new session starts for each test Multi-RAB: Parallel execution of a call and a multidata test Parallel: Parallel execution of up to 3 parallel jobs independent from each other (one call job and multiple single or multi-data jobs).
Advanced Settings
You can also specify the following advanced parameters for each job. Timings and scheduling: Time and date on which to start the job, the number of repetitions for the job, and the related timings, for example, duration of the job, pause between the tests, and so on Test: Settings that are related to the job Access Point: Network access point for the job Pcap: Include the PCAP information to the measurement file
17
Using QualiPoc
This chapter describes how to use QualiPoc to create, to run, and to control your tests. QualiPoc makes full use of the smartphone touch functionalities so you can easily switch between the monitors, zoom in or out in the map monitors, and scroll easily. The application also has a toolbar, which you can use to access a variety of functions.
Main Toolbar
You can access the QualiPoc toolbar with the arrow at the bottom of the page.
The toolbar allows you to quickly perform the following actions when you monitor a test.
Table 5-1 Description of the icons for executing tests
Icon
Description
Idle Monitoring: Starts recording the information from the active tests in an MF file.
Freezing: Freezes the monitors until you touch the icon again.
Screen Capture: Captures the screen and saves the image to the SD card in PNG format.
Photo Marker: Captures a photograph with the phone camera and saves the photograph on the SD card in the QualiPoc/Results folder. If you are in recording or testing mode, the photo marker is added to the MF file. Settings: Opens the QualiPoc settings page for the monitor that you currently have open.
18
2. Touch Select job type, touch a job group, and then touch a job type. 3. Touch and specify the settings for the job. 4. Touch Start Job.
3. On the Select Job Type page, touch the type of job that you want to create, for example HTTP Browser. Note: For a description of the job types, see the "Measurement Job Types" chapter on page 12.
19
5. Press Menu
, touch Save job, type a name for the job in the Save job box, and then touch Save.
Note: QualiPoc stores the new job in in the following location: [sdcard]/QualiPoc/Jobs/
monitoring. In both cases, the default QualiPoc monitors displays network information, RF values, and test results whenever these values are available.
3. On the Select Job Type page, touch the type job that you want to create. 4. In the list of jobs, touch the job that you want to run. Note: QualiPoc loads a job from the following location on the phone: [sdcard]/QualiPoc/Jobs/ 5. Press the Back key and touch Start Job.
Viewing Results
The Results monitor allows you to compress, to upload, and to delete measurement files and crash dumps. You can also filter the files according to type, that is, the .mf, .crashdump, .sqz, and .crashdump.zip. When you compress a measurement file, the entire contents of the file, that is, audio recording, pcap files, photo markers, screen shots, indoor maps, and tab files, are included in the .sqz compressed file. To access the Results monitor, press Menu , and touch Results.
21
Technology Monitors
The WCDMA, GSM, HSDPA, HSUPA, GPRS/EDGE and LTE monitors automatically display the information that is relevant to the technology in use. For example, when the smartphone performs a GSM to WCDMA handover, the WCDMA monitor automatically replaces the WCDMA monitor.
22
Data Monitor
QualiPoc automatically displays the relevant data technology information in the following monitors when HSDPA, HSUPA, or GPRS/EDGE technologies are in use.
23
Layer 3 Monitors
The layer 3 trace monitor is a list monitor that displays the header information of layer 3 messages. You can disable protocol or message group items in the monitor settings. QualiPoc writes the layer 3 information to the MF independent of the filter settings. You configure QualiPoc to fully decode Layer 3 information in a pop-up window. To close the window, double-tap the window or press the back button.
Map Monitors
This section describes the features of the outdoor and indoor map monitors.
25
Tip: You can use the touch capabilities of the smartphone to zoom in and zoom out of the map.
QualiPoc saves the positions that you mark in the measurement file. You can load these markers in the NQDI post-processing software. If you want, you can load another map during the measurement. When you reload a map, QualiPoc also reloads the previous tracking list.
27
28
QualiPoc creates and stores Measurement Files (MF) on the smartphone. You can replay and analyse the contents of these files on the smartphone with the QualiPoc replay function or on your computer with SwissQual software.
Important: You cannot replay an *.sqz file. You can use the remaining controls to perform the following actions: Return to previous session Advance to next session Pause the playback Step through or fast forward through the replay
While the phone is in this mode, "Replay" appears in a blue bar at the top of the screen.
30
31