	wlu - Wireless Lan Card Configuration Utility

SYNOPSIS
	wlu  interface command command_argv1 command_argv2

DESCRIPTION
	Wlu is used to query and set Planet WL2400 cards' configuration. To 
	run wlu is necessary to have compiled device driver into kernel.

OPTIONS
	Wlu  accepts the following commands, some of them need one or 
	more arguments.

       Command   Available Argument(s):
       query
       set CHANNEL NETWORKTYPE LLCTYPE ESSID
       security  on/off/status 
       key XX:XX:XX:XX:XX:XX/default   SECRET/nokey/delete	
       monitor   on/off/list
       reset  now
       firmware  FILENAME


COMMANDS DESCRIPTION

Command Query

wlu ethx query

Display current set of card - ESSID, channel, Network type and LLC type. No 
action is done. 

Command Set 
wlu ethx set CHANNEL NETWORKTYPE LLCTYPE ESSID

Set working parameters for card and re-start BSS scan. 

CHANNEL - set default channel. Depend on national frequency domain. 
Value is number: 1-14.
NETWORKTYPE - set network working mode into Infrastructure or Ad-hoc. 
Infrastructure mode is for co-operation with access points (AP). Ad-hoc mode 
is for communication with all other stations set in Ad-hoc mode. Ad-hoc mode 
does not need any Access point. Cards set in Infrastructure mode does not 
communicate with cards set in Ad-hoc mode. 
Values are:  infra, adhoc
LLCTYPE -  Sets ethernet to 802.11 frame conversion. Possible options are 
WaveLan frames (RFC1042?) or AMD PC-Net Mobile.  
Values are:  wavelan, pcnet
ESSID - set ESSID name. Max 30 characters, without spaces. Case sensitive! Must 
be set on all cards same.  
Value: any text



Command Security
wlu ethx security SWITCH

Sets security function or show current status of security functions. 
SWITCH - sets security to be active, inactive or list the status. If is sets 
to off all keys and no encryption is done on transmited or decryption on 
decrypted packets. 
Values: on, off, list

Command Key

wlu ethx key ARGUMENT  SWITCH

Sets encryption keys and behavior of encryption routines.

ARGUMENT - select exact MAC address of opposite side for encrypted or 
unencrypted connection. Value can be exact MAC address in format 
xx:xx:xx:xx:xx:xx or word "default" which means all destination 
addresses including broadcasts, which are not mentioned in key list. 
Values:  valid MAC address in format xx:xx:xx:xx:xx:xx,  default

SWITCH - adding, deleting or switching off encryption key into/from key 
list database. Encryption keys added into list are used for all packets 
with specified destination/source addresses. As secret word can 
be used any string up to 16 characters (recommended). Length of secret 
word does not have influence on speed of encryption. Usage of key can be 
avoided by switch value "delete" which remove destination/source address 
from database. Switch "nokey" means, that no encryption/decryption is done 
for this destination/source address. Typically used in conjunction with 
units WAP-900.
Values:  any text without spaces counted as secret word, delete, nokey

Example: wlu eth1 key 00:00:12:34:56:78 secretword
All packet send to address 00:00:12:34:56:78 will be encrypted with key 
"secretword" and all packets received from 00:00:12:34:56:78 will be 
decrypted with key "secretword".

Command Monitor

wlu ethx monitor SWITCH

Display RSSI  (Radio Strength Signal Indicator) for all incoming packets. 

SWITCH - "on" sets monitoring informations available, "off" sets monitoring 
functions off and no dynamic list is constructed. "list" show current 
status. 
Please note, that RSSI value showed in table is value of last incoming 
packet from listed MAC address. It is not immediate state. All packets 
which go through is remember for all time till you close driver. Therefore 
when you measure RSSI f.e. when you are doing antenna alignment you should 
initiate  some date transfer (e.g. ping).  
Values: on, off, list


Command Reset
wlu ethx reset now

Reset firmware on the card. Sometimes can be useful if you think that card 
stops scan for unkown reason. 

Command Firmware

wlu ethx firmware FILENAME

Upgrading firmware. After upgrade is reboot necessary.  
FILENAME - filename of binary firmware file. Exact path is necessary.

WARNING - Flash ROM has limited write/erase cycles. Exceed the limitation,  
the Flash ROM gets out of order. In normal condition, it should have minimum 
100,000 write/erase cycles. 


RECOMMENDATIONS, NOTES

