Atheros AP222A Скачать руководство пользователя страница 9

COMPANY CONFIDENTIAL

8

2 User Interface 

The user interface on the Linux AP baseline provides a rich set of capabilities via command line tools, and also provides a 
simplified web interface that can be used for quick AP configuration. The user interface is based on shell scripts and a 
configuration utility that will store configuration information in flash. The web interface also uses this utility to store 
information through boot cycles. 

2.1 Factory Default File 

The file 

/etc/ath/apcfg 

contains the “factory default” information for the AP. This is the data that is used to configure 

the device in the absence of other configuration information. If the configuration information is erased, this data will 
repopulate the configuration information files. The default values included in this file can be changed if the user so 
desires. 

2.2 Configuration Tool 

The purpose of the cgiMain utility is to provide a small program size mechanism for managing environmental 
configuration information in as efficient manner as possible. Major consideration has been applied to small footprint 
environments, where JFFS2 filesystem space is at a premium. Further, if no configuration information needs to be 
changed in the JFFS2 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 program for getting 
environmental information, and further providing output formatting that will make the web pages easily configurable, 
but dynamic. This was done in lieu of other larger implementations, such as PHP or Python, simply for the smaller size 
requirement, and the customization required to use flash resources effectively. 
The main engine will receive an input file and “translate” it, changing specially tagged parameters into their equivalent 
values. For example, let’s say that we have an environmental variable called AP_SSID, whose value is AP24. Further, 
let’s say we have a configuration file that has a line in the file of the form 

ssid=<ssid value>. 

We can put a tagged reference to the environmental variable in the configuration file, and then “translate” it to a scratch 
file: 

Original file: ssid=~~AP_SSID~ 
Translated file: ssid=AP24 

The translated file can be written to /tmp (ram disk), thus not requiring any more flash space to support the translation. 
A typical command line to implement this would be 

# cgiMain –t2 /etc/ath/PSK.ap_bss > /tmp/vap2sec.bss 

Where 

/etc/ath/PSK.ap_bss 

is the file containing the tags, and 

/tmp/vap0sec.bss 

is the file containing the translated 

version with tags replaced with values. 

Содержание AP222A

Страница 1: ...AP222A AP User s Manual...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 22: ...COMPANY CONFIDENTIAL 21 Figure 6 VAP Configuration Page 2 of 2...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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_...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: