MT6573 YuSu Wi-Fi Driver Customer Document [0.4 ed.]

Citation preview

LY M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

Wi-Fi Driver Customer Document

Version: Release date:

1.0 2011-04-22

© 2008 - 2011 MediaTek Inc. This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

FO

Specifications are subject to change without notice.

LY

MT6573 Confidential B

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

Document Revision History

Revision

Date

Author

Description Initial Draft

2010-12-15

CP Wu

0.2

2011-2-25

Kevin Huang

Add Wi-Fi tethering

0.3

2011-4-15

Kevin Huang

Add Wi-Fi Direct Driver Setting

0.4

2011-4-21

Chinglan Wang

FO

0.1

MediaTek Confidential

Add WPS Customization

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 2 of 20

LY

MT6573 Confidential B

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

Table of Contents

Document Revision History .................................................................................................................. 2 Table of Contents................................................................................................................................... 3 1

Introduction................................................................................................................................... 4 1.1 1.2

2

Environment.................................................................................................................................. 7 2.1 2.2 2.3

3

Architecture........................................................................................................................... 8 Procedure & Flow ................................................................................................................. 9 Design of Setting UI............................................................................................................ 10 3.3.1 WPS Setting UI .................................................................................................. 10 3.3.2 Hotspot Setting UI .............................................................................................. 11 3.3.3 Wi-Fi Direct Driver Setting UI ............................................................................. 12

Customization............................................................................................................................. 14 4.1 4.2 4.3 4.4

5

Software Environment .......................................................................................................... 7 Hardware Environment......................................................................................................... 7 Hardware Component used in this driver ............................................................................. 7

Design............................................................................................................................................ 8 3.1 3.2 3.3

4

Functionality.......................................................................................................................... 4 Terminology .......................................................................................................................... 5

WAPI................................................................................................................................... 14 WPS.................................................................................................................................... 14 Wi-Fi Tethering ................................................................................................................... 17 Wi-Fi Direct Setting............................................................................................................. 17

Build............................................................................................................................................. 20 5.1 5.2

Source Code Structure & File Description.......................................................................... 20 Build Option ........................................................................................................................ 20

Lists of Tables and Figures 找不到圖表目錄。

FO

找不到圖表目錄。

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 3 of 20

Introduction

1.1

Functionality

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

1

LY

MT6573 Confidential B

The driver is used to provide Wi-Fi connectivity. The driver’s main functionality is: (1) Turn on/off Legacy Wi-Fi, 802.11b/g/n certificated

1. 2. 3. 4.

Support Scanning Support OPEN / WEP / WPA / WPAPSK / WPA2 / WPA2PSK (cipher suite) Support WAPI Support WPS 2.0/1.0

FO

(2) Turn on/off Wi-Fi Tethering (Hotspot Support) 1. Support OPEN / WPA2PSK

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 4 of 20

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

LY

MT6573 Confidential B

(3) To invoke Wi-Fi Direct connectivity (Need Wi-Fi Direct Application)

1.2

Terminology

FO

Wi-Fi WPS

WSC

http://en.wikipedia.org/wiki/Wi-Fi Wi-Fi Protected Setup (Name of Certificate), http://en.wikipedia.org/wiki/Wi-Fi_Protected_Setup Certification – we need implement protocol compliant to WSC specification 2.0 Wi-Fi Simple Configuration (Name of specification)

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 5 of 20

LY

MT6573 Confidential B

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

WAPI Wireless Authentication Privacy Infrastructure, http://zh.wikipedia.org/wiki/WAPI WPA Wi-Fi Protected Access http://en.wikipedia.org/wiki/Wi-Fi_Protected_Access TM Wi-Fi Direct http://en.wikipedia.org/wiki/Wi-Fi_Direct

1.3

Reference

FO

Wi-Fi White Paper Wi-Fi Glossary

MediaTek Confidential

http://www.wi-fi.org/knowledge_center_overview.php?type=1 http://www.wi-fi.org/knowledge_center_overview.php?type=3

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 6 of 20

