QTI Miracast WFA Certification Guide

80-NF516-1 Rev. C
February 10, 2014

Submit technical questions at:

https://support.cdmatech.com

Confidential and Proprietary – Qualcomm Atheros, Inc.

NO PUBLIC DISCLOSURE PERMITTED: Please report postings of this document on public servers or websites to:
DocCtrlAgent@qualcomm.com.
Restricted Distribution: Not to be distributed to anyone who is not an employee of either Qualcomm or its subsidiaries without
the express approval of Qualcomm’s Configuration Management.
Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any manner to others without the
express written permission of Qualcomm Atheros, Inc.
Qualcomm is a trademark of QUALCOMM Incorporated. Atheros is a registered trademark of Qualcomm Atheros, Inc. All other
registered and unregistered trademarks are the property of QUALCOMM Incorporated, Qualcomm Atheros, Inc., or their
respective owners and used with permission. Registered marks owned by QUALCOMM Incorporated and Qualcomm Atheros,
Inc. are registered in the United States and may be registered in other countries.
This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to
U.S. and international law is strictly prohibited.

Qualcomm Atheros, Inc.

1700 Technology Drive
San Jose, CA 95110
U.S.A.

© 2013-2014 Qualcomm Atheros, Inc.

 Revision history

Revision Date Description

A February 2013 Initial release
B Mar 2013 Updated Section 2.1
C February 2014 Changes to Section 2.1

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 2
Confidential and Proprietary – Qualcomm Atheros, Inc.
 Contents

1 Introduction...................................................................................................... 5
1.1 Purpose.......................................................................................................................... 5
1.2 Scope............................................................................................................................. 5
1.3 Conventions .................................................................................................................. 5
1.4 References..................................................................................................................... 5
1.5 Technical Assistance..................................................................................................... 5
1.6 Acronyms ...................................................................................................................... 5

2 QTI Miracast WFA Certification ...................................................................... 6

2.1 Starting sigma/WTE ..................................................................................................... 6
2.2 Test configuration ......................................................................................................... 7
2.3 General suggestions ...................................................................................................... 8

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 3
Confidential and Proprietary – Qualcomm Atheros, Inc.
0BQTI Miracast WFA Certification Guide Contents

Tables
Table 1-1 Reference documents and standards ............................................................................................ 5

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 4
Confidential and Proprietary – Qualcomm Atheros, Inc.
 1 Introduction

1.1 Purpose
This document describes Miracast WFA certification details specific to Qualcomm Technologies,
Inc. (QTI) chipsets.

1.2 Scope
This document is intended for engineers who are currently using or are planning to use QTI Wi-Fi
chipsets for WFA certification testing.
QTI may not provide in-house/internal tools or equipment listed in this document to customers.

1.3 Conventions
Function declarations, function names, type declarations, and code samples appear in a different
font, e.g., #include.

1.4 References
Reference documents are listed in Table 1-1. Reference documents that are no longer applicable
are deleted from this table; therefore, reference numbers may not be sequential.

Table 1-1 Reference documents and standards

Ref. Document

Qualcomm Technologies
Q1 Application Note: Software Glossary for Customers CL93-V3077-1

1.5 Technical Assistance

For assistance or clarification on information in this document, submit a case to Qualcomm
Technologies, Inc. (QTI) at https://support.cdmatech.com/.
If you do not have access to the CDMATech Support Service website, register for access or send
email to support.cdmatech@qti.qualcomm.com.

1.6 Acronyms
For definitions of terms and abbreviations, see [Q1].

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 5
Confidential and Proprietary – Qualcomm Atheros, Inc.
 2 QTI Miracast WFA Certification

The sigma tool is referred to as a Control Agent in most WFA documents. The Control Agent
sigma tool runs on the Device Under Test (DUT). It accepts commands from the UCC (command
generator) over socket (it listens to commands on port 9000, but it is configurable through
optional parameter –p). It then executes the command on the DUT and returns relevant error
codes to the UCC.

2.1 Starting sigma/WTE

