wireless iwpriv

iwpriv
=================
This is detailed explanation of each parameters for iwpriv.
Before reading this document, make sure you already read README.

-------------------------------------------------------------------------------------------------------
USAGE_1:
	iwpriv rausb0 set [parameters]=[val]
	
NOTE:
	Execute one iwpriv/set command simultaneously.
	

DESCRIPTION
[parameters]        	[val] /{range}
-----------------   	-------------------------------------------------
CountryRegion       	{0~7}
						::Set country region                                   	
						0: 1 ~ 11 ch
						1: 1 ~ 13 ch
						2: 10, 11 ch
						3: 10 ~ 13 ch
						4: 14 ch
						5: 1 ~ 14 ch
						6: 3 ~ 9 ch
						7: 5 ~ 13 ch
											
CountryRegionABand		{0~10}
						::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, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140 ch
						2: 36, 40, 44, 48, 52, 56, 60, 64 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, 64, 100, 104, 108, 112, 116, 120, 124, 128, 132, 136, 140, 149, 153, 157, 161, 165 ch
						8: 52, 56, 60, 64 ch
						9: 34, 38, 42, 46 ch
						10: 34, 36, 38, 40, 42, 44, 46, 48, 52, 56, 60, 64 ch
                        
SSID                	{0~z, 1~32 ascii characters} 			
                    	::Set AP SSID
                    	
WirelessMode        	{0~4}
						::Set Wireless Mode								 
                    	0:11b/g mixed, 
                    	1:11B only, 
                    	2:11A only
                    	3:11a/b/g mixed, 
                    	4:11G only	
                    	
TxRate              	{0~12}
						::Set TxRate of Infrastructure mode			   					 
                    	0:Auto, 	1:1Mbps, 
                    	2:2Mbps, 	3:5.5Mbps, 	
                    	4:11Mbps, 	5:6Mbps, 	
                    	6:9Mbps, 	7:12Mbps, 	
                    	8:18Mbps, 	9:24Mbps, 	
                    	10:36Mbps, 	11:48Mbps, 	
                    	12:54Mbps
 	                 
Channel             	depends on CountryRegion or CountryRegionABand
                        ::Set Channel
                    	
BGProtection        	{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

AdhocOfdm				{0~3}									
                        ::Set Adhoc Wireless Mode
    				    0: WIFI mode(11b rates only),   				   
        				1: b/g mixed,
        				2: 11g only,
        				3: 11a only
    					 									                                                                                                                                                        	                                                          
AuthMode            	{OPEN,SHARED,WEPAUTO,WPAPSK,WPA2PSK,WPANONE}
                        ::Set Authentication Mode 	

EncrypType          	{NONE,WEP,TKIP,AES}          			
						::Set Encryption Type
						 
DefaultKeyID        	{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              	{8~63 ascii or 64 hex characters} 		 
						::WPA Pre-Shared Key

PSMode					{CAM, MAX_PSP, FAST_PSP}				
                        ::Set Power Saving Mode

IEEE80211H              {0,1}
                        ::Set IEEE80211H  Enable or Disable 
                        0:	Disable
                        1:	Enable spectrum management
                        (This field can be enable only in A band)
	                    
       
-------------------------------------------------------------------------------------------------------
USAGE_2:
	iwpriv rausb0 [parameters] [val]

	
DESCRIPTION
[parameters]        	[val] range                             explaination
-----------------   	-----------------------              ------------------------------------------
auth                    {1~5}   1:OPEN                          Authentication Mode
                                2:SHARED
                                3:WPAPSK
                                4:WPA2PSK
                                5:WPANONE
                     
enc                     {1~4}   1:NONE                          Encryption Type
                                2:WEP
                                3:TKIP
                                4:AES

wpapsk                  {8~64 chars}                            WPAPSK/WPA2PSK Password    

psm                     {0~2}   0:constantly awake mode (CAM)   Power Saving Mode
                                1:MAX_PSP
                                2:FAST_PSP


-------------------------------------------------------------------------------------------------------


Examples
=================
-------------------------------------------------------------------------------------------------------
a> Config STA to link with AP which is OPEN/NONE(Authentication/Encryption)
	1. iwpriv rausb0 set NetworkType=Infra
	2. iwpriv rausb0 set AuthMode=OPEN
	3. iwpriv rausb0 set EncrypType=NONE
	4. iwpriv rausb0 set SSID="AP's SSID"

b> Config STA to link with AP and OPEN/WEP(Authentication/Encryption). 
    Default Key ID = 3
	1. iwconfig rausb0 key [3]
	2. iwconfig rausb0 key s:abcde
	3. iwconfig rausb0 essid "AP's SSID"
	
c> Config STA to link with AP which is SHARED/WEP(Authentication/Encryption).
	1. iwpriv rausb0 set NetworkType=Infra
	2. iwpriv rausb0 set AuthMode=SHARED
	3. iwpriv rausb0 set EncrypType=WEP
	4. iwpriv rausb0 set Key1="AP's wep key"
	5. iwpriv rausb0 set DefaultKeyID=1
	6. iwpriv rausb0 set SSID="AP's SSID"

	
d> Config STA to link with AP which is WPAPSK/TKIP(Authentication/Encryption)
	1. iwpriv rausb0 set NetworkType=Infra
	2. iwpriv rausb0 set AuthMode=WPAPSK
	3. iwpriv rausb0 set EncrypType=TKIP
	4. iwpriv rausb0 set SSID="AP's SSID"
	5. iwpriv rausb0 set WPAPSK="12345678"
	6. iwpriv rausb0 set SSID="AP's SSID"
	
    p.s Step 4 is part of generating wpapsk password and is necessary.
	
e> Config STA to link with AP which is WPAPSK/AES(Authentication/Encryption)
    1. iwconfig rausb0 mode managed
	2. iwpriv rausb0 auth 3
	3. iwpriv rausb0 enc  4
	4. iwconfig rausb0 essid "AP's SSID"
	5. iwpriv rausb0 wpapsk 12345678
	6. iwconfig rausb0 essid "AP's SSID"
	
f> Config STA to link with AP which is WPA2PSK/TKIP(Authentication/Encryption)
	1. iwpriv rausb0 set NetworkType=Infra
	2. iwpriv rausb0 set AuthMode=WPA2PSK
	3. iwpriv rausb0 set EncrypType=TKIP
	4. iwpriv rausb0 set SSID="AP's SSID"
	5. iwpriv rausb0 set WPAPSK="12345678"
	6. iwpriv rausb0 set SSID="AP's SSID"
	
g> Config STA to create/link as adhoc mode, which is OPEN/NONE(Authentication/Encryption)
	1. iwpriv rausb0 set NetworkType=Adhoc
	2. iwpriv rausb0 set AuthMode=OPEN
	3. iwpriv rausb0 set EncrypType=NONE
	4. iwpriv rausb0 set SSID="Adhoc's SSID"

h>  Config STA to create/link as adhoc mode, which is WPANONE/TKIP(Authentication/Encryption)
    1. iwpriv rausb0 set NetworkType=Adhoc
	2. iwpriv rausb0 set AuthMode=WPANONE
	3. iwpriv rausb0 set EncrypType=TKIP
	4. iwpriv rausb0 set SSID="AP's SSID"
	5. iwpriv rausb0 set WPAPSK=12345678
	6. iwpriv rausb0 set SSID="AP's SSID"	

i> Get site survey 
    iwpriv rausb0 get_site_survey
		
j> Get Statistics 
    iwpriv rausb0 stat						; read statistic counter
    iwpriv rausb0 set ResetCounter=0		; reset statistic counter

k> Link with any AP without security        ; set ANY SSID (ssidLen=0)
   usage: iwconfig ra0 essid ""                 
   or
   usage: iwpriv ra0 set SSID=""

===================================================================

iwlist
=================
This is detailed explanation of each parameters for iwlist.

-------------------------------------------------------------------------------------------------------
iwlist rausb0 scanning		; list the results after scanning(manual rescan)


=======================================================================================================

iwconfig
=================
The following are our support in standard configuration - iwconfig

-------------------------------------------------------------------------------------------------------
iwconfig rausb0 essid {NN|on|off}		        ; set ssid
iwconfig rausb0 mode {managed|ad-hoc|...}       ; set wireless mode
iwconfig rausb0 freq N.NNNN[k|M|G]]		        ; set frequency
iwconfig rausb0 channel N					    ; set channel
iwconfig rausb0 ap {N|off|auto}			        ; set ap address
iwconfig rausb0 nick N						    ; set nickname
iwconfig rausb0 rate {N|auto|fixed}     	    ; set rate
iwconfig rausb0 rts {N|auto|fixed|off}		    ; set rts threshold
iwconfig rausb0 frag {N|auto|fixed|off}	        ; set fragment threshold
iwconfig rausb0 enc {NNNN-NNNN|off}		        ; set encryption type
iwconfig rausb0 power {period N|timeout N}	    ; set power management modes
iwconfig rausb0 key {[id]|s:pswd|pswd}          ; set wep key

*** Please refer to man page of 'iwconfig', 'iwlist' and 'iwpriv'. ***



NOTE: NOT ALL CARDS/FIRMWARE SUPPORT ALL OF THE COMMANDS LISTED 
BELOW.

Note: To connect your Linux machine to a WLAN using WPA, WPA2 
or 802.1X you will need to use WPA Supplicant

Connecting to an OPEN / WEP WLAN (DHCP)

Note: 
replace [interface] with your interface name as required (e.g. eth1, wlan0, ath0 
etc.)

iwconfig [interface] mode managed key [WEP key] (128 bit WEP 
use 26 hex characters, 64 bit WEP uses 10)


iwconfig essid 
"[ESSID]" (Specify ESSID for the WLAN)


dhclient [interface] 
(to receive an IP address, netmask, DNS server and default gateway from the 
Access Point)


ping (if you receive a reply you 
have access)



Connecting to an OPEN / WEP WLAN 
(Manual IP Setup)

Note: replace [interface] with your interface 
name as required (e.g. eth1, wlan0, ath0 etc.)

It may be necessary to run 
some packet capture software (e.g. Ethereal) to determine the IP addresses of 
both the Default Gateway and DNS servers.

iwconfig [interface] mode 
managed key [WEP key] (128 bit WEP use 26 hex characters, 64 bit WEP uses 
10)


iwconfig essid "[ESSID]"


ifconfig 
[interface] [IP address] netmask [subnetmask]


route add 
default gw [IP of default gateway] (Configure your default gateway; usually 
the IP of the Access Point)


echo nameserver [IP address of DNS 
server]  >>  /etc/resolve.conf (Configure your DNS 
server)


ping  (if you receive a reply you have 
access)



iwconfig 
Commands:

Note: replace [interface] with your interface name as 
required (e.g. eth1, wlan0, ath0 etc.)

iwconfig [interface] mode 
master (set the card to act as an access point mode)


iwconfig 
[interface] mode managed (set card to client mode on a network with an 
access point)


iwconfig [interface] mode ad-hoc (set card to 
peer to peer networking or no access point mode)


iwconfig 
[interface] mode monitor (set card to RFMON mode our 
favourite)


iwconfig [interface] essid any (with some cards you 
may  disable the  ESSID  checking)


iwconfig [interface] essid 
?/span>your ssid_here?(configure ESSID for 
network)


iwconfig [interface] key 
1111-1111-1111-1111 (set 128 bit WEP key)


iwconfig 
[interface] key 11111111 (set 64 bit WEP key)


iwconfig 
[interface] key s:mykey (set key as an ASCII string)


iwconfig 
[interface] key off (disable WEP key)


iwconfig [interface] key 
open (sets open mode, no authentication is used and card may accept 
non-encrypted sessions)


iwconfig [interface] channel [channel no.] 
(set a channel 1-14)


iwconfig [interface] channel auto 
(automatic channel selection)


iwconfig [interface] freq 2.422G 
(channels can also be specified in GHz)


iwconfig [interface] 
ap 11:11:11:11:11:11 (Force card to register AP 
address)


iwconfig [interface] rate 11M (card will use the rate 
specified)


iwconfig [interface] rate auto (select automatic 
rate)


iwconfig [interface] rate auto 5.5M (card will use the 
rate specified and any rate below as required)



ifconfig Commands:

Note: replace [interface] with 
your interface name as required (e.g. eth1, wlan0, ath0 etc.)

ifconfig 
[interface] up (bring up specified interface)


ifconfig 
[interface] down (take down specified interface)


ifconfig 
[interface] [IP address] netmask [subnet-mask] (manually set IP and 
subnet-mask details)


ifconfig [interface] hw ether [MAC] 
(Change the wireless cards MAC address, specify in format 
11:11:11:11:11:11) 



iwpriv 
Commands:

Note: replace [interface] with your interface name as 
required (e.g. eth1, wlan0, ath0 etc.)

iwpriv [interface] hostapd 1 
(used to set card mode to hostapd e.g. for void11)


When the 
monitor mode patch is installed as per the 

the 
following commands may be used to set the card into monitor 
mode.


iwpriv [interface] monitor [A] 
[B]
[A]
0 = disable monitor mode
1 = enable 
monitor mode with Prism2 header 

2 = enable monitor mode with no 
Prism2 
[B]
Channel to monitor (1-14)

iwlist Commands:

Note: replace [interface] with your 
interface name as required (e.g. eth1, wlan0, ath0 etc.)

iwlist is 
used to display some large chunk of information from a wireless network 
interface that is not displayed by iwconfig. 


iwlist [interface] 
scan (Give the list of Access Points and Ad-Hoc cells in range (ESSID, 
Quality, Frequency, Mode etc.) Note: In tests only worked with Atheros cards). 



iwlist [interface] channel (Give the list of available 
frequencies in the device and the number of channels).


iwlist 
[interface] rate (List the bit-rates supported by the 
device).


iwlist [interface] key (List the encryption key sizes 
supported and display all the encryption keys available in the 
device).


iwlist [interface] power (List the various Power 
Management attributes and modes of the device).


iwlist [interface] 
txpower (List the various Transmit Power available on the 
device).


iwlist [interface] retry (List the transmit retry 
limits and retry lifetime on the device).


iwlist [interface] ap 
(Give the list of Access Points in range, and optionally the quality of link 
to them.  Deprecated in favour of scan)


iwlist [interface] peers 
(Give the list of Peers associated/registered with this 
card).


iwlist [interface] event (List the wireless events 
supported by this card).


Madwifi-ng 
Commands:

MADWiFi supports virtual access points (VAPS), which 
means you can create more than one wireless device per wireless card (the host 
wireless card = wifi0).  

By default, a sta mode VAP is created 
by, which is MadWifi talk for a 'managed mode wireless 
interface'.


Note: replace athx with your interface name 
as required (e.g. ath0, ath1)


wlanconfig athx destroy (Destroy 
VAP, athx)


wlanconfig athx create wlandev wifi0 wlanmode sta 
(Create a managed mode VAP, athx)


wlanconfig athx create 
wlandev wifi0 wlanmode ap (Create an Access Point VAP, 
athx)


wlanconfig athx create wlandev wifi0 wlanmode adhoc 
(Create an Ad-Hoc VAP, athx)


wlanconfig athx create wlandev 
wifi0 wlanmode monitor (Create a Monitor mode VAP, athx)


Changing 
modes:

ifconfig athx down (Take the VAP 
down)


wlanconfig athx destroy (Destroy the VAP, 
athx)


wlanconfig athx create wlandev wifi0 wlanmode 
[sta|adhoc|ap|monitor] (Create a new sta, adhoc, ap or monitor 
VAP)


Scan for Access Points (requires both steps):

modprobe 
wlan_scan_sta (To insert the scanning module) 


wlanconfig athx 
list scan (To list the APs)