This file provides some basic examples on the configuration of the
driver using standard linux wireless tools. Where possible iwconfig
should be used to adjust settings. Some settings are currently not
avaiable via iwconfig and these include WPA, for these functions it is
currently necessary to use iwpriv.


Configuration Examples
======================================================================
----------------------------------------------------------------------
Example I: STA with AP using OPEN/NONE(Authentication/Encryption)
    1. iwconfig ra0 mode managed
    2. iwconfig ra0 key open
    3. iwconfig ra0 key off
    4. iwconfig ra0 essid "AP's SSID"

Example II: STA with AP using SHARED/WEP(Authentication/Encryption)
    1. iwconfig ra0 mode managed
    2. iwconfig ra0 key restricted
    3. iwconfig ra0 Key [1] "s:AP's wep key"
    4. iwconfig ra0 key [1]
    5. iwconfig ra0 essid "AP's SSID"

Example III: STA using adhoc mode
    1. iwconfig ra0 mode ad-hoc
    2. iwconfig ra0 key off
    4. iwconfig ra0 essid "STA's SSID"

Example IV: STA with AP using WPAPSK/TKIP(Authentication/Encryption)
    1. iwconfig ra0 mode managed
    2. iwpriv ra0 set AuthMode=WPAPSK
    3. iwpriv ra0 set EncrypType=TKIP
    4. iwconfig ra0 essid "AP's SSID" (1)
    5. iwpriv ra0 set WPAPSK="AP's wpa-preshared key"
    6. iwconfig ra0 essid "AP's SSID"

Example V: STA with AP using WPAPSK/AES(Authentication/Encryption)
    1. iwconfig ra0 mode managed
    2. iwpriv ra0 set AuthMode=WPAPSK
    3. iwpriv ra0 set EncrypType=AES
    4. iwconfig ra0 essid "AP's SSID" (1)
    5. iwpriv ra0 set WPAPSK="AP's wpa-preshared key"
    6. iwconfig ra0 essid "AP's SSID"

(1) Part of generating the wpapsk password. Needed when anything other
than a 64 hex character string is used in step 5. When a 64 character
hex string is used, step 4 may be omitted.

Some APs don't provide enough security information to allow the driver
to establish a connection. If you are unable to connect using the
above procedures, try specifying the BSSID (i.e. the AP's MAC address)
e.g.

    iwconfig ra0 ap 11:22:33:44:55:66

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

----------------------------------------------------------------------
USAGE:
    iwpriv ra0 set [parameters]=[val]

where

[parameters]    [val] range             explanation
------------    --------------------    ---------------------
CountryRegion   {0~7}                   Set country region
                                        0: use 1 ~ 11 Channel
                                        1: use 1 ~ 11 Channel
                                        2: use 1 ~ 13 Channel
                                        3: use 10, 11 Channel
                                        4: use 10 ~ 13 Channel
                                        5: use 14 Channel
                                        6: use 1 ~ 14 Channel
                                        7: use 3 ~ 9 Channel

WirelessMode    {0~2}                   Set Wireless Mode
                                        0:11b/g mixed, 1:11B only

TxRate          {0~12}                  Set TxRate
                                        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

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

TxBurst         {0,1}                   Enable/Disable
                                        0:Disable, 1:Enable

TurboRate       {0,1}                   Enable/Disable
                                        0:Disable, 1:Enable

AdhocOfdm       {0, 1}                  Adhoc mode OFDM
                                        0: Disallow 1: Allow

AuthMode        {OPEN,SHARED,WPAPSK}    Authentication mode

EncrypType      {NONE,WEP,TKIP,AES}     Encryption Type

WPAPSK          {8~63 ASCII or 64 HEX characters}
                                        WPA Pre-Shared Key

ApClient        {0,1}                   Set ApClient mode
                                        0:Disable, 1:Enable

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

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

iwlist ra0 scanning; list the result after scanning(site survey)




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


Deprecated iwpriv
=================

*** PLEASE DO NOT USE THESE FUNCTIONS, THIS IS FOR HISTORICAL
    REFERENCE ONLY ***
As the configuration utility still uses some iwpriv commands they have
not been removed from the driver yet. These commands are likely to
dissapear if the utility is updated.

** ALL THESE COMMANDS HAVE A IWCONFIG REPLACEMENT, USE IT ****

SSID           {0~z, less than 32 characters}       Set SoftAP SSID

Channel         {1~14} depends on country region    Set Channel

RTSThreshold    {1~2347}                            Set RTS Threshold

FragThreshold   {256~2346}                          Set Fragment Threshold

NetworkType     {Infra,Adhoc}                       Set Network type

DefaultKeyID    {1~4}                               Set Default Key ID

Key1            {5 ascii characters or              Set Key1 String
                10 hex number or
                13 ascii characters or
                26 hex numbers}

Key2            {5 ascii characters or              Set Key2 String
                10 hex number or
                13 ascii characters or
                26 hex numbers}

Key3            {5 ascii characters or              Set Key3 String
                10 hex number or
                13 ascii characters or
                26 hex numbers}

Key4            {5 ascii characters or              Set Key4 String
                10 hex number or
                13 ascii characters or
                26 hex numbers}
