NAME
ap-gl - configure and monitor ATMEL_PRISM based APs
SYNOPSIS
ap-gl
DESCRIPTION
ap-gl to config and get stats from Atmel-chipset based AP with
ATMEL_PRISM Private MIB support.
MENU
Info/
SysInfo
Get info about AP hardware and software
Ethernet
This option displays the Ethernet statistics for your reference.
Wireless
This option displays the wireless statistics for your reference.
Stations (atmel)
Under this menu the user will be able to see the Associated
Stations that are currently associated with the Access Point.
For each associated station the user will be able to see the MAC
Address. From version 0.7.3-pre1 you may save mac addresses list
to file ~/<util_name>.stations. For each associated station the
user will be able to see the MAC Address, Link Quality, RSSI and
Idle time.
* Mac address: If the association is pending (that is, the
Client is scanning, authenticating or associating), assocAddress
contains the MAC address of that Client with the group bit set
to indicate that the Access Point is aware of the presence of
that Client. The other objects of the entry will be updated
based on the information extracted from the received Probe
Requests.
* Link Quality: An indicator for the quality of the Client. If
the association is still pending, the quality is calculated over
the received Probe Requests from the Client. If the Client is
associated, the quality derived from any activity with the
Client. The actual quality source depends on the selected
quality indicator. The semantics of the indicator is ’low is
good quality’ and ’high is bad quality’.
* IdleTime: An indicator (in seconds) for the age of the
information on the Client. The age is reset to 0 if any activity
of this Client is detected.
* RSSI: An indicator for the RSSI of the Client. If the
association is still pending, the RSSI is calculated over the
received Probe Requests from the Client. If the Client is
associated, the RSSI derived from any activity with the Client.
* Client stations Status: status 3 - normal connected, status 9
- awaiting authorization.
KnownAP
By using option APs from info menu you may see all Access Points
thats visible by your AP.
* Link Quality: An indicator for the quality of the Client.
If the association is still pending, the quality is
calculated over the received Probe Requests from the Client. If
the Client is associated, the quality derived from any
activity with the Client. The actual quality source depends
on the selected quality indicator. The semantics of the
indicator is ’low is good quality’ and ’high is bad quality’.
* RSSI: An indicator for the RSSI in dBm of the Client. If
the association is still pending, the RSSI is calculated
over the received Probe Requests from the Client. If the
Client is associated, the RSSI derived from any activity with
the Client.
* WARNING! By reports this option my be dangerously - in some
cases you may lost you AP configuration and on SMC2655W the one
way to fix it - only restore factory defaults.
Config/
Bridging
IP configuration - If the server site supports DHCP
function and the DHCP Enable box is ticked; the IP address of
an access point will be automatically displayed and assigned;
otherwise, you need to key in an IP address now. The
primary port provides a wired or wireless method to change the
access point setting. If the Ethernet option is ticked, the
setting of an access point can be done through Ethernet. If the
Wireless option is ticked, the access point function can be set
through a wireless station. Wireless station means a laptop PC
or a desktop PC equipped with an IEEE802.11b PCMCIA card or USB
dongle. Enable SNMP Traps enables the SNMP trap function.
You can view the records by using ap-trapd utility. You
are allowed to set your access point to be used as Access
point, Access point client, or Wireless bridge.
* Access Point - An internetworking device that seamlessly
connects wired and wireless networks together.
* Wireless bridge Point to point - The point-to-point wireless
bridge configuration uses two Wireless Bridge units to connect
two separate LANs. You must to fill in the Remote MAC Address
before your bridge-function-enable access point can work with
it.
* Point to multipoint - When connecting three to more separate
LANs, each LAN located building requires a wireless bridge. This
is called Multipoint wireless bridge and again requires one
Master bridge unit and two or more Slave bridge units as
required. If the point-to-multipoint option is selected, your
bridge-function-enable access point will designate as a Mater
and to work with it, others bridges need to be set as a point-
to-point bridge and enter the MAC address of the mater access
point.
Wireless
You can give your access point a name and give it an ESSID
(Extended Service Station ID), which can allow other wireless
stations, which knows the ESSID, to link with it.
Privacy
The Privacy options allow you to enable 64-bit or 128-bit WEP
(wired equivalent privacy) encryption. If an encryption function
is not needed, you can just simply tick on the Disable box to
disable it. If the 64-bit or 128-bit encryption function is
enabled, there are four sets of key need to be filled into the
blanket boxes. For the 64-bit encryption, each key is required
to enter 5 Hex digits. For example: 11 22 33 44 55. The 128-bit
encryption requires each key to enter 13 Hex digits. For
example: 12 34 56 78 9A BC DE F0 11 22 33 44 55.
NOTE! The WEP keys you enter are really accepted and written to
the AP, permanently if you do an Upload from the Commands menu
after setting them. However, the new key values are not echoed
to the user when you return to the Privacy settings under the
Config menu. This is a security feature of SNMP implementation
in this hardware.
Authorized MAC address
For security or management purpose, you can edit a list of
authorized MAC addresses, which are allowed to view or modify
the setting of an access point. Authorization Table Enable
option allows you to enable or disable this function.
Community
The Community configuration allow you to set a phrase for
administrator and manufacturer community and a phrase for user
community. If a user knows the phrase of administrator, he/she
is authorized to change the setting of an access point. If a
user only knows about the phrase of a user community; he/she is
allowed to view the setting of an access point but is not
allowed to change the setting.
Radio Under the Radio user will be able to set or get the
Transmitting Powervalues, for the Control Register 31 of the
Baseband, for each channel. Reg CR31: Under this option user
defines a value for the transmitted power (Value for the Control
register 31 of the baseband) and it must be in the range 128
(max) to 255 (min) in Decimal form. Starting from version 0.6 of
Access Point SNMP Config utility it’s possible to set power
output level for your AP. You may set signal power output in
range from 0mw to 100mw by setting value for corresponding
channel from 0 to 255 (0xFF). The scale is as follows:
Value: 00----------128--------255
Power: 0mw--------100mw-------0mw
So to get maximum power output from your AP set value for
corresponding channel to 128 (0x80). But sometimes better
solution - experimentally choose values for best link quality,
sometimes not max. More info you can get from:
http://pasadena.net/aprf/;
http://www.wi2600.org/mediawhore/nf0/wireless/docs/802.11/WAP11/fun_with_the_wap11.txt.
Commands/
Upload After you ve changed any value or setting of an access point
through the SNMP config utility. You must come back to this
option to make the new changes and setting s validated. Also,
only an administrator and manufacturer is allowed to do such
changes.
Defaults
Restore factory default configuration.
Reset Reset AP. All changed and not uploaded settings will be lost.
TestMode/
When user selects the Tests option a form will appear
indicating a number of parameter needed to be set by the user in
order to perform the Radio test.
Antenna: Under this option we specify the antenna to be
tested (A, B).
Tx Filter: Under this option user needs to select the
Baseband transmitting Filter to be used. There are two options
(US, JPN) available since the bandwidth for Europe - USA is
11MHz and for, Japan is 14MHz.
Rate: Under this option user needs to specify the rate
to be used among the following options 1Mbps, 2Mbps, 5.5Mbps and
11Mbps.
Channel: Under this option user needs to select the
channel to be used. There are 14 channels available. After
setting the parameters there are three commands available:
Continuous Tx (with modulation), Continuous Tx (without
modulation) and Continuous Rx:
* Continuous Tx (with modulation): Using this command the MAC
sets the transmitter in continuous mode with modulation. We can
measure the output power of the radio.
* Continuous Tx (without modulation): Using this command we can
measure the frequency accuracy of the radio. The MAC sets the
baseband Processor in test mode and turns off the spreading and
scrambling codes.
* Continuous Rx: With this command user can set the device in a
receiving mode.
Note: In order to perform the above test user needs to have a
Spectrum Analyzer connected.
Connect/
In order to make a connection with Access Point user needs to
set two parameters. The IP Address of the Access Point and the
Community name (default ’public’).
Search/
Find connected Access Points. Search for WNW APs only works if
community set to right AP community. It’s useful if you know
community but dont know what ip your AP got from DHCP server.
You must have support for multicasting enabled in kernel.
About/ About function shows the Wireless Access Point Configurator for
Unix version and short info.
Shell/ Run subshell. To return type ’exit’
NAVIGATION KEYS
In case you unable to use cursor keys to menu navigate - try to use "h"
to go left, "j" to go down, "k" to go up, "l" to go right, like vi
editor.
AUTHOR
Roman Festchook <roma@polesye.net>
http://ap-utils.polesye.net
SEE ALSO
ap-trapd(8), ap-mrtg(8), ap-config(8)
Wireless Access Point Utilities for Unix ap-gl(8)