Manual WN8020-0L
IC WLAN USB Module
IEEE 802.11b, IEEE 802.11g ,IEEE 802.11n
1 Specification
● Operating voltage: 3.3 V +/- 10%
● Power consumption: < 500 mA Tx (All mode), < 500 mA (11b Rx mode)
● Storage temperature: -55~+150 ℃
● Operation temperature: -10~+85 ℃
● Transmission rate:
IEEE 802.11b: 1,2, 5.5 and 11 Mbps / IEEE 802.11g: 6,9,12,18,24,36,48,54 Mbps
IEEE 802.11n HT 20MHz: 6.50,13.00,19.50,26.00,39.00,52.00,58.50,65.00 Mbps
IEEE 802.11 HT 40MHz: 13.50,27.00,40.50,54.00,81.00,108.0,121.5,135.0 Mbps
● Dimensions:11.6 ±0.2mm(W) x 16.9±0.2 mm(L) x 1.4 mm(H)
FCC Warning statement
This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to
part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful
interference in a residential installation. This equipment generates, uses and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions, may cause harmful interference to
radio communications. However, there is no guarantee that interference will not occur in a particular
installation. If this equipment does cause harmful interference to radio or television reception, which can be
determined by turning the equipment off and on, the user is encouraged to try to correct the interference by
one or more of the following measures:
-Reorient or relocate the receiving antenna.
-Increase the separation between the equipment and receiver.
-Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
-Consult the dealer or an experienced radio/TV technician for help.
You are cautioned that changes or modifications not expressly approved by the party responsible for
compliance could void your authority to operate the equipment.
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
(1) this device may not cause harmful interference and
(2) this device must accept any interference received, including interference that may cause undesired
operation
2 Installation Instructions
When you install the platform, make sure that the USB port of the module is connected to the platform USB i n
order to ensure the normal functioning.
3 CONFIGURATION
RT5370 RT3070 driver can be configured via following interfaces, i.e.
1. configuration file
2. "iwconfig" command
3. "iwpriv" command
Note:
1) modify configuration file "RT2870STA.dat" in /etc/Wireless/RT2870STA/RT2870STA.dat.
2) iwconfig/iwpriv comes with kernel.
3) iwpriv use, please refer to below sections for details.
3.1 Configuration File RT 2870STA.dat
# Copy this file to /etc/Wireless/RT2870STA/RT2870STA.dat
# This file will be read on loading driver module.
#
# Use "vi RT2870STA.dat" to modify settings according to your need.
#
#
#The word of "Default" must not be removed
Default
CountryRegion=5
CountryRegionABand=7
CountryCode=
ChannelGeography=1
SSID=11n-AP
NetworkType=Infra
WirelessMode=5
Channel=0
BeaconPeriod=100
TxPower=100
BGProtection=0
TxPreamble=0
RTSThreshold=2347
FragThreshold=2346
TxBurst=1
PktAggregate=0
WmmCapable=1
AckPolicy=0;0;0;0
AuthMode=OPEN
EncrypType=NONE
WPAPSK=
DefaultKeyID=1
Key1Type=0
Key1Str=
Key2Type=0
Key2Str=
Key3Type=0
Key3Str=
Key4Type=0
Key4Str=
PSMode=CAM
AutoRoaming=0
RoamThreshold=70
APSDCapable=0
APSDAC=0;0;0;0
HT_RDG=1
HT_EXTCHA=0
HT_OpMode=1
HT_MpduDensity=4
HT_BW=1
HT_BADecline=0
HT_AutoBA=1
HT_BADecline=0
HT_AMSDU=0
HT_BAWinSize=64
HT_GI=1
HT_MCS=33
HT_MIMOPSMode=3
HT_DisallowTKIP=1
IEEE80211H=0
TGnWifiTest=0
WirelessEvent=0
CarrierDetect=0
AntDiversity=0
BeaconLostTime=4
FtSupport=1
NOTE:
WMM parameters
WmmCapable Set it as 1 to turn on WMM Qos support
AckPolicy1~4 Ack policy which support normal Ack or no Ack
(AC_BK, AC_BE, AC_VI, AC_VO)
All WMM parameters do not support iwpriv command but ‘WmmCapable’’, please store all
parameter to RT2870STA.dat, and restart driver.
3.2 Configuration file use
Syntax is 'Param'='Value' and describes below.
SectionNumber Param
Value
. . .
. . .
. . .
3.2.1 CountryRegion
Value:
1-11 active scan, 12 and 13 passive scan
1-14 all active scan, 14 b mode only
3.2.2 CountryRegionForABand
Value:
36, 40, 44, 48, 52, 56, 60, 64, 149, 153, 157, 161, 165
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140
36, 40, 44, 48, 52, 56, 60, 64
52, 56, 60, 64, 149, 153, 157, 161
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 149, 153, 157, 161, 165
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 132, 136, 140, 149, 153, 157, 161, 165
36, 40, 44, 48, 149, 153, 157, 161, 165
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 149, 153, 157, 161
3.2.3 SSID
Value:
0~z, 1~32 ascii characters.
3.2.4 WirelessMode
Value:
0: legacy 11b/g mixed
1: legacy 11B only
2: legacy 11A only
3: legacy 11a/b/g mixed
4: legacy 11G only
5: 11ABGN mixed
6: 11N only
7: 11GN mixed
8: 11AN mixed
9: 11BGN mixed
10: 11AGN mixed
11: 11N only in 5G band only
3.2.5 Channel
Value:
Depends on CountryRegion or CountryRegionForABand
3.2.6 HwAntDiv
Value:
0: Disable
1: HW RX antenna diversity
2: Fixed RX at AUX ANT
3: Fixed RX at main ANT
3.2.7 BGProtection
Value:
0: Auto
1: Always on
2: Always off
3.2.8 TxPreamble
Value:
0:Preamble Long
1:Preamble Short
2:Auto
3.2.9 RTSThreshold
Value:
1~2347
3.2.10 FragThreshold
Value:
256~2346
3.2.11 TxBurst
Value:
0: Disable
1: Enable
3.2.12 PktAggregate
Value:
0: Disable
1: Enable
3.2.13 NetworkType
Value:
Infra: infrastructure mode
Adhoc: adhoc mode
3.2.14 AuthMode
Value:
OPEN For open system
SHARED For shared key system
WEPAUTO Auto switch between OPEN and SHARED
WPAPSK For WPA pre-shared key (Infra)
WPA2PSK For WPA2 pre-shared key (Infra)
WPANONE For WPA pre-shared key (Adhoc)
WPA
WPA2
3.2.15 EncrypType
Value:
NONE For AuthMode=OPEN
WEP For AuthMode=OPEN or AuthMode=SHARED
TKIP For AuthMode=WPAPSK or WPA2PSK
AES For AuthMode=WPAPSK or WPA2PSK
3.2.16 DefaultKeyID
Value:
1~4
3.2.17 WEP KeyType
Key1Type=value
Key2Type=value
Key3Type=value
Key4Type=value
Value:
0 hexadecimal type
1 assic type
(use: reading profile only)
3.2.18 WEP Hex Key
Key1=value
Key2=value
Key3=value
Key4=value
Value:
10 or 26 hexadecimal characters eg: 012345678
5 or 13 ascii characters eg: passd
(use: "iwpriv" only)
3.2.19 WEP Key String
Key1Str=value
Key2Str=value
Key3Str=value
Key4Str=value
Value:
10 or 26 characters (key type=0)
5 or 13 characters (key type=1)
(use: reading profile only)
3.2.20 WPAPSK
Value:
8~63 ASCII or
64 HEX characters
3.2.21 WmmCapable
Value:
0: Disable WMM
1: Enable WMM
3.2.22 IEEE80211H
Enabel IEEE802.11h support
Value:
0:Disable
1:Enable
3.2.23 PSMode
Value:
CAM Constantly Awake Mode
Max_PSP Max Power Saving
Fast_PSP Fast Power Saving
Legacy_PSP Legacy Power Saving
3.2.24 FastRoaming
Value:
0: Disabled
1: Enabled
3.2.25 RoamThreshold
Value:
0 ~ 255
3.2.26 TGnWifiTest
Value:
0: Disabled
1: Enabled
3.2.27 WirelessEvent
Value:
0: Disabled
1: Enabled (send custom wireless event)
3.2.28 CarrierDetect
Value:
0: Disabled
1: Enabled
3.2.29 HT_RDG
Value:
0: Disabled
1: Enabled
3.2.30 HT_EXTCHA
Value:
0: Below
1: Above
3.2.31 HT_OpMode
Value:
0: HT mixed format
1: HT greenfield format
(Note) If you want to do TGn WIFI green field item, please set HT_OpMode=1
3.2.32 HT_MpduDensity
Value:
0 ~ 7
3.2.33 HT_BW
Value:
0: 20MHz
1: 40MHz
3.2.34 HT_AutoBA
Value:
0: Disabled
1: Enabled
3.2.35 HT_AMSDU
Value:
0: Disabled
1: Enabled
3.2.36 HT_BAWinS ize
Value:
1 ~ 64
3.2.37 HT_GI
Value:
0: long GI
1: short GI
3.2.38 HT_MCS
Value:
0 ~ 15
33: auto
3.2.39 HT_MIMOPSEnable
Enable/Disable the 802.11n SM power save function.
Value:
0:Disable
1:Enable (Default)
3.2.40 HT_MIMOPSMode
Value:
0: Static SM Power Save Mode
2: Reserved
1: Dynamic SM Power Save Mode
3: SM enabled
(not fully support yet)
3.2.41 HT_DisallowTKIP
Enable/Disable N rate with 11N ap when cipher is WEP or TKIP.
Value:
0: FALSE
1: TRUE
Default setting is disable.
3.2.42 HT_RxStream
Set the number of spatial streams for reception
Value:
1: 1 Rx stream
2: 2 Rx stream
3.2.43 HT_TxStream
Set the number of spatial streams for transimtion
Value:
1: 1 Tx stream
2: 2 Tx stream
3.2.44 HT_LinkAdapt
Enable/Disable HT Link Adaptation Control
Value:
0:Disable (Default)
1:Enable
3.2.45 HT_HTC
Enable/disable HTC field of data frames send with 802.11n data rates
Value:
0:Disable (Default)
1:Enable
3.2.46 HT_DisableReordering
Disable AMPDU re-ordering handling mechanism
Value:
0:Disable (Default)
1:Enable
3.2.47 BeaconLostTime
Change Beacon Lost Time
Value:
1 ~ 60 seconds
Default value is 4 seconds
3.2.48 AutoRoaming
Enable/disable auto roaming mechanism
Value:
0: disable
1: enable
Default setting is disable.
3.2.49 MacAddress
MacAddress=value
Value:
XX:XX:XX:XX:XX:XX
3.2.50 TDLSCapable
Enable/disable TDLS Capable function
Value:
0: disable
1: enable
3.2.51 AutoConnect
Enable/Disable driver connect to ANY AP when SSID is null.
Value:
0: disable (default)
1: enable
3.2.52 HT_40MHZ_INTOLERANT
Set to disable the 40MHz channel bandwidth operation and also indicate other 20/40MHz
BSS Coex awared
Value:
0:Disable (default)
1:Enable
3.2.53 AntGain
Define peak antenna gain (dBi) for Single SKU setting.
Value:
0: Disable Single SKU TxPower Adjustment.
1~255: Enable Single SKU TxPower Adjustment.
3.2.54 BandedgeDelta
Define delta conducted power value which can pass bandeage of FCC certification at Ch1 and
Ch11 (dBm) within HT_40 Bandwidth for Single SKU setting.
Value:
1~255: Delta value between HT_20 and HT_40 power value.
3.2.55 P2P_GOIntent
Relative value between 0 and 15 used to indicate the desire of the P2P device to be the P2P
Group Owner, with a larger value indicating a higher desire.
Value:
0~15: GO Intent.
4 WI R ELESS TOOLS
4.1 Iwpriv ra0 set use
This section describes parameters set using iwpriv. Please refer to the Readme section for more general data.
iwpriv ra0 set [parameters]=[Value]
Note: Execute one iwpriv/set command at a time.
4.1.1 DriverVersion
Check driver version by issue iwpriv set command.
Range:
Any value
Value:
0
Example:
#iwpriv ra0 set DriverVersion=1
4.1.2 CountryRegion
Set country region.
Range:
{0~7}
Value:
1-11 active scan, 12 and 13 passive scan
1-14 all active scan, 14 b mode only
4.1.3 CountryRegionABand
Set country region for A band.
Range:
{0~9}
Value:
36, 40, 44, 48, 52, 56, 60, 64, 149, 153, 157, 161, 165
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140
36, 40, 44, 48, 52, 56, 60, 64
52, 56, 60, 64, 149, 153, 157, 161
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 149, 153, 157, 161, 165
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 132, 136, 140, 149, 153, 157, 161, 165
36, 40, 44, 48, 149, 153, 157, 161, 165
36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 149, 153, 157, 161
4.1.4 SSID
Set AP SSID
Range:
{0~z, 1~32 ascii characters}
Value:
4.1.5 WirelessMode
Set Wireless Mode
Range:
{0~10}
Value:
0: legacy 11b/g mixed
1: legacy 11B only
2: legacy 11A only
3: legacy 11a/b/g mixed
4: legacy 11G only
5: 11ABGN mixed
6: 11N only
7: 11GN mixed
8: 11AN mixed
9: 11BGN mixed
10: 11AGN mixed
11: 11N only in 5G band only
4.1.6 TxBurst:
Set TxBurst Enable or Disable
Range:
{0,1}
Value:
0:Disable,
1:Enable
4.1.7 PktAggregate:
Set Tx Aggregate Enable or Disable
Range:
{0,1}
Value:
0:Disable,
1:Enable
4.1.8 TxPreamble:
Set TxPreamble
Range:
{0~2}
Value:
0:Preamble Long,
1:Preamble Short,
2:Auto
4.1.9 TxPower:
Set Tx power in percentage
Range:
{0~100}
Value:
4.1.10 Channel
Set Channel, depends on CountryRegion or CountryRegionABand
4.1.11 HwAntDiv
Setting H/W Antenna Diversity Diable or Enable
Value:
0: Disable
1: HW RX antenna diversity
2: Fixed RX at AUX ANT
3: Fixed RX at main ANT
4.1.12 BGProtection:
Set 11B/11G Protection
Range:
{0~2}
Value:
0:Auto,
1:Always on,
2:Always off
4.1.13 RTSThreshol d:
Set RTS Threshold
Range:
{1~2347}
Value:
4.1.14 FragThreshold:
Set Fragment Threshold
Range:
{256~2346}
Value:
4.1.15 NetworkType:
Set Network type
Range:
{Infra,Adhoc}
Value:
4.1.16 AuthMode:
Set Authentication Mode
Range:
{OPEN,SHARED,WEPAUTO,WPAPSK,WPA2PSK,WPANONE}
Value:
4.1.17 EncrypType:
Set Encryption Type
Range:
{NONE,WEP,TKIP,AES}
Value:
4.1.18 DefaultKeyID:
Set Default Key ID
Range:
{1~4}
Value:
4.1.19 Key1
Set Key1 String
Range:
{5 ascii characters or 10 hex number or
13 ascii characters or 26 hex numbers}
Value:
4.1.20 Key2
Set Key2 String
Range:
{5 ascii characters or 10 hex number or
13 ascii characters or 26 hex numbers}
Value:
4.1.21 Key3
Set Key3 String
Range:
{5 ascii characters or 10 hex number or
13 ascii characters or 26 hex numbers}
Value:
4.1.22 Key4
Set Key4 String
Range:
{5 ascii characters or 10 hex number or
13 ascii characters or 26 hex numbers}
Value:
4.1.23 WPAPSK
WPA Pre-Shared Key
Range:
{8~63 ascii or 64 hex characters}
Value:
4.1.24 WmmCapable
Set WMM Capable
Range:
{0,1}
Value:
0:Disable WMM,
1:Enable WMM
4.1.25 IEEE80211H
Enabel IEEE802.11h support
Range:
{0,1}
Value:
0:Disable
1:Enable
4.1.26 PSMode
Set Power Saving Mode
Range:
{CAM, MAX_PSP, FAST_PSP}
Value:
4.1.27 ResetCounter
Reset statistics counter
Range:
Any vlaue
Value:
0
4.1.28 Debug
Set on debug level
Range:
{0 ~ 5}
Value:
0: OFF no debug message display
1: ERROR display error message
2: WARN display warning message
3: TRACE display trace message, usually used.
4: INFO display informatic message
5: LOUD display all message
4.1.29 CarrierDetect
Value
0: Disabled
1: Enabled
4.1.30 HtRdg
Enable HT Reverse Direction Grant.
Value:
0: Disabled
1: Enabled
4.1.31 HtExtcha
To locate the 40MHz channel in combination with the control.
Value:
0: Below
1: Above
4.1.32 HtOpMode
Change HT operation mode.
Value:
0: HT mixed format
1: HT greenfield format
4.1.33 HtMpduDens ity
Minimum separation of MPDUs in an A-MPDU.
Value:
0 ~ 7
0: no restriction
1: 1/4 μs
2: 1/2 μs
3: 1 μs
4: 2 μs
5: 4 μs
6: 8 μs
7: 16 μs
4.1.34 HtBw
Support channel width.
Value:
0: 20MHz
1: 40MHz
4.1.35 HtAutoBa
Enable auto block acknowledgment (Block Ack).
Value:
0: Disabled
1: Enabled
4.1.36 HtAmsdu
Enable aggregation of multiple MSDUs in one MPDU.
Value:
0: Disabled
1: Enabled
4.1.37 HtBaWinSize
Set BA WinSize.
Value:
1 ~ 64
4.1.38 HtGi
Support Short/Long GI.
Value:
0: long GI
1: short GI
4.1.39 HtMcs
MCS rate selection.
Value:
0 ~ 15
33: auto
4.1.40 HtProtect
Enable HT protection for legacy device.
Value:
0: Disable
1: Enable
4.1.41 HtMimoPs
MIMO power save.
Value:
0: Disable
1: Enable
4.1.42 FixedTxMode
Set Fixed Tx Mode for fixed rate setting
Value:
Mode = CCK
MCS= 0 => 1Mbps
MCS= 1 => 2Mbps
MCS= 2 => 5.5 Mbps
MCS= 3 => 11 Mbps
Mode = OFDM
MCS= 0 => 6Mbps
MCS= 1 => 9Mbps
MCS= 2 => 12Mbps
MCS= 3 => 18Mbps
MCS= 4 => 24Mbps
MCS= 5 => 36Mbps
MCS= 6 => 48Mbps
MCS= 7 => 54Mbps
4.1.43 LongRetry
USE:
iwpriv ra0 set LongRetry=value
Value:
0~255
4.1.44 ShortRetry
USE:
iwpriv ra0 set ShortRetry=value
Value:
0~255
4.1.45 HtTxStream=value
Value:
1: Support 1-Tx Stream for MCS0 ~ MCS7
2: Support 2-Tx Stream for MCS0 ~ MCS15
4.1.46 HtRxStream=value
Value:
1: Support 1-Rx Stream for MCS0 ~ MCS7
2: Support 2-Rx Stream for MCS0 ~ MCS15
4.1.47 HtDisallowTKIP =value
Enable/Disable N rate with 11N ap when cipher is WEP or TKIP.
Value:
0: FALSE
1: TRUE
Default setting is disable.
4.1.48 HtBaDecline
Reject all Recipient’s BA requests.
Value:
0: Disable (Default)
1: Enable
4.1.49 BeaconLostTime=value
Change Beacon Lost Time
Value:
1 ~ 60 seconds
Default value is 4 seconds
4.1.50 AutoRoaming=value
Enable/disable auto roaming mechanism
Value:
0: disable
1: enable
Default setting is disable.
4.1.51 SiteSurvey =value
Scan with specific SSID after link up
Value:
0~z, 1~32 ascii characters
4.1.52 TdlsCapable =value
Enable/disable TDLS capable
Value:
0: disable
1: enable
Example: iwpriv ra0 set TdlsCapable=0
4.1.53 TdlsSetup=value
Manually add TDLS link
Value: MAC address
Example: iwpriv ra0 set TdlsSetup=00:11:22:33:44:55
4.1.54 AutoReconnect=value
Description: Enable/Disable driver auto reconnect functionality
Valid Range: 0-1
Default Value: 1
0: Disable, 1: Enable
4.1.55 AdhocN=value
Description: Enable/Disable Adhoc to support N or not
Valid Range: 0-1
Default Value: 1
0: Disable, 1: Enable
4.1.56 AntGain
Define peak antenna gain (dBi) for Single SKU setting.
Value:
0: Disable Single SKU TxPower Adjustment.
1~255: Enable Single SKU TxPower Adjustment.
4.2 Iwpriv ra0 show use
This section describes parameters set using iwpriv. Please refer to the Readme section for more general data.
A detailed explanation of each parameter for iwpriv is shown subsequently. Refer to the Readme before using
this section.
iwpriv ra0 show [parameters]
4.2.1 connStatus
Show STA connection Status
4.2.2 driverVer
Show STA current driver version
4.2.3 bainfo
Show STA current BA information
4.2.4 rxbulk
Show STA current rxbluk information
4.2.5 txbulk
Show STA current txbluk information
4.2.6 AutoReconnect
Show bAutoReconnect flag
4.2.7 WPAPSK
Show WPA Passphrase
4.2.8 PMK
Show PMK key
4.3 Iwpriv ra0 use
This section describes parameters set using iwpriv. Please refer to the Readme section for more general data.
iwpriv ra0 show [parameters]
4.3.1 radio_off
Turn STA radio off
4.3.2 radio_on
Turn STA radio on
4.4 Iwpriv Examples
4.4.1 Infrastructure
4.4.1.1 OPEN/NONE
Config STA to link with AP which is OPEN/NONE(Authentication/Encryption)
1. iwpriv ra0 set NetworkType=Infra
2. iwpriv ra0 set AuthMode=OPEN
3. iwpriv ra0 set EncrypType=NONE
4. iwpriv ra0 set SSID="AP's SSID"
4.4.1.2 SHARED/WEP
Config STA to link with AP which is SHARED/WEP(Authentication/Encryption)
1. iwpriv ra0 set NetworkType=Infra