Atheros AP222A User Manual Download Page 53

COMPANY CONFIDENTIAL

52

General Commands 

These are the common commands used for various functions during operations. 

addmac 
delmac 
maccmd 

#iwpriv ath

N

maccmd cmd 

#iwpriv ath

N

addmac mac_addr 

#iwpriv ath

N

delmac mac_addr 

These commands are used to setup and modify the MAC filtering list. MAC filtering allows the user to either 
limit specific MAC addresses from associating with the AP, or specifically indicates which MAC addresses can 
associate with the AP. The 

addmac 

and 

delmac

will add specific MAC addresses to the Access Control List 

(ACL). The maccmd value indicates how to use the ACL to limit access the AP. The following table indicates 
the valid commands: 

Value

Description 

0

Disable ACL checking 

1

Only ALLOW association with MAC addresses on the list 

2

DENY association with any MAC address on the list 

3

Flush the current ACL list

4

Suspend current ACL policies. Re-enable with a 1 or 2 command 

These commands have no “get” equivalents. The default value of maccmd is 0. 

#iwpriv ath

0

maccmd 1 

#iwpriv ath

0

addmac 00:03:7f:00:00:20 

#iwpriv ath

0

delmac 00:03:7f:00:12:34 

ap_bridge 

#iwpriv ath

N

ap_bridge mode 

This command will enable or disable bridging within the AP driver. This has the effect of now allowing a 
station associated to the AP to access any other station associated to the AP. This eliminates bridging between 
clients. This command has a corresponding get command. Its default value is 0. 

#iwpriv ath0 ap_bridge 0 
#iwpriv ath0 get_ap_bridge 
ath0 get_:0 

bgscan 

#iwpriv ath

N

bgscan 

1|0

This command will enable or disable background scanning. Background scanning occurs on a specified interval 
to update the list of known AP’s. This command is only valid when a VAP is operating in station mode. The 
command has a corresponding get command, and its default value is 1. 

#iwpriv ath0 bgscan 1 
#iwpriv ath0 get_bgscan 
ath0 get_bgscan:1 

bgscanidle

#iwpriv ath

N

bgscanidle idlePeriod 

This command sets the amount of time the background scan must be idle before it is restarted. This is different 
from the background scan interval, in that if the background scan is delayed for a long period, when it is 
complete it will be idle for this period even if the scan interval times out. This time is indicated in seconds. 
The command has a corresponding get command, and its default value is 250 seconds. 

#iwpriv ath0 bgscanidle 200 
#iwpriv ath0 get_bgscanidle 
ath0 get_bgscanidle:200 

Summary of Contents for AP222A

Page 1: ...AP222A AP User s Manual...

Page 2: ...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...

Page 3: ...ipts 17 2 3 1 Initialization Scripts 24 2 3 1 1 rcS 25 2 3 1 2 rc network 25 2 3 1 3 rc bridge 25 2 3 1 4 rc wlan 25 2 3 2 Driver Operation Scripts 25 2 3 2 1 makeVAP 26 2 3 2 2 activateVAP 27 2 3 2 3...

Page 4: ...3 2 3 WSC Configuration 68 3 2 3 1 Including WSC in the build 68 3 2 3 2 Activating WSC support on the AP 68 3 3 VLAN Configuration 69 3 3 1 Bridge configuration in mBSSID and VLAN mode 70 3 4 Multip...

Page 5: ...architecture was the use of a common code base to support multiple operating systems This allows for more efficient development processes as well as the synergy of getting bug fixes for all major plat...

Page 6: ...Only low level driver components can interface directly with HAL 1 3 2 ATH ATH_DEV module implements the low level MAC functionalities including Unified transmit and receive path for both legacy and 1...

Page 7: ...most support in the Fusion driver are the net80211 derivatives They have been ported to NetBSD Linux Darwin and Windows Vista Another popular stack is Devicescape s 802 11 stack in Linux kernel Micro...

Page 8: ...n is required for each platform By having a consistent API across all platforms driver developers can focus on the core wireless LAN logic Currently supported operating systems are NetBSD Linux and Wi...

