MTK Wi-Fi SoftAP Software Programming Guide
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
This document contains information that is proprietary to MediaTek Inc.
Specifications are subject to change without notice.
© 2008 - 2012 MediaTek Inc.
Release date:
2012-12-11
Version:
1.2
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
1.0
1.1
1.2
Initial Version
MTXXXX
Chip Name
Internal Use
Author
Description
Revision
Date
2012/11/08
2012/11/13
2012/12/11
Pan Liu
Pan Liu
Pan Liu
Update iwpriv command
Add NoForwardingMBCast
Document Revision History
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
This document contains information that is proprietary to MediaTek Inc.
MediaTek Confidential
© 2012 MediaTek Inc.
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
Page 2 of 148
MTXXXX
Chip Name
Internal Use
Table of Contents
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
Document Revision History .................................................................................................................. 2
Table of Contents .................................................................................................................................. 3
1
Introduction ................................................................................................................................ 12
2 Wi-Fi SoftAP driver Profile Default Setting ............................................................................. 13
2.1 WLAN Profile Description .................................................................................................. 15
2.1.1
CountryRegion ................................................................................................... 15
2.1.2
CountryRegionForABand ................................................................................... 15
2.1.3
CountryCode ...................................................................................................... 16
2.1.4
ChannelGeography ............................................................................................ 16
2.1.5
SSID ................................................................................................................... 17
2.1.6
WirelessMode .................................................................................................... 17
2.1.7
Channel .............................................................................................................. 17
2.1.8
BasicRate........................................................................................................... 17
2.1.9
BeaconPeriod .................................................................................................... 18
2.1.10
DtimPeriod ......................................................................................................... 18
2.1.11
TxPower ............................................................................................................. 18
2.1.12
DisableOLBC ..................................................................................................... 18
2.1.13
BGProtection ..................................................................................................... 19
2.1.14
TxAntenna.......................................................................................................... 19
2.1.15
RxAntenna ......................................................................................................... 19
2.1.16
TxPreamble........................................................................................................ 19
2.1.17
RTSThreshold .................................................................................................... 20
2.1.18
FragThreshold ................................................................................................... 20
2.1.19
TxBurst ............................................................................................................... 20
2.1.20
PktAggregate ..................................................................................................... 20
2.1.21 WmmCapable .................................................................................................... 20
APSDCapable .................................................................................................... 21
2.1.22
2.1.23
DLSCapable ...................................................................................................... 21
APAifsn .............................................................................................................. 21
2.1.24
APCwmin ........................................................................................................... 21
2.1.25
APCwmax .......................................................................................................... 21
2.1.26
2.1.27
APTxop .............................................................................................................. 22
APACM .............................................................................................................. 22
2.1.28
BSSAifsn ............................................................................................................ 22
2.1.29
2.1.30
BSSCwmin ......................................................................................................... 22
BSSCwmax ........................................................................................................ 23
2.1.31
BSSTxop ............................................................................................................ 23
2.1.32
BSSACM ............................................................................................................ 23
2.1.33
2.1.34
AckPolicy ........................................................................................................... 23
NoForwarding .................................................................................................... 24
2.1.35
2.1.36
NoForwardingBTNBSSID .................................................................................. 24
Page 3 of 148
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
MediaTek Confidential
© 2012 MediaTek Inc.
This document contains information that is proprietary to MediaTek Inc.
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
MTXXXX
Chip Name
Internal Use
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
NoForwardingMBCast ....................................................................................... 24
2.1.37
HideSSID ........................................................................................................... 24
2.1.38
StationKeepAlive ............................................................................................... 24
2.1.39
ShortSlot ............................................................................................................ 25
2.1.40
AutoChannelSelect ............................................................................................ 25
2.1.41
IEEE8021X ........................................................................................................ 25
2.1.42
IEEE80211H ...................................................................................................... 25
2.1.43
2.1.44
CSPeriod............................................................................................................ 26
2.1.45 WirelessEvent .................................................................................................... 26
IdsEnable ........................................................................................................... 26
2.1.46
AuthFloodThreshold .......................................................................................... 26
2.1.47
2.1.48
ReassocReqFloodThreshold ............................................................................. 26
ProbeReqFloodThreshold=32 ........................................................................... 27
2.1.49
DisassocFloodThreshold ................................................................................... 27
2.1.50
2.1.51
DeauthFloodThreshold ...................................................................................... 27
EapReqFooldThreshold ..................................................................................... 27
2.1.52
PreAuth .............................................................................................................. 27
2.1.53
AuthMode........................................................................................................... 28
2.1.54
2.1.55
EncrypType ........................................................................................................ 28
RekeyInterval ..................................................................................................... 28
2.1.56
RekeyMethod ..................................................................................................... 28
2.1.57
2.1.58
PMKCachePeriod .............................................................................................. 29
2.1.59 WPAPSK............................................................................................................ 29
DefaultKeyID ...................................................................................................... 29
2.1.60
Key1Type ........................................................................................................... 29
2.1.61
2.1.62
Key1Str .............................................................................................................. 29
Key2Type ........................................................................................................... 30
2.1.63
Key2Str .............................................................................................................. 30
2.1.64
2.1.65
Key3Type ........................................................................................................... 30
Key3Str .............................................................................................................. 30
2.1.66
Key4Type ........................................................................................................... 30
2.1.67
Key4Str .............................................................................................................. 31
2.1.68
2.1.69
AccessPolicy0 .................................................................................................... 31
AccessControlList0 ............................................................................................ 31
2.1.70
AccessPolicy1 .................................................................................................... 31
2.1.71
2.1.72
AccessControlList1 ............................................................................................ 31
AccessPolicy2 .................................................................................................... 32
2.1.73
AccessControlList2 ............................................................................................ 32
2.1.74
2.1.75
AccessPolicy3 .................................................................................................... 32
2.1.76
AccessControlList3 ............................................................................................ 32
2.1.77 WdsEnable......................................................................................................... 33
2.1.78 WdsEncrypType ................................................................................................ 33
2.1.79 WdsList .............................................................................................................. 34
2.1.80 WdsKey .............................................................................................................. 34
2.1.81
RADIUS_Server ................................................................................................. 34
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
This document contains information that is proprietary to MediaTek Inc.
MediaTek Confidential
© 2012 MediaTek Inc.
Page 4 of 148
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
MTXXXX
Chip Name
Internal Use
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
RADIUS_Port ..................................................................................................... 34
2.1.82
RADIUS_Key ..................................................................................................... 34
2.1.83
own_ip_addr ...................................................................................................... 35
2.1.84
EAPifname ......................................................................................................... 35
2.1.85
PreAuthifname ................................................................................................... 35
2.1.86
HT_HTC ............................................................................................................. 35
2.1.87
HT_RDG ............................................................................................................ 36
2.1.88
HT_EXTCHA...................................................................................................... 36
2.1.89
HT_LinkAdapt .................................................................................................... 36
2.1.90
HT_OpMode ...................................................................................................... 36
2.1.91
HT_MpduDensity ............................................................................................... 36
2.1.92
HT_BW .............................................................................................................. 37
2.1.93
HT_BADecline ................................................................................................... 37
2.1.94
HT_AutoBA ........................................................................................................ 37
2.1.95
HT_AMSDU ....................................................................................................... 37
2.1.96
HT_BAWinSize .................................................................................................. 38
2.1.97
HT_GI ................................................................................................................ 38
2.1.98
2.1.99
HT_MCS ............................................................................................................ 38
2.1.100 HT_MIMOPSMode ............................................................................................ 38
2.1.101 HT_DisallowTKIP ............................................................................................... 38
2.1.102 HT_STBC........................................................................................................... 39
2.1.103 WscManufacturer ............................................................................................... 39
2.1.104 WscModelName ................................................................................................ 39
2.1.105 WscDeviceName ............................................................................................... 39
2.1.106 WscModelNumber ............................................................................................. 39
2.1.107 WscSerialNumber .............................................................................................. 40
2.1.108 Wsc4digitPinCode ............................................................................................. 40
3 Wi-Fi SoftAP driver iwpriv command....................................................................................... 41
Debug ................................................................................................................ 41
3.1.1
DriverVersion ..................................................................................................... 41
3.1.2
CountryRegion ................................................................................................... 41
3.1.3
CountryRegionABand ........................................................................................ 42
3.1.4
CountryCode ...................................................................................................... 42
3.1.5
AccessPolicy ...................................................................................................... 42
3.1.6
ResetCounter ..................................................................................................... 43
3.1.7
RadioOn ............................................................................................................. 43
3.1.8
SiteSurvey.......................................................................................................... 43
3.1.9
CountryString ..................................................................................................... 43
3.1.10
SSID ................................................................................................................... 45
3.1.11
3.1.12 WirelessMode .................................................................................................... 45
3.1.13
FixedTxMode ..................................................................................................... 46
3.1.14 OFDMBasicRate ................................................................................................ 46
3.1.15
Channel .............................................................................................................. 46
BeaconPeriod .................................................................................................... 47
3.1.16
3.1.17
DtimPeriod ......................................................................................................... 47
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
This document contains information that is proprietary to MediaTek Inc.
MediaTek Confidential
© 2012 MediaTek Inc.
Page 5 of 148
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
MTXXXX
Chip Name
Internal Use
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
TxPower ............................................................................................................. 47
3.1.18
BGProtection ..................................................................................................... 47
3.1.19
DisableOLBC ..................................................................................................... 48
3.1.20
TxPreamble........................................................................................................ 48
3.1.21
RTSThreshold .................................................................................................... 48
3.1.22
FragThreshold ................................................................................................... 48
3.1.23
TxBurst ............................................................................................................... 48
3.1.24
PktAggregate ..................................................................................................... 49
3.1.25
NoForwarding .................................................................................................... 49
3.1.26
NoForwardingBTNBSSID .................................................................................. 49
3.1.27
NoForwardingMBCast ....................................................................................... 49
3.1.28
HideSSID ........................................................................................................... 49
3.1.29
ShortSlot ............................................................................................................ 50
3.1.30
DisConnectSta ................................................................................................... 50
3.1.31
DisConnectAllSta ............................................................................................... 50
3.1.32
3.1.33 McastPhyMode .................................................................................................. 50
3.1.34 McastMcs ........................................................................................................... 50
3.1.35 WscVendorPinCode .......................................................................................... 51
3.1.36
ACLAddEntry ..................................................................................................... 51
ACLClearAll ....................................................................................................... 51
3.1.37
3.1.38
FixedTxMode ..................................................................................................... 51
3.1.39 WpaMixPairCipher ............................................................................................. 51
3.1.40 MaxStaNum ....................................................................................................... 52
AutoFallBack ...................................................................................................... 52
3.1.41
3.1.42
ApCliTxMode ..................................................................................................... 52
3.1.43
ApCliTxMcs ........................................................................................................ 52
3.1.44 GreenAP ............................................................................................................ 53
3.1.45
AutoChannelSel ................................................................................................. 53
3.1.46 MBSSWirelessMode .......................................................................................... 53
HwAntDiv ........................................................................................................... 54
3.1.47
HtBw .................................................................................................................. 54
3.1.48
HtMcs ................................................................................................................. 54
3.1.49
3.1.50
HtGi .................................................................................................................... 55
HtOpMode.......................................................................................................... 55
3.1.51
HtStbc ................................................................................................................ 55
3.1.52
3.1.53
HtExtcha ............................................................................................................ 55
HtMpduDensity .................................................................................................. 56
3.1.54
HtBaWinSize ...................................................................................................... 56
3.1.55
HtRdg ................................................................................................................. 56
3.1.56
3.1.57
HtAmsdu ............................................................................................................ 56
HtAutoBa............................................................................................................ 56
3.1.58
HtBaDecline ....................................................................................................... 57
3.1.59
3.1.60
HtProtect ............................................................................................................ 57
HtMimoPs .......................................................................................................... 57
3.1.61
3.1.62
HtDisallowTKIP .................................................................................................. 57
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
This document contains information that is proprietary to MediaTek Inc.
MediaTek Confidential
© 2012 MediaTek Inc.
Page 6 of 148
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
4
MTXXXX
Chip Name
Internal Use
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
3.1.63
HtBssCoex ......................................................................................................... 58
3.1.64
PktAggregate ..................................................................................................... 58
3.1.65 WmmCapable .................................................................................................... 58
IEEE80211H ...................................................................................................... 58
3.1.66
3.1.67
AuthMode........................................................................................................... 58
EncrypType ........................................................................................................ 59
3.1.68
DefaultKeyID ...................................................................................................... 59
3.1.69
Key1 ................................................................................................................... 59
3.1.70
3.1.71
Key2 ................................................................................................................... 59
Key3 ................................................................................................................... 60
3.1.72
3.1.73
Key4 ................................................................................................................... 60
3.1.74 WPAPSK............................................................................................................ 60
ResetCounter ..................................................................................................... 60
3.1.75
iwpriv ra0 usage ......................................................................................................................... 61
4.1 get_site_survey .................................................................................................................. 61
4.2 get_mac_table .................................................................................................................... 61
4.3 get_wsc_profile .................................................................................................................. 61
4.4 get_ba_table ...................................................................................................................... 61
4.5
stat...................................................................................................................................... 61
4.6 bbp (Debug only) ................................................................................................................ 62
4.7 mac (Debug only) ............................................................................................................... 62
4.8
rf (Debug only) ................................................................................................................... 62
4.9 e2p (Debug only) ................................................................................................................ 62
5
iwpriv ra0 show command ........................................................................................................ 64
6 WPS Wi-Fi PROTECTED SETUP ............................................................................................... 65
6.1 WPS Profile settings .......................................................................................................... 65
WscConfMode ................................................................................................... 65
WscConfStatus .................................................................................................. 66
WscConfMethods .............................................................................................. 66
WscKeyASCII .................................................................................................... 66
WscSecurityMode .............................................................................................. 66
WscDefaultSSID0 .............................................................................................. 67
WscV2Support ................................................................................................... 67
6.2 WPS iwpriv command ........................................................................................................ 67
WscConfMode ................................................................................................... 67
6.2.1
WscConfStatus .................................................................................................. 67
6.2.2
WscMode ........................................................................................................... 68
6.2.3
WscStatus .......................................................................................................... 68
6.2.4
WscPinCode ...................................................................................................... 69
6.2.5
WscOOB ............................................................................................................ 69
6.2.6
WscGetConf....................................................................................................... 69
6.2.7
WscGenPinCode ............................................................................................... 69
6.2.8
6.2.9
WscVendorPinCode .......................................................................................... 70
6.2.10 WscSecurityMode .............................................................................................. 70
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.1.6
6.1.7
MediaTek Confidential
© 2012 MediaTek Inc.
Page 7 of 148
This document contains information that is proprietary to MediaTek Inc.
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT
8
9
MTXXXX
Chip Name
Internal Use
6.3.1
6.3.2
6.3.3
6.3.4
6.3.5
FOR victorlin@ synnex.com.tw USE ONLY
MEDIATEK CONFIDENTIAL
6.2.11 WscMultiByteCheck ........................................................................................... 70
6.2.12 WscVersion ........................................................................................................ 70
6.2.13 WscVersion2 ...................................................................................................... 70
6.2.14 WscV2Support ................................................................................................... 71
6.2.15 WscFragment .................................................................................................... 71
6.2.16 WscFragmentSize ............................................................................................. 71
6.2.17 WscSetupLock ................................................................................................... 71
6.2.18 WscExtraTlvTag ................................................................................................ 71
6.2.19 WscExtraTlvType ............................................................................................... 72
6.2.20 WscExtraTlvData ............................................................................................... 72
6.2.21 WPS iwpriv command example ......................................................................... 72
6.3 WPS AP Setup Procedure ................................................................................................. 73
Running the WPS command-line application .................................................... 73
Initial AP setup with Registrar Configuring AP (EAP/UPnP) ............................. 74
Adding an Enrollee to AP+Registrar (EAP) ....................................................... 75
Adding an Enrollee with Eternal Registrar (UPnP/EAP) .................................... 76
WPS Config status ............................................................................................. 76
6.4 Basic operation of Ralink WPS AP .................................................................................... 77
Configure APUT using PIN method through a WLAN external Registrar ......... 77
Configure APUT using PIN method through a wired external registrar ............. 77
Add devices using external Registrars .............................................................. 82
How to know WPS AP services as Internal Registrar, Enrollee or Proxy ......... 82
How to know WPS AP PinCode ........................................................................ 83
Notes for WPS ................................................................................................... 83
Compile flag for WPS AP ................................................................................... 83
WPS related Document ..................................................................................... 83
6.5 UPNP Daemon HOWTO .................................................................................................... 83
Build WPS UPnP Daemon ................................................................................. 83
6.6 WPS Command & OID Example ....................................................................................... 84
Iwpriv command without argument .................................................................... 84
7 WMM PARAMETERS ................................................................................................................. 86
7.1 Setting Parameters ............................................................................................................ 86
7.2 How to Run WMM test ....................................................................................................... 86
7.3 WMM “The Ack” ................................................................................................................. 87
7.4 Access Precedence and Outgoing Frame Classification ................................................... 88
IEEE802.11h+d ........................................................................................................................... 90
IEEE802.11d ...................................................................................................................... 90
8.1
8.2
IEEE802.11h ...................................................................................................................... 90
SECURITY POLICY .................................................................................................................... 92
9.1 All possible combinations of security policy ....................................................................... 92
9.2 WP2 Setting ....................................................................................................................... 92
9.3 Examples ........................................................................................................................... 92
OPEN/NONE ..................................................................................................... 92
SHARED/WEP ................................................................................................... 93
6.4.1
6.4.2
6.4.3
6.4.4
6.4.5
6.4.6
6.4.7
6.4.8
Unauthorized reproduction or disclosure of this information in whole or in part is strictly prohibited.
This document contains information that is proprietary to MediaTek Inc.
MediaTek Confidential
© 2012 MediaTek Inc.
Page 8 of 148
6.5.1
6.6.1
9.3.1
9.3.2
loginid=victorlin@synnex.com.tw,time=2012-12-19 12:19:28,ip=111.248.173.94,doctitle=MTK_Wi-Fi_SoftAP_Software_Programming_Guide_v1.2.pdf,company=Synnex Electronics HK Limited 聯強電子_RLT