Environment

2.1

Software Environment

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

2

LY

MT6573 Confidential B

Driver discussed in this document is designed based on Linux Kernel 2.6.32 and Android 2.3.

2.2

Hardware Environment

Driver discussed in this document can run on the devices with MT6516 and MT6573 with MT6620 Connectivity Solution as Wi-Fi solution. SDIO bus is used to communicate between AP processor and MT6620. MT6620 Wi-Fi acts as a standard SDIO device and MT6620 Wi-Fi driver take use of SD bus driver to issue CMD52 / CMD53 read/write access commands for communicate with MT6620.

2.3

Hardware Component used in this driver

FO

Only MT6620 was supported.

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 7 of 20

Design

3.1

Architecture

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

3

LY

MT6573 Confidential B

FO

Library: libhardware_legacy is invoked by Android application framework to control over MT6620 WiFi controller. Driver: /sys/class/rfkill/rfkill1/state used to power on/off Wi-Fi controllers.

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 8 of 20

Applications

Legacy Wi-Fi / WPS /WAPI Connection Utility

Wi-Fi Direct Connection Utility

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

Applications with Wi-Fi Direct Support

LY

MT6573 Confidential B

Application Framework

Wi-Fi P2P Manager

Legacy Wi-Fi / WPS Manager

WAPI Manager

Legacy Wi-Fi HAL

WAPI HAL

JNI

Hardware Abstraction Layer

Wi-Fi Direct HAL P2P_CTRL

Standalone Applications

DHCPD

DHCPCD

Linux Kernel

P2P Supplicant and Hostapd

Wi-Fi Direct Net Device

WPA_CTRL

WPA Supplicant

WAPI_CTRL

WAPI Supplicant

Legacy Wi-Fi Net Device

MT6620 Host Driver

MT6620 Firmware

3.2

Procedure & Flow

FO

Describe the procedure & flow of this driver. A figure such as sequence diagram is suggested.

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 9 of 20

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

LY

MT6573 Confidential B

3.3

Design of Setting UI

3.3.1

WPS Setting UI

3.3.1.1

Configure WPS PBC Network

The procedure to connect a WPS enabled AP via PBC method

3.3.1.2

Configure WPS PIN Network

FO

The procedure to connect a WPS enabled AP via PIN method

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 10 of 20

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

LY

MT6573 Confidential B

3.3.2

Hotspot Setting UI

FO

The hotspot setting UI is native Google hotspot setting UI as shown in following

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 11 of 20

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

User can input SSID and select the Security Level for Open or WPA2PSK to create a hotspot

LY

MT6573 Confidential B

If user enable 3G and hotspot network, the title bar will shows two icons,

3.3.3

Wi-Fi Direct Driver Setting UI

User can configure its Wi-Fi Direct Device Name which will be shown in another Wi-Fi Direct Device when it performing a P2P SCAN.

FO

Default name is “Wireless Client”

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 12 of 20

FO

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

LY

MT6573 Confidential B

MediaTek Confidential

© 2011 MediaTek Inc.

This document contains information that is proprietary to MediaTek Inc. Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.

Page 13 of 20

Customization

M R ED yu IA .li@ T E tin K C no O mo NF bil ID e.c EN om T I US AL EO N

4

LY

MT6573 Confidential B

Describe each customization item in the section. Take accelerometer as an example:

4.1

WAPI

User can enable WAPI feature by modifying

alps/mediatek/config//ProjectConfig.mk as MTK_WAPI_SUPPORT = yes

Defining MTK_WAPI_SUPPORT = no then WAPI support is turned off.

4.2

WPS

User can enable WPS support feature by modifying

alps/mediatek/config//system.prop as ro.mediatek.wlan.wsc = 1

if disable WPS support, the setting UI will looks as below

NO WPS PIN

NO WPS PIN

NO WPS PIN

NO WPS icon

FO

User can modify the following value for WPS 2.0 Feature – Manufacturer –

The Manufacturer component is an ASCII string (