1 files changed, 56 insertions, 7 deletions

diff --git a/noncore/net/wellenreiter/README b/noncore/net/wellenreiter/README
index 4ed5c28..c04d30c 100644
--- a/noncore/net/wellenreiter/README
+++ b/noncore/net/wellenreiter/README
@@ -1,37 +1,86 @@
 /*************************************************************************/
 /*                W e l l e n r e i t e r   I I                          */
 /*               ===============================                         */
 /*                                                                       */
 /*                                                  Version: Opie-ALPHA  */
 /*************************************************************************/
 
+--------------------------------------------------
 Release Notes for Opie-ALPHA Version December 2002
 --------------------------------------------------
 
+=====================
 = Supported Devices =
+=====================
 
 * low-level orinoco_cs-based (including prism2 and spectrum_cs)
 
-= Build =
+* Supported Interfaces: wlan0 (yes, I know this is hardcoded and
+  lame, but we're in a hurry and this can be configured soon...)
+
+=====================
+=      Build        =
+=====================
 
 To compile Wellenreiter within the Opie build environment, add the
 following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS='
 
 noncore/net/wellenreiter/libwellenreiter \
 noncore/net/wellenreiter/daemon \
 noncore/net/wellenreiter/contrib/orinoco_hopper \
 noncore/net/wellenreiter/gui
 
-./configure and rebuild.
+./configure and rebuild. Note that you need libpcap in your toolchain.
+
+=====================
+=     Install       =
+=====================
+
+Alternatively, you can use our precompiled ipk. Get it from
+http://opie.net.wox.org/elan/current. You will also need libpcap.
+
+=====================
+=       Run         =
+=====================
+
+1. Place card in monitor mode. This is device dependent.
+
+   Caution: Don't do this while you're logged in via ssh
+   or otherwise using the wireless interface - your connection
+   will freeze: The card can't be used normally when sniffing!
+
+   For most orinoco-based cards this can be done using
+   'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'.  
+   
+   You can check if this works, by calling 'ifconfig <interface>'.
+   If you see 'Protocol: UNSPEC' and an unusual long MAC-Address,
+   then your card has been successfully set to the monitor mode.
+
+2. Start a channel hopper. A wireless card has several channels
+   (e.g. radio frequencies) here it can listen for beacons.
+   Beacons are management data frames from other stations.
+   Remember, this is radio transmission, so the card has to be
+   "tuned" to a certain channel to be able to receive the beacons.
+   
+   In order to scan the complete frequency spectrum and thus be able
+   to detect all available stations, you have to 'hop' through the
+   channels frequently. You can do this manually (e.g. with 'iwconfig')
+   [hahaha] or you can use a channel hopper.  
+   
+   For convenience, the current Wellenreiter Alpha comes with a 
+   channel hopper for Orinoco-based cards. Start this via 
+   orinoco_hopper <interface>.
 
-= Run =
+3. Start the Wellenreiter sniffing daemon: wellenreiterd.
 
-1. Place card in monitor mode: iwpriv <interface> 2 1
-2. Start $OPIEDIR/bin/orinoco_hopper <interface>
-3. Start Wellenreiter
+4. Start the Wellenreiter GUI and sniff like hell. Don't press the button
+   "Start Scan" yet, because it enables the demo mode and will crash the
+   wellenreiterd daemon if running.
 
-= Credits =
+=====================
+=     Credits       =
+=====================
 
 Sniffer: Max Moser <max@remote-exploit.org>
 Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org>
 GUI: Michael Lauer <mickeyl@handhelds.org>