Obtain the Miracast-specific sigma_dut binary from Qualcomm®.
To run Sigma:
1. Turn off WiFi from the GUI and reboot the DUT.
2. Push the Sigma binary to /system/bin/, and change its permissions to make it executable by
running the following command from adb shell. On command line window 1:
adb root
adb remount
adb push sigma_dut /system/bin/
adb shell
chmod 777 /system/bin/sigma_dut
3. Give the following command and make sure that wlan is not running:
lsmod
4. Bring up the WLAN driver from CLI:
insmod /system/lib/modules/pronto/pronto_wlan.ko
5. To make sure that wlan is running, g ive the following command:
lsmod
6. Start wpa_supplicant, but use the following command:
cd /data/misc/wifi/
wpa_supplicant -ip2p0 -Dnl80211 -c /data/misc/wifi/p2p_supplicant.conf -N -iwlan0 -
Dnl80211 -c /data/misc/wifi/wpa_supplicant.conf -dddd -e /data/misc/wifi/entropy.bin -
puse_p2p_group_interface=1 &
7. Give the following command on DUT to make sure that wpa_supplicant is running:
ps

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 6
Confidential and Proprietary – Qualcomm Atheros, Inc.
0BQTI Miracast WFA Certification Guide QTI Miracast WFA Certification

8. Start wpa_cli for logging purposes.

wpa_cli -i p2p0 -p /data/misc/wifi/sockets
(you will get an interactive prompt ">")
9. To receive commands from the UCC, the DUT must be on the same network as the UCC and
other testbed devices. Since the DUT does not have a LAN port, adb port forwarding is used
on the controller PC. On command line window 2:
C:\ adb forward tcp:9000 tcp:9000
10. Run SIGMA/WTE from command line window 2 as:
adb shell
For Android versions 2.2 and before:
 root@android:/ # sigma_dut -t source
For Android versions later than 4.2:
 sigma_dut –Sp2p0 –w/data/misc/wifi/sockets/ -t source
11. On command line window 3:
adb shell
ps
(Make sure that sigma_dut is running.)
12. Run the tests from the Sigma console.

2.2 Test configuration

Make these changes in the initialization files before running the UCC scripts and test cases.
1. Locate the files at \Sigma_UCC-Windows_v7_0_0 \Sigma_UCC-Windows_v7_0_0\cmds\
Sigma-WFD.
2. DUTInfo.txt

Sigma_ControlAgent_Support!1! (it can be changed to 0 for test cases which

need to be run manually)
info!Connecting to DUT Control Agent!
# DUT Control Agent
wfa_control_agent_dut!ipaddr=127.0.0.1,port=9000! //See this change

#Wireless IP of DUT
dut_wireless_ip!127.0.0.1!

3. Init_WFD.txt

# DUT Control Agent

wfa_control_agent_dut!ipaddr=127.0.0.1,port=9000! //The IP needs to be
changed to localhost IP if the UCC is being run from the same machine to
which DUT is connected (via adb).

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 7
Confidential and Proprietary – Qualcomm Atheros, Inc.
0BQTI Miracast WFA Certification Guide QTI Miracast WFA Certification

#Wireless IP of DUT
dut_wireless_ip!127.0.0.1!

######### PC Endpoint (WFA Traffic generator console) #####

info!Connecting to PC Endpoint!

//Following can be commented out if they are not being used while testing
# Control IP Address for Console
#wfa_console_ctrl!ipaddr=192.168.250.250,port=9003!

# Traffic generator IP Address for Console

#wfa_console_tg!192.165.100.250!

Disable all Testbed Source/Sinks that are not used during a particular test.

2.3 General suggestions

General suggestions are:
 Before running any test case, kill the DHCP server/client process.
 DHCP server process – /system/bin/dnsmasq
 DHCP client process – dhcpcpd
 Clean the folder /data/misc/dhcp/* before executing any test case.
 A test case may not run successfully in the first run due to the malfunction of sniffer/testbed
devices. We advise rerunning the test case with the above suggestions. Common errors
include TestBed device not assigning IP to the DUT or vice versa.
 Sometimes you see Sniffer capture failures; in that case we recommend using a nontestbed
sniffer such as Wireshark or Omnipeak.

80-NF516-1 Rev. C MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 8
Confidential and Proprietary – Qualcomm Atheros, Inc.