Page 9: ...S2 filesystem the cramfs can be used to further reduce the flash footprint of the overall system 2 2 1 Design The main design intent was to provide a busybox like environment that can be used as a CGI...

Page 10: ...n be used to manage the values stored in the flash cache areas allowing the user to have either temporary or permanent parameter storage Table 1 defines the available tags Table 1 Available File Tags...

Page 11: ...e0a4150 2 AP50_Holden AP bf668080 5f504153 53504852 4153453d 6672617a _PASSPHRASE fraz bf668090 65310a41 505f5041 53535048 52415345 e1 AP_PASSPHRASE bf6680a0 5f323d66 726f7a65 0a5a4849 46454e47 _2 fro...

Page 12: ...maxlength 16 value IPADDR tr td a class header Local Netmask td INPUT type text id IPMASK name IPMASK class text2 size 20 maxlength 16 value IPMASK tr td a class header Gateway IP td INPUT type text...

Page 13: ...file To delete a variable value pair from the cache use the following form cfg r VAR The variable name must not include spaces If the variable does not exist no error is generated but no action is pre...

Page 14: ...if applicable and their effects Table 2 AP Environmental Variable Variable Default Description ATH_countrycode Identifies the specific regulatory table to use for the country of interest Used for tes...

Page 15: ...t sta Simple station VAP not normally used alone ap wds WDS 4 address frame format interface that WDS stations can connect to See ROOTAP_MAC sta wds Client WDS interface that connects to an Infrastruc...

Page 16: ...control is enabled MANRETRIES 0x04040404 Number of retries on each rate interval to attempt before changing Only applicable if manual rate control RX_CHAINMASK RX_CHAINMASK_2 5 for 3 chain device 3 fo...

Page 17: ...ndicate ASCII entry prepend s to the string AP_PRIKEY Primary WEP key to use AP_WPA WPA mode This indicates if WPA 1 or WPA 2 or both are to be used in WPA operations AP_CYPHER Which pairwise ciphers...

Page 18: ...current page If the current page is switched the updates are NOT saved so click update if you want to save what you changed on the page Reboot This button will reboot the AP This performs a quick reb...

Page 19: ...tic means that the WAN interface will use the IP address and mask specified under WAN IP Settings Startup Mode AP_STARTMODE Sets the startup mode that the scripts use to initialize the AP The modes ar...

Page 20: ...for details Gating Index SHORT_GI SHORT_GI_2 Enables half period Gating Index Disable forces full period gating index Aggregation AMPDUENABLE AMPDUENABLE_2 Enables Disables aggregation for the radio...

Page 21: ...ion Page 1 of 2 Table 5 VAP Configuration Page Parameters Parameter Env Var Description ESSID String AP_SSID SSID String for the Virtual interface For Client mode VAPs this is the ESSID of the BSS to...

Page 22: ...COMPANY CONFIDENTIAL 21 Figure 6 VAP Configuration Page 2 of 2...

Page 23: ...A2 or Auto detect either WPA Cypher AP_CYPHER Key policy either TKIP or CCMP AES Auto indicates detect either WPA Rekey Int AP_WPA_GROUP_REKEY Interval for group rekey WPA Master Rekey AP_WPA_GMK_REKE...

Page 24: ...age This page shows the output of the command iwconfig with no parameters Figure 7 AP Status Page 2 4 5 Channel Page This page shows the output of the wlanconfig athx list channel command See section...

Page 25: ...user s interface 2 5 1 1 Initialization Scripts Standard Linux operation requires an initialization script that is run upon bootup This script rcS is kept in the standard location etc rc d All system...

Page 26: ...e indicates whether the DHCP server should be started on the bridge If set to y then the UDHCPD daemon is started The configuration file for the DHCP server is located at etc udhcpd conf 2 5 1 1 4 rc...

Page 27: ...ns the Beacon Interval can be specified to spread out beacon transmits Table 7 Channel Operating Modes Name Description 11B Standard Legacy DSSS rates in 2 4 GHz band 11G Standard Legacy rates in 2 4...

Page 28: ...s script will remove the indicated VAP s and remove the associated instances of hostapd wpa_supplicant or wsc This script does not rely on any environmental variables 2 5 1 3 Compatibility Scripts Two...

