AZQ Android User’s guide V 1.0 Prepared 11/1/2013
Image by By swissscan, used under Creative commons license http://www.flickr.com/photos/7578081@N07/2308034084/
1
The ABC of AZQ Simple steps for using AZQ Android 1. Pre-Test checklist
2. Choose & Run script
3. Upload Log to server
4. Troubleshooting, Dos & Don’t
2
Pre-Test checklist Making sure it’s ready to run 1. Check your APN settings
2. Are you collecting 2G or 3G only logs?
3. Is your SD card properly plugged in?
4. Checking system clock
3
Checking your APN
1. Click on “All apps”
4
Checking your APN
2. Scroll down to “Settings”
5
Checking your APN
3. Choose “Wireless & networks”
6
Checking your APN
4. Choose “Mobile networks”
7
Checking your APN
5. Choose “Access Point Names”
8
Checking your APN
6. Choose The correct APN (Usually internet or www)
9
2G or 3G only logs?
1. Click on “All apps”
10
2G or 3G only logs?
2. Scroll down to “Settings”
11
2G or 3G only logs?
3. Choose “Wireless & networks”
12
2G or 3G only logs?
4. Choose “Mobile networks”
13
2G or 3G only logs?
5. Choose “Network Mode”
14
2G or 3G only logs? Achtung : The network settings will not change after testing Or restarting, please make sure the setting fits your test req.
6. Choose preferred Network Mode “WCDMA Only” = 3G Only “GSM Only” = 2G Only “GSM/WCDMA auto” = Automatic
15
Is your SD card ready?
1. Click on “All apps”
16
Is your SD card ready?
2. Scroll down to “Settings”
17
Is your SD card ready?
3. Scroll down to “Storage”
18
Is your SD card ready? Achtung : If total space is zero, please check your SD card Slot to ensure that the SD card is properly inserted. Acthung : Removing the SD card for external use is not recommended
4. Verify that there is “Total space” Under “SD card”
19
Checking system clock
1.
If the clock isn’t adjusted correctly please go to Date & Time
2.
Select (Use Network Time) or configure the clock manually 20
2.Choose & Run script Now you are ready to test! 1. Selecting the right script
2. Entering Job ID
3. Open & mark indoors walk test (if needed)
21
You are ready to Test! Opening AZQ, Choosing script, Running script
1. Click on AZENQOS in the application menu
22
You are ready to Test! Opening AZQ, Choosing script, Running script
2. Click Start Script
23
You are ready to Test! Opening AZQ, Choosing script, Running script
3. Choose from a list of default scripts 2 Min Call : Call 9810066667 for 2 Min 30 Min Call : Call 9810066667 for 30 Min FTP - UL - 500 KB : Upload 500 KB file to 223.224.40.124 FTP – DL - 1 MB : Download 1MB file from 223.224.40.124 Achtung : If you are using Non-Airtel sim, please call another 24 number
You are ready to Test! Opening AZQ, Choosing script, Running script
3. Enter your Job ID then OK Achtung : Please Enter Job ID and tags in English, 25
Now you are testing! Opening AZQ, Choosing script, Running script
4. Notice the script will start 5. Notice the GPS icon will stop blinking once GPS location is fixed 26
Now you are testing! 1 2 3
1. Script Status : Current state of the test
2. Events : Event Timeline 3. Event Counter : Event Counter Achtung! : You can navigate by swiping the panels left 27 and right
Now you are testing! 1 2 3
1. SYS : Current System info
2. GSM : Live GSM Parameter display (Ex. Rxlvl,RxQual) 3. 2G Cells : Live Neighboring Cell Display 28
Now you are testing! 1 2
1. WCDMA : Live WCDMA Parameter Display
2. GSM : Live Neighboring scrambling code display
29
Now you are testing! 1 2
1. Bearers : Live WCDMA Bearer display
2. Indoor : Load indoor map for indoor marking
30
Now you are testing!
1 3
2 4
1. Load Map: Load an indoor map for testing 2. Add Point : Add a new indoor mark 3. Add Point with tag : Add a new indoor mark with explanatory tag 4. Del Point : Delete indoor marking 31
Now you are testing!
1. Choosing Load Map will bring you this screen 2. Choose the gallery where the image is stored
32
Now you are testing!
1. Choose the floor plan you wish to walk test 2. The floor plan will appear in the application
Achtung : If the image file is too large, the phone might run out of memory, in that case please restart the test
33
3.Upload Log to server Finishing the job 1. Stopping script
2. Closing the job ticket
3. Uploading the log
34
Testing Done!
1.
Press the physical back button
35
Testing Done!
1. 2. 3. 4.
Confirm Tag/Job ID Yes will save the log and exit testing No will stop testing without saving the log Cancel will bring you back to the testing screen
36
Testing Done!
1. Yes will open WAP page login to confirm job 2. No will bring you back to the main menu Achtung : Confirming job completion will not upload the log, Please upload it later from the main menu 37
Upload log to server!
1. On the main menu, you will see the a counter for pending log 2. Choose upload logs 38
Upload log to server!
1. All will upload all log 2. The log name will be identified by test completion time 39
Troubleshootings 1. Don’t update firmware or conduct factory reset! It will stop AZQ from functioning!
2. Avoid installing non-job related applications, especially messaging apps and games
3. If the phone can’t be switched on, charge it for 2 hours before switching on again
4. Avoid going to the lock screen during testing, if you do, please drag to unlock
40
What keeps AZQ from running 1. SD card not inserted properly
2. SD card space lower than
3. Phone has been factory reset/firmware updated Software number must be 1.43.720.2 (Go to settings -> About Phone -> Software Number)
4. Battery level lower than 5%
5. Copying the APK into other phones
41
What can cause test failures 1. Installing too many unrelated apps
2. Opening too large indoors image (Recommended size <1 MB)
3. Testing more than 24 hours will cause AZQ to save log and restart 4. Other internal failures (Phone has been switched on too long, too many tests have been done in one instance). In this case the phone will restart automatically
Achtung : In case of test failures from crash, the log recovery will start with the next test instance and you will see an Increase in pending log upload count 42
Advanced Testing
1. 2. 3. 4. 5. 6. 7.
Start Script : Start a script in manual mode Network Monitor : Starts netmon in manual mode New Script : Creates new script for testing Open Script : Open and edit a script Settings : Enable automatic/Schedule test Upload Logs : Manually upload log to server 43 Check For Update : Manually check for new version
Creating Script
1 2
3 1. Click on New Script in the main menu 2. You will be greeted with the Create Script Screen 3. Press the “Option” hardware button to bring up the script editor menu 44
Creating Script
1
2 4
3 5
1. Add : Add statement into the script 2. Remove : You can remove a statement by highlighting it and click remove 3. Edit : You can edit a statement by highlighting it and click remove 4. Up/Down : You can move a statement up or down by highlighting it and click up or down 5. Save & Exit : Name your script then exit to the 45 main menu
Creating Script 1 2
1. Click on “Add” to bring up the Script Menu 2. Click on a statement to add it into the script
46
Script : Loop 1
1. Loop Count : How many times a script will repeat itself Achtung! : Statements must be put inside a loop in order to complete it, please refer to the next 47 page for loop creation
Script : Loop
Fig1. Wrong
Fig2. Right
1. As shown in Fig1. Voice Dial isn’t put inside the loop and will not call 2. To put a statement into a loop, select the desired statement then click “up” 3. As shown in Fig2. the Voice dial statement is now in the loop correctly and will repeat for 1,000 times 48
Script : Wait
1. Wait Time : Waiting time in seconds before executing the next statement
49
Script : Answer
1. Incoming Number: Specify the number for the phone to pick up 2. Duration : The duration of the call after picking up 3. Wait time : The time the phone will wait for a call to come in before moving to the next statement 50
Script : Voice Dial
1. Tel Number: Specify the number for the phone to call 2. Duration : The duration of the call after call establishment 3. Matching : specify whether the call will be paired on the server 4. Answer Timeout : The duration the phone will wait for the receiver to pick up 5. Setup Timeout : The duration he phone will wait for the call to ring on the receiver side 51
Script : FTP Load
1. File Name : Specify the file to download (1MB,5MB,10MB,50MB,100MB,1GB) Achtung! Please use capital letter for specifying the files 2. Username,IP,Password : Username,IP and password of the FTP server 3. Number of sessions: The number of Download sessions (Maximum 5) 4. Timeout : Specify the time before the FTP download is considered as failed 5. Inactivity timeout : Specify the period of no data activity before the download is considered as fail 52
Script : FTP Upload
1. File Name : Specify the file size to upload Achtung! Please use lower case letter to specify the file size 2. Username,IP,Password : Username,IP and password of the FTP server 3. Number of sessions: The number of Download sessions (Maximum 5) 4. Timeout : Specify the time before the FTP upload is considered as failed 5. Inactivity timeout : Specify the period of no data activity before the FTP upwnload is considered as failed 53
Script : HTTP Load
1. URL : Specify the Website or the URL file to download 2. Number of sessions: The number of Download sessions (Maximum 5) 3. Timeout : Specify the time before the FTP download is considered as failed 4. Inactivity timeout : Specify the period of no data activity before the download is considered as fail
54
Script : Browse
1. URL : Specify the Website or the URL to browse 2. Timeout : Specify the time before the Briwse test is considered as failed 3. Number of sessions: The number of Browse test sessions (Maximum 3)
55
Script : SMS
1. PhoneNumber : Specify the SMS receiver number 2. Message : SMS message content 3. deliveredTimeout : Specify the time period the application will wait for the delivery report to arrive before considering the test a failure 4. sentTimeout : Specify the time period the application will wait for the sms to be sent
56
New script : Example
1. Pressing the physical option button on the phone will bring up the menu 2. Press Add
57
New script : Example
1. Once the script menu is brought up, choose Loop
58
New script : Example
1. Input the number of desired test loops, then press save
59
New script : Example
1. A Loop [1000] Dialog box will appear
60
New script : Example
1. Next choose Option -> Add -> Voice Dial and input the desired number, Call duration and Call setup Timeout
61
New script : Example
1. A “Voice Dial” Dialog will appear under Loop [1000] 2. Put it into the loop by selecting the Voice Dial line, Press the physical Option button, then Up 3. Voice Dial script will now indented into the loop 62
New script : Example
1. Repeat the above steps until there are Voice call, Wait, FTP Load (10MB) and Wait into the loop 2. Press Save and name the script “default”
63
New script : Example
1. Repeat the above steps until there are Voice call, Wait, FTP Load (10MB) and Wait into the loop 2. Press Save and name the script “default”
64
65