Iwpriv Usage
Iwpriv Usage
Iwpriv Usage
Before reading this document, make sure you already read README. -----------------------------------------------------------------------------------------------------USAGE: iwpriv ra0 commands val NOTE: Wireless Extension Private Handlers where [commands] ----------------wsc_conf_mode [val] {range} ------------------------------------------------{0, 1, 2} ::Set WPS conf mode 0: WPS Disabled 1: Enrollee 2: Registrar {1, 2} ::PIN or PBC 1: PIN 2: PBC wsc_pin wsc_ssid wsc_start o WPS process wsc_stop wsc_gen_pincode wsc_cred_count wsc_cred_ssid NULL ::Generate new PIN code {1 ~ 8} ::Set count of WPS credential {"idx ssid_str"} ::Set SSID into credtentail[idx] idx: 0 ~ 7 ssid_str: 0~z, 1~32 ascii charac ters wsc_cred_auth idx] idx: 0 ~ 7 auth_str: OPEN, WPAPSK, WPA2PSK, SHARED, WPA, WPA2 {"idx auth_str"} ::Set AuthMode into credtentail[ NULL ::Stop WPS process {00000000 ~ 99999999} ::Set Enrollee's PIN Code {0~z, 1~32 ascii characters} ::Set WPS AP SSID NULL ::Trigger RT2860 STA driver to d
wsc_mode
wsc_cred_encr l[idx]
{"idx encr_str"} ::Set EncrypType into credtentai idx: 0 ~ 7 encr_str: NONE, WEP, TKIP, AES
wsc_cred_keyIdx [idx]
wsc_cred_key
{"idx key"} ::Set Key into credtentail[idx] idx: 0 ~ 7 key: ASCII string (wep_key_len(=
5,13), passphrase_len(=8~63)) OR Hex string (wep_key_len (=10,26), passphrase_len(=64)) wsc_cred_mac idx] idx: 0 ~ 7 mac_str: xx:xx:xx:xx:xx:xx wsc_conn_by_idx wsc_auto_conn AP or not after registration. 0: Disabled, driver won't re-con nect to AP with new configurations. 1: Enabled, driver will re-conne ct to AP with new configurations. wsc_ap_band dual band WPS AP 0 : prefer 2.4G 1 : prefer 5G 2 : auto Default value is auto (2) -----------------------------------------------------------------------------------------------------USAGE: iwpriv ra0 set [parameters]=[val] NOTE: Execute one iwpriv/set command simultaneously. where [parameters] ----------------CountryRegion [val] {range} ------------------------------------------------{0~7} ::Set country region {0, 1, 2} ::Set prefer band to do WPS with {0 ~ 7} ::Connect AP by credential index {0, 1} ::Set driver to re-connecting to {"idx mac_str"} ::Set AP's MAC into credtentail[
::Set country region for A band 0: 36, 40, 44, 48, 52, 56, 60, 64, 149, 153, 157, 161, 165 ch 1: 36, 40, 44, 48, 52, 56, 60, 6 4, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140 ch 2: 36, 40, 44, 48, 52, 56, 60, 6 4 ch 3: 52, 56, 60, 64, 149, 153, 157 , 161 ch 4: 149, 153, 157, 161, 165 ch 5: 149, 153, 157, 161 ch 6: 36, 40, 44, 48 ch 7: 36, 40, 44, 48, 52, 56, 60, 6 4, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 149, 153, 157, 161, 16 5 ch 8: 52, 56, 60, 64 ch 9: 36, 40, 44, 48, 52, 56, 60, 6 4, 100, 104, 108, 112, 116, 132, 136, 140, 149, 153, 157, 161, 165 ch 10: 36, 40, 44, 48, 149, 153, 157, 16 1, 165 ch 11: 36, 40, 44, 48, 52, 56, 60, 64, 1 00, 104, 108, 112, 116, 120, 149, 153, 157, 161 ch SSID WirelessMode {0~z, 1~32 ascii characters} ::Set AP SSID {0~10} ::Set Wireless Mode 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 Channel BGProtection depends on CountryRegion or CountryRegionForABand ::Set Channel {0~2}
::Set 11B/11G Protection 0:Auto, 1:Always on, 2:Always off TxPreamble {0~2} ::Set TxPreamble 0:Preamble Long, 1:Preamble Short, 2:Auto RTSThreshold {1~2347} ::Set RTS Threshold FragThreshold {256~2346} ::Set Fragment Threshold TxBurst {0,1} ::Set TxBurst Enable or Disable 0:Disable, 1:Enable NetworkType {Infra,Adhoc} ::Set Network type
{OPEN,SHARED,WEPAUTO,WPAPSK,WPA2PSK,WPANONE} ::Set Authentication Mode {NONE,WEP,TKIP,AES} ::Set Encryption Type {1~4} ::Set Default Key ID
Key1
{5 ascii characters or 10 hex number or 13 ascii characters or 26 hex numbers} ::Set Key1 String
Key2
{5 ascii characters or 10 hex number or 13 ascii characters or 26 hex numbers} ::Set Key2 String
Key3
{5 ascii characters or 10 hex number or 13 ascii characters or 26 hex numbers} ::Set Key3 String
Key4
{5 ascii characters or 10 hex number or 13 ascii characters or 26 hex numbers} ::Set Key4 String
WPAPSK WmmCapable
{8~63 ascii or 64 hex characters} ::WPA Pre-Shared Key {0,1} ::Set WMM Capable 0:Disable WMM, 1:Enable WMM
PSMode HtBw
{CAM, MAX_PSP, FAST_PSP} ::Set Power Saving Mode {0,1} ::Set BandWidth 0: 20Hz 1: 40Hz
HtMcs
{0 ~ 15, 33} ::Set MCS 33: Auto Rate {0,1} ::Set Guard Interval(GI) 0: long GI 1: short GI
HtGi
HtOpMode
HtExtcha nouncement
{0 ~ 7} ::Set The Minimum Time Between M {1 ~ 64} ::Set BA WinSize {0,1} ::Set RDG Capable 0: Disabled 1: Enabled
HtAmsdu
HtAutoBa
{0,1}
::Set Auto BA Capable 0: Disabled 1: Enabled HtBaDecline {0,1} ::Reject BA request from AP 0: Disabled 1: Enabled HtProtect {0,1} ::Set HT Protect Capable 0: Disabled 1: Enabled FixedTxMode ate setting Mode = CCK MCS = 0 = 1 = 2 bps = 3 ps Mode = OFDM MCS = 0 = 1 = 2 s = 3 s = 4 s = 5 s = 6 s = 7 s ==> Build Ethernet Convert function. Please set 'HAS_ETH_CONVERT_SUPPORT=y' in o s/linux/config.mk EthConvertMode {dongle, clone, hybrid} ::Set Ethernet Convert Mode EthCloneMac LongRetry ShortRetry MeshId MeshHostName {xx:xx:xx:xx:xx:xx} :: Set Clone MAC {0,255} :: Set Tx Long Retry Limit {0,255} :: Set Tx Short Retry Limit {Length 1~32 ascii characters} :: Set Mesh ID {Length 1~32 ascii characters} :: Set Mesh Host Name => 54Mbp => 48Mbp => 36Mbp => 24Mbp => 18Mbp => 6Mbps => 9Mbps => 12Mbp => 11 Mb => 1Mbps => 2Mbps => 5.5 M {CCK, OFDM} :: Set Fixed Tx Mode for fixed r
MeshAutoLink
{xx:xx:xx:xx:xx:xx} :: Add Mesh Link {xx:xx:xx:xx:xx:xx} :: Delete Mesh Link {20 ~ 65535 seconds} :: Set AgeOut time for Mesh Mult {OPEN, WPANONE} :: Set Mesh Authentication Mode {NONE, WEP, TKIP, AES} :: Set Mesh Encryption Type {1 ~ 4} :: Set Mesh Default Key ID {5 ascii characters or 10 hex number or 13 ascii characters or 26 hex numbers} :: Set Mesh WEP Key String {8~63 ascii or 64 hex characters} :: Set Mesh WPA Pre-Shared Key
MeshWPAKEY
Examples =================================================================== -----------------------------------------------------------------------------------------------------a> 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" b> Config STA to link 1. iwpriv ra0 2. iwpriv ra0 3. iwpriv ra0 4. iwpriv ra0 5. iwpriv ra0 6. iwpriv ra0 c> Config STA to link 1. iwpriv ra0 2. iwpriv ra0 3. iwpriv ra0 4. iwpriv ra0 5. iwpriv ra0 6. iwpriv ra0 with AP which is SHARED/WEP(Authentication/Encryption) set NetworkType=Infra set AuthMode=SHARED set EncrypType=WEP set DefaultKeyID=1 set Key1="AP's wep key" set SSID="AP's SSID" with AP which is WPAPSK/TKIP(Authentication/Encryption) set NetworkType=Infra set AuthMode=WPAPSK set EncrypType=TKIP set SSID="AP's SSID" set WPAPSK="AP's wpa-preshared key" set SSID="AP's SSID"
d> Config STA to link with AP which is WPAPSK/AES(Authentication/Encryption) 1. iwpriv ra0 set NetworkType=Infra 2. iwpriv ra0 set AuthMode=WPAPSK
3. 4. 5. 6.
e> Config STA to link 1. iwpriv ra0 2. iwpriv ra0 3. iwpriv ra0 4. iwpriv ra0 5. iwpriv ra0 6. iwpriv ra0
with AP which is WPA2PSK/TKIP(Authentication/Encryption) set NetworkType=Infra set AuthMode=WPA2PSK set EncrypType=TKIP set SSID="AP's SSID" set WPAPSK=12345678 set SSID="AP's SSID"
f> Config STA to create/link as adhoc mode, which is OPEN/NONE(Authentication/En cryption) 1. iwpriv ra0 set NetworkType=Adhoc 2. iwpriv ra0 set AuthMode=OPEN 3. iwpriv ra0 set EncrypType=NONE 4. iwpriv ra0 set SSID="Adhoc's SSID" g> Config STA to n/Encryption) 1. iwpriv ra0 2. iwpriv 3. iwpriv 4. iwpriv 5. iwpriv 6. iwpriv create/link as adhoc mode, which is WPANONE/TKIP(Authenticatio set ra0 ra0 ra0 ra0 ra0 NetworkType=Adhoc set AuthMode=WPANONE set EncrypType=TKIP set SSID="AP's SSID" set WPAPSK=12345678 set SSID="AP's SSID"
h> Get site survey usage: iwpriv ra0 get_site_survey i> Get Statistics usage: iwpriv ra0 stat tatistic counter iwpriv ra0 set ResetCounter=0 c counter j> Link with an AP which is the largest strength usage: iwconfig ra0 essid "" or usage: iwpriv ra0 set SSID="" ; read s ; reset statisti ; set ANY SSID (ssidLen=0)
k> Config STA to link as dongle mode with STA own MAC usage: iwpriv ra0 set EthConvertMode=dongle l> Config STA to link as clone mode usage: iwpriv ra0 set EthConvertMode=clone iwpriv ra0 set EthCloneMac="Desired MAC" :00:00:00:00 means using STA own MAC
;; 00:00
;; FF:FF:FF:FF:FF:FF means using source MAC of first packet coming from wired de vice m> Config STA to link as hybrid(dongle+clone) mode usage: iwpriv ra0 set EthConvertMode=hybrid iwpriv ra0 set EthCloneMac="Desired MAC" :00:00:00:00 means using STA own MAC
;; 00:00
;; FF:FF:FF:FF:FF:FF means using source MAC of first packet coming from wired de
vice =================================================================== iwlist ================= This is detailed explanation of each parameters for iwlist. -----------------------------------------------------------------------------------------------------iwlist ra0 scanning ; list the results after scanning(manual rescan)
================================================================================ ======================= iwconfig ================= The following are our support in standard configuration - iwconfig -----------------------------------------------------------------------------------------------------iwconfig ra0 essid {NN on off} ; set essid iwconfig ra0 mode {managed ad-hoc ...} ; set wireless mode >> rt2860sta driver support monitor mode with linux kernel > 2.4.20. >> Note: For using monitor mode => if mesh interface is ON, please down the mesh interface first. iwconfig ra0 freq N.NNNN[k M G]] ; set frequency iwconfig ra0 channel N ; set channel iwconfig ra0 ap {N off auto} ; set AP address iwconfig ra0 nick N ; set nickname iwconfig ra0 rate {N auto fixed} ; set rate (only support legacy rate set ting) iwconfig ra0 rts {N auto fixed off} ; set RTS threshold iwconfig ra0 frag {N auto fixed off} ; set Fragment threshold iwconfig ra0 enc {NNNN-NNNN off} ; set encryption type iwconfig ra0 power {period N timeout N} ; set power management modes *** Wireless extension usage please refer to man page of 'iwconfig', 'iwlist' an d 'iwpriv'. ***