How card is working:
If you need detailed and exact explanation, please read IEEE802.11. Simply 
explained - when drivers is opened it starts scan for Access Point (in 
Infrastructure mode) or scan for any Station Adapter claimed to be Access 
Point. If ESSID match with ESSID of AP or STA it join to them (into IBSS 
domain). Then you can see message about it in kernel log. If adapter is in 
Ad-hoc mode and did not find any STA with same ESSID it will claim to be AP 
for his ESSID (you will see a message "Join delayed Own IBSS."). Have to be 
mentioned that in Infrastructure mode is authentication done and in Ad-hoc 
mode does not. However authentication in Infrastructure mode is implemented 
only for Open-system, which means, that no password or encryption is done. 
Therefore to use Ad-hoc mode and security features, which are implemented in 
this driver is much secure :). So much, that is very hard to decrypt any 
packet, because 128 bit encryption key is used and encryption algorithm is 
very safe. Much more RC4-40 bit, usually used in WEP.


Startup script:
Command ifconfig is opening card driver with default parameters ESSID 'ANY', 
channel 3, Infrastructure mode, LLC type WaveLAN. Security is off.
Therefore for your network with some ESSID, channels etc. is necessary to run 
commands set, security, key etc. each time after start. Some starting script 
is good choice.

Cards need to be set into same ESSID, Network Type and LLC Type:
Please note that cards will not connect together if their ESSIDs are different 
or Network types are different or LLC Type are different or you made a mismatch 
of security keys.

Channels:
If you have set different channels on cards than note: Access Point or STA which 
start first and claimed to become "AP" will set channel for all IBSS domain. All 
other card connected to him chooses same channel automatically, does not matter 
what channel have originally set.
Ad-hoc connection:
When you have setup two or more computers in Ad-hoc mode and both of them 
claimed to became own IBSS (message "Join delayed. Own IBSS.") and would not 
connect to each other the problem is:
a] Different ESSID  - set ESSIDs same on all units.
b] You release command "./wlu ethx set " or  "ifconfig ethx " when units was not 
able reach to other due some RF problem. Typically you power up units when 
antennas was disconnected. Connect antennas and make "wlu ethx set ..."  command 
again. It will push driver to re-scan area for existing IBSS and should claim 
that is joined after a several seconds. 
Now you can start manipulate with antennas again, because unit now know to which 
IBSS belongs and will not refuse communicate with this. (IBSS is in ad-hoc mode 
random number, which is generated by card, became an AP). This is not a bug! 
This is matter of Ad-hoc mode.

Aspects of usage default key:  
When is default key active and unencrypted connection is necessary for some MAC 
addresses (typically with WAP-900) you have to set their address statically into 
ARP table. Reason is that with default keys active are all broadcast also 
encrypted.
Example: arp -i eth1  -s 192.168.1.100  00:12:34:56:78:90


EXAMPLES

Sets card into Ad-hoc mode without any security functions:
wlu eth1 3 adhoc wavelan WIRELESSLAN


Sets card into Ad-hoc mode with security, default key:
wlu eth1 3 adhoc wavelan WIRELESSLAN
wlu eth1 key default PASSWORD12345678
wlu eth1 security on

Sets card into Ad-hoc mode with security, without default key. Address 
00:00:12:34:56:78 could be some station with WL-2400 with same driver and key:
wlu eth1 3 adhoc wavelan WIRELESSLAN
wlu eth1 key default nokey
wlu eth1 key 00:00:12:34:56:78 PASSWORD12345678
wlu eth1 security on 


Sets card into Ad-hoc mode with security, with default key. Address 
00:00:12:34:56:78 could be for example some station behind WAP-900. 
Arp static set is necessary:
wlu eth1 3 adhoc wavelan WIRELESSLAN
wlu eth1 key default DEFAULT12345
wlu eth1 key 00:00:12:34:56:78 nokey
arp -i eth1  -s 192.168.1.100  00:00:12:34:56:78
wlu eth1 security on 


Get list of RSSI values:
wlu eth1 monitor list

Get security status:
wlu eth1 security status


BUGS, REPORTS
Bugs and suggestion report to hemzal@asm.cz

Known bugs:
- Command reset sometimes refuses to work due firmware hang up! I am sorry, 
till no idea why. Therefore be careful to use reset command, because could 
hang up whole system.
- LLC Type "pcnet" sometimes crashing. Till is problem solved I do not 
recommend to use them