Page 29: ...exclusively in the protocol layer Also note that any ifconfig commands used on the access point must be applied to the protocol layer ath device they have no effect on the Radio layer 2 5 2 1 iwconfi...

Page 30: ...if the indicated frequency is invalid for the device The VAP for this interface should be destroyed at this point as it will not be properly configured with an operating frequency There is no default...

Page 31: ...m 1 to 4 The key_value parameter can be specified in either hex mode or as an ASCII string Key values can be specified for either WEP 64 40 bit mode requiring 5 bytes or WEP 128 108 bit mode requiring...

Page 32: ...ABcnRespT Response Time iwpriv wifiN AddSWBb0 Response Time These settings are used to adjust the calculation of the ready time for the QoS queues This is used to adjust the performance of the QoS que...

Page 33: ...itted if this is disabled This has a corresponding get command and the default value is 1 enabled iwpriv wifi0 AMPDU 1 iwpriv wifi0 getAMPDU wifi0 getAMPDU 1 AMPDUFrames iwpriv wifiN AMPDUFrames numFr...

Page 34: ...receive signal strength If Diversity Control is set to Variable 0 then the transmitting antenna will be selected based on received signal strength Both commands have associated get commands iwpriv wi...

Page 35: ...ach of these commands has a corresponding get command iwpriv wifi0 CCKTrgLow 80 iwpriv wifi0 CCKTrgHi 220 iwpriv wifi0 GetCCKTrgLow wifi0 GetCCKTrgLow 100 iwpriv wifi0 GetCCKTrgHi wifi0 GetCCKTrgHi 20...

Page 36: ...or extended range This parameter is also modified by the ANI algorithm so this may be change dynamically during operation usually in steps of single units The default value for this parameter is 0 The...

Page 37: ...oor calibration debug information HAL_DBG_CALIBRATE 0x00000100 All other calibration debug information HAL_DBG_CHANNEL 0x00000200 Channel selection and channel settings HAL_DBG_INTERRUPT 0x00000400 In...

Page 38: ...FDMTrgLow Low Threshold iwpriv wifiN OFDMTrgHi High Threshold These commands control the OFDM PHY Error sec threshold settings for the ANI immunity levels A PHY error rate below the low trigger will c...

Page 39: ...ifi0 RSSIThrHi 45 iwpriv wifi0 GetRSSIThrLow wifi0 GetRSSIThrLow 7 iwpriv wifi0 GetRSSIThrHi wifi0 GetRSSIThrHi 40 setCountryID setCountry iwpriv wifiN setCountryID Country ID Num iwpriv wifiN setCoun...

Page 40: ...0x05 iwpriv wifiN rxchainmask 0x05 iwpriv wifiN get_txchainmask wifi0 get_txchainmask 5 iwpriv wifiN get_rxchainmask mask wifi0 get_rxchainmask 5 TXPowLim iwpriv athN TXPowLim limit This command will...

Page 41: ...is the number of time slots inside the Arbitration Interframe space to be used The minimum value is 2 logCWmin CW min 2log min 1 Minimum backoff timer limit This is specified in log units where the a...

Page 42: ...ath0 get_cwmax 4 cwmin iwpriv athN cwmin AC Mode value This command sets the CWmin WMM parameter for either the AP or station parameter set The cwmax command is a WMM command that must have the AC and...

Page 43: ...ese commands have an associated get command and its default value is 0 iwpriv ath0 authmode 2 iwpriv ath0 get_authmode ath0 get_authmode 2 countermeasures iwpriv athN countermeasures 1 0 Enables or di...

Page 44: ...alid for WEP operations This command is used to set the key length of the WEP key Key lengths of 5 40 bits or 13 104 bits are the only valid values corresponding to 64 or 128 bit WEP encoding respecti...

Page 45: ...as a valid iwpriv command The definition of the required data structure is as follows struct ieee80211req_getset_appiebuf u_int32_t app_frmtype management frame type for which buffer is added u_int32_...

Page 46: ...cated value See the mcastcipher command for the definition of the values This command has a corresponding get command but no default value iwpriv ath0 ucastcipher 2 iwpriv ath0 get_uciphers ath0 get_u...

