About
-----
Wireless Access Point Utilites for Unix - it's a set of utilites to configure
-and monitor Wireless Access Points under Unix using SNMP protocol. Utilites
+and monitor Wireless Access Points in Unix using SNMP protocol. Utilites
are known to compile and run under Linux, FreeBSD, NetBSD, MacOS-X, AIX,
QNX and OpenBSD.
Supported Hardware
------------------
-ap-utils support Atmel chipset based Access Points with ATMEL Private MIB
-with enterprises ID 410 (ATMEL410), Access Points with newer ATMEL Private
-MIB with enterprises ID 12350 (ATMEL12350) such as Netgear ME102,
-and No Wires Needed APs with IEEE 802.11 MIB and NWN DOT11EXT MIB
+ap-utils support Atmel chipset based Access Points with ATMEL private MIB
+with enterprises ID 410 (ATMEL410), Access Points with newer ATMEL private
+MIB with enterprises ID 12350 (ATMEL12350) such as Netgear ME102 and Tellus
+A14, and No Wires Needed APs with IEEE 802.11 MIB and NWN DOT11EXT MIB
(NWN).
You can find Known/Reported-to-work hardware in the table below.
If you have had success with ap-utils working with a hardware thats
| Wline | W-2000 | ATMEL410 |
+-------------------------------+-----------------------+----------------------+
-Please read also HARDWARE-NOTES about hardware-specific information!
-
Please note that although many of these devices may use the same MIB enterprise
identification, the actual MIBs may slightly differ, depending on whether
the manufacturer has decided upon hardware modifications.
ID. If you have qualms, then please send us the MIB file that came
with your device!
+WARNING 1: There actually exist two different kinds of ATMEL private MIBs,
+regardless of its enterprise ID - each with a different set of operational
+modes.
+One type the private MIB comes with is often referred to as "Access Point"
+firmware, often marked with shortcut "AP". Another one is referred to as
+"Wireless Adapter firmware", marked with shortcut "WA".
+"WA" firmware has questionable advantage that it is claimed to allow APs
+equipped with this firmware to connect with non-ATMEL-based APs of other
+manufacturers using "AP-client (Infrastructure)" mode (in reality, this is,
+unfortunately, often false), at cost of supporting no true "AP" mode
+(only Ad-Hoc and AP-client modes are available).
+
+Whenever you can, use firmware labelled as "AP" and not "WA".
+"AP" version supports most networking modes, compared to "WA" version.
+MIBs AND FIRMWARES WITH "WA" LABEL ARE NOT SUPPORTED WITH AP-UTILS!
+They may appear to _partially_ work with ap-utils, but you
+can cause harm to your AP if you use ap-utils with such firmware.
+Do not complain if you use ap-utils with such firmware and it damages
+your AP!
+
+WARNING 2: Users of Tellus A14 and its OEM versions (Wline A14, Veriplus
+WL-A14, etc. - ATMEL12350 AP "types"): Beware. Firmwares up to (including)
+version 0.2.2.19 for these APs contain a SERIOUS BUG that may
+result in unpredictable and persistent lock-up of your AP, when configured
+over SNMP or even via its web interface. There's unfortunately no way
+of how to "resurrect" such a locked-up AP - the only option is to return
+the AP to its supplier for replacement.
+To be on the safe side, we recommend everyone to upgrade to any firmware
+version above 0.2.2.19. At the time of this writing,
+you should be able to download firmware v. 0.2.2.21 including
+the corresponding TFTP utility for example from the following link:
+
+http://www.sparklan.com/download.htm
+
+or send your AP to its supplier for firmware replacement in case
+he's able to supply you with customarily enhanced firmware version
+above 0.2.2.19.
+
+Frequently Asked Questions
+--------------------------
+
I got an AP and I would like ap-utils to support it (it is not on the
---------------------------------------------------------------------
list above)
projects / ap-utils.git / blobdiff