]> git.decadent.org.uk Git - ap-utils.git/blobdiff - README
Finalise 1.5-1
[ap-utils.git] / README
diff --git a/README b/README
index 4c9743b7c98ac8b1b6d4cd7b8f26baa43cea2930..0752f21da2bdb32a35e51e570fbd83def9588074 100644 (file)
--- a/README
+++ b/README
@@ -80,7 +80,7 @@ and usually comes with your SNMP management utility for Windows.
 | Ark                          | SOHO-WLAP             | ATMEL410             |
 | Asus                         | WL-300                | ATMEL410             |
 | Belkin Components            | F5D6130               | ATMEL410             |
-| BOSSLAN                      | BOSSWAP               | ATMEL12350,ATMEL410  |
+| BOSSLAN                      | BOSSWAP               | ATMEL12350, ATMEL410 |
 | CC&C Technologies            | Access Point          | ATMEL410             |
 | CNet                         | CNAP-711              | ATMEL410             |
 | Cameo Communications          | WLB-2000/2001                | ATMEL410             |
@@ -96,22 +96,22 @@ and usually comes with your SNMP management utility for Windows.
 | GemTek                       | TEW-210APB            | ATMEL410             |
 | GemTek                       | WX-1500               | NWN                  |
 | GigaFast                     | WF711-AP              | ATMEL12350           |
-| Global Sun                   | ProWave GL2411AP      | ATMEL410             |
+| Global Sun Technology                | ProWave GL2411AP      | ATMEL410             |
 | i-Tec                                | AP SILVER             | ATMEL410             |
-| i-Tec        (Tellus A13 rebranded)  | AP GOLD (blue front)  | ATMEL410             |
-| i-Tec        (Tellus A14 rebranded)  | AP GOLD (black front) | ATMEL12350           |
+| i-Tec        (Tellus A13 OEM)        | AP GOLD (blue front)  | ATMEL410             |
+| i-Tec        (Tellus A14 OEM)        | AP GOLD (black front) | ATMEL12350           |
 | Infosmart                    | INAP88                | ATMEL410             |
 | Intellinet                   | AP, Wireless Bridge   | ATMEL410             |
 | InterEpoch                    | IWE1000A              | ATMEL410             |
-| Linksys                      | WAP11 pre2 version    | ATMEL410             |
+| Linksys (GL2411AP OEM)       | WAP11 pre2 version    | ATMEL410             |
 | Micronet                     | SP918                 | ATMEL410             |
 | Netgear                      | ME102                 | ATMEL12350, ATMEL410 |
 | OSBRiDGE                      | m2410                 | ATMEL12350           |
 | OSBRiDGE                      | p2410                 | ATMEL12350           |
-| OSLiNK                       | M2410, P2410, P2410i  |                      |
+| OSBRiDGE                      | p2410i                | ATMEL12350           |
 | Ovislink                     | Airlive WL-1100AP     | ATMEL410             |
 | SMC                          | MC2655W               | ATMEL410             |
-| Smartbridges                 | airPoint PRO          | ATMEL410             |
+| smartBridges                 | airPoint, airBridge   | ATMEL410             |
 | SparkLAN (Gemtek subs.)      | WX-1590               | ATMEL410             |
 | SparkLAN (Gemtek subs.)      | WX-1590L              | ATMEL12350           |
 | Svec                         | FD1811                | ATMEL12350, ATMEL410 |
@@ -135,6 +135,7 @@ for features that are common to 2 or more MIBs with the same enterprise
 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 different set of operational modes.
 The first MIB type comes with firmware referred to as 'Access Point firmware'
@@ -154,9 +155,14 @@ 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!
+
 The only thing you may eventually use "WA" firmware for, is to downgrade
 your device to "AP" firmware with number lower than the one used previously
-- see below.
+- see below. This applies to devices with RFMD radio only.
+
+To understand firmware naming schemes better, it is highly recommended
+that you'll read the ap-tftp manpage.
+
 
 WARNING 2: Users of Tellus A14 and its OEM versions (Wline A14, Veriplus
 WL-A14, etc. - generally all AP types with ATMEL12350 MIB, equipped with
@@ -166,9 +172,29 @@ 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. More on firmware upgrade subject see next section.
 
+
+WARNING 3: Users of smartBridges equipment ("airPoint" and "airBridge"
+models): pay close attention to the WARNING 1 - only the "AP" firmware
+is supported! Do not expect "airBridge" models with their native
+firmware to work properly with ap-utils - only "airPoint" device
+firmware is supported. Future support for "airBridge" device firmware
+is very unlikely, becouse it really supports a subset of "airPoint"
+(AP) firmware functionality.
+
+All named devices use identical hardware with differences only in
+in connector types used, casing and use of industrial-grade components.
+This also means that the firmware for "airPoint" and "airBridge" models
+could be used interchangeably among these kinds of devices, however,
+loading of airPoint firmware into airBridge device has not been verified
+yet, so unless this warning disappears or states otherwise, flashing
+your (airBridge) device with AP firmware for different (airPoint)
+model (in order to gain ap-utils support) is discouraged.
+
+
 Firmware available free of charge for ATMEL12350 MIB devices:
 -------------------------------------------------------------
 If you own device that is detected as 'ATMEL12350 MIB' by ap-utils, chances
@@ -195,17 +221,22 @@ it would satisfy the following (SATISFYING ALL POINTS IS MANDATORY!):
 
 Should it satisfy all three points above, you may now perform upgrading.
 
-0. READ MANPAGE FOR ap-tftp !!!
+0. READ ENTIRE MANPAGE FOR ap-tftp !!!
+
+1. download the AP firmware (*.rom files) by EZYNET from one of the following
+   URLs:
 
-1. download the AP firmware (*.rom files) by EZYNET from the following URL:
    ftp://ftp.unob.cz/pub/firmware/wlan/atmel+rfmd/
 
+   http://www.e-zy.net/  (descend through sections: Support -> AT510 based
+   units -> Firmware -> AP)
+
 2. perform AP upgrade either by original windows-based ATMEL tftp client,
    or by 'ap-tftp' utility supplied with ap-utils:
 
    First, upgrade with 0.2.0.20.rom image. This one is so-called 'backup'
    firmware. It lacks (needless) web, and is activated only if so-called
-   'primary firmware fails for some reason.
+   'primary' firmware fails for some reason.
 
    Second, upgrade with 0.2.2.20.rom image. This is the 'primary' firmware
    with web interface (which you apparently wont use at all).
@@ -224,7 +255,7 @@ Should you need firmware downgrade for any reason, it is possible, provided
 that you have the original firmware *.rom file(s) for your devices.
 If your firmware was 0.2.2.19 or lower, you'll also need to temporarily
 upgrade to the following WA firmware, which will allow you to subsequently
-upgrade to AP firmware release with lower number than (EZYNET's) 0.2.2.20:
+downgrade to AP firmware release with lower number than (EZYNET's) 0.2.2.20:
 
 http://www.sparklan.com/Downloads/11b/AP/WX-1590_Client-Mode/Firmware/
 Client_Mode_firmware_WX-1590_v0.3.2.6.zip
@@ -251,10 +282,14 @@ in as broad number of its features as possible.
 
 Where to get more information
 -----------------------------
-You can find info about utils from this README and from man pages
-for utilites; as well as in INSTALL and TODO files at toplevel directory.
+You can find info about utilities from this README and from respective
+man pages (see Documentation directory), as well as from INSTALL and TODO
+files in the toplevel directory.
+Documentation/FAQ file may be of some interrest to you too.
 Additional info and useful links may be found in the Documentation
 directory of this package and on our web page http://ap-utils.polesye.net/ .
+Note, however, that informations on the web may somewhat lag behind this
+source.
 You may also peek into ChangeLog file if you are more of a technical person,
 for a list of changes and developer notes.
 We also run maillist to discuss any related topics - for more info please