Provided by: ap-utils_1.5-3_amd64 bug

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)