Page 47: ...is the value shown under the AID column when using the wlanconfig list command The status value is an 8 bit value indicating the status field of the response This is normally used only during testing...

Page 48: ...this is required to be set to 0 when operating in that band The command has a corresponding get command and the default value is 1 iwpriv ath0 cwmmode 1 iwpriv ath0 get_cwmmode ath0 get_cwmmode 1 extb...

Page 49: ...he MCS rate to use for each of 4 rate fallback values If the hardware does not receive an ACK when transmitting at the first rate it will fall back to the second rate and retry and so on through the 4...

Page 50: ...the device being used For dual chain devices chain 2 is not available Similarly single chain devices will only support chain 0 The chains are represented in the bit mask as follows Chain 0 0x01 Chain...

Page 51: ...iv athN doth 0 1 This enables or disables support for 802 11h regulatory information selection For the AP this enables or disables transmission of country IE information in the beacon Stations support...

Page 52: ...wpriv athN markdfs 1 0 This command will enable or disable the marking of DFS channels A channel is marked if a radar is detected on the channel and it is put in the Non Occupancy List NOL This is onl...

Page 53: ...riv athN ap_bridge mode This command will enable or disable bridging within the AP driver This has the effect of now allowing a station associated to the AP to access any other station associated to t...

Page 54: ...the selection of dfs channels when the 802 11h channel switch processing is selecting a new channel Typically when a radar is detected on a channel a new channel is picked randomly from the list DFS c...

Page 55: ...00000 association handling IEEE80211_MSG_AUTH 0x00400000 authentication handling IEEE80211_MSG_SCAN 0x00200000 Scanning IEEE80211_MSG_OUTPUT 0x00100000 output handling IEEE80211_MSG_STATE 0x00080000 s...

Page 56: ...alue iwpriv ath0 driver_caps 0x034000003 iwpriv ath0 get_driver_caps ath0 get_driver_caps 872415235 dtim_period iwpriv athN dtim_period delivery period This is used to set the Delivery Traffic Indicat...

Page 57: ...able to be able to determine which radio a particular VAP is attached to This command will return the index of the associated radio object wifiN where N is the radio number iwpriv ath0 getRadio ath0 g...

Page 58: ...allows the user to limit the impact of multicast on the overall performance of the system The command has a corresponding get command and has no default value iwpriv ath0 mcast_rate 10000 iwpriv ath0...

Page 59: ...t command and its default value is 0 iwpriv ath0 pureg 1 iwpriv ath0 get_pureg ath0 get_pureg 1 qosnull iwpriv athN qosnull AC Similar to the pspoll this command will send a QoS NULL frame from the in...

Page 60: ...rssi11g These commands set the RSSI threshold for roaming in 11g and 11b modes These thresholds are used to make roaming decisions based on signal strength from the current set of APs available The va...

Page 61: ...ress frame format for this VAP Used for WDS configurations see section 3 5 for details This command has a corresponding get command and its default value is 0 iwpriv ath0 wds 1 iwpriv ath0 get_wds ath...

Page 62: ...frastructure notes are called master nodes and client nodes are called managed nodes The following command is used to create a VAP instance wlanconfig ath N create wlandev wifiN wlanmode ap sta mon bs...

Page 63: ...le B PBC C C Poll Request A Channel Agility ACAPS Current Advanced Atheros capability flags These are alphanumeric characters corresponding to the flags that are set for the advanced Atheros capabilit...

Page 64: ...fined as follows E ESS P Privacy S Short Slot Time I IBSS S Short Preamble D DSSS OFDM c Pollable B PBCC C Poll Request A Channel Agility no Header All Information Elements for the attached station ar...

Page 65: ...able SWRETRY TX Software Retry WME WME capable TURBOP ATH Turbo available MONITOR Monitor Mode 2 5 3 2 5 WMM Configuration wme This listing provides the current settings of the VAP s WME settings The...

Page 66: ...he rcS script so the user will not have to run anything once the AP comes up 3 1 1 1 Bridged Mode The most common mode used is bridged mode This is where the Ethernet interfaces are not assigned IP ad...

