Provided by: ap-utils_1.5-5_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)