Page 67: ...GHT20 2 4 GHz 20 MHz 11n HT 40 11NGHT40PLUS 2 4 GHz 40 MHz 11NGHT40MINUS 2 4 GHz 40 MHz Note that if the channel is set to HT 40 mode it still can support lower mode e g stations requesting HT 20 chan...

Page 68: ...ate a VAP on channel 6 with an SSID of Atheros_XSpan using WEP security mode with the default values in the WEP conf file export AP_SECMODE WEP export AP_SECFILE WEP conf apup 3 2 2 WPA The WPA config...

Page 69: ...the configuration required A single configuration file wpa2EAP conf is provided for configuring the system in this mode The interface name and the SSID will be automatically updated for the VAP when b...

Page 70: ...to configure singe VLAN interface on AP The vconfig command is quite straightforward The following commands are used taken from the Linux MAN pages Note the added to indicate the command prompt To Add...

Page 71: ...e other open to allow a single AP to perform multiple roles The scripting system has been designed to support mBSSID configurations through defining environmental variables It is assumed that no clien...

Page 72: ...e 3 5 Wi Fi Distribution System WDS The WDS system is used to create a network of AP s that can be used as a single virtual AP This is accomplished by the 4 address frame format as specified by the 80...

Page 73: ...fore you start apup Configuring the Root AP The following will set up a root AP using the default SSID on channel 6 export AP_STARTMODE rootap apup Configuring the repeater The following will set up a...

Page 74: ...s only required in this situation where multiple repeaters have the same SSID and may accidentally be closer than the root AP to another repeater AP 3 5 3 WDS Bridge with single span This configuratio...

Page 75: ...same SSID to form a BSS but unique IP addresses Once configured the APs can be started in any order Note that if a client is attached to a remote subnet and the root AP is the DHCP server that the rem...

Page 76: ...erate in dual concurrent mode multiple VAPs must be instantiated These VAPs can have the same SSID and security configurations but will have different MAC addresses Further the hardware must support d...

Page 77: ...32 CTRY_ARMENIA AM 51 CTRY_AUSTRALIA AU 36 CTRY_AUSTRALIA2 5000 CTRY_AUSTRIA AT 40 CTRY_AZERBAIJAN AZ 31 CTRY_BAHRAIN BH 48 CTRY_BELARUS BY 112 CTRY_BELGIUM BE 56 CTRY_BELIZE BZ 84 CTRY_BOLIVIA BO 68...

Page 78: ...348 CTRY_ICELAND IS 352 CTRY_INDIA IN 356 CTRY_INDONESIA ID 360 CTRY_IRAN IR 364 CTRY_IRAQ IE 368 CTRY_IRELAND IL 372 CTRY_ISRAEL IT 376 CTRY_ITALY 380 CTRY_JAMAICA 388 CTRY_JAPAN JP 392 CTRY_JAPAN1...

Page 79: ...CTRY_JAPAN28 4028 CTRY_JAPAN29 4029 CTRY_JAPAN30 4030 CTRY_JAPAN31 4031 CTRY_JAPAN32 4032 CTRY_JAPAN33 4033 CTRY_JAPAN34 4034 CTRY_JAPAN35 4035 CTRY_JAPAN36 4036 CTRY_JAPAN37 4037 CTRY_JAPAN38 4038 C...

Page 80: ...BYA 434 CTRY_LIECHTENSTEIN LI 438 CTRY_LITHUANIA LT 440 CTRY_LUXEMBOURG LU 442 CTRY_MACAU MO 446 CTRY_MACEDONIA MK 807 CTRY_MALAYSIA MY 458 CTRY_MALTA 470 CTRY_MEXICO MX 484 CTRY_MONACO MC 492 CTRY_MO...

Page 81: ...724 CTRY_SRI_LANKA LK CTRY_SWEDEN SE 752 CTRY_SWITZERLAND CH 756 CTRY_SYRIA SY 760 CTRY_TAIWAN TW 158 CTRY_THAILAND TH 764 CTRY_TRINIDAD_Y_TOBAGO TT 780 CTRY_TUNISIA TN 788 CTRY_TURKEY TR 792 CTRY_UA...

Reviews: