WLU(1)  Z-Com R&D Group WLU(1) NAME

wlu - Z-Com Wireless Lan Card Configuration Utility

SYNOPSIS

wlu interface cmd1 cmd1_argv1 [cmd2 cmd2_argv1 cmd2_argv2 ...]

DESCRIPTION

Wlu is used to query and set WL24xx cards' configuration. It is not designed
for replacing WLU.EXE of DOS version, but just for providing a convenient
way to configure WL24xx cards within Un*x environment.

To run wlu , the device driver must provide additional support for it. Thus,
I suggest shutting down the network device by ifconfig before using the
utility, even though it had been carefully designed to harmonically work
with running interface.

OPTIONS

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

Command  Available Argument(s) ---------------------------------------------------------- 
version  query 
reset  now 
flash  write 
channel query / 1-12 
speed  query / 1 (1 Mbps) / 2 (2 Mbps) 
mode  query / 1 (adhoc) / 2 (infrastructure) 
roaming query / 0 (off) / 1 (on) 
BSSID  query / 00 00 00 00 00 00-FF FF FF FF FF FF 
ESSID  query / 000000-999999 
security query / 000000-999999 (on) / -1 (off) 
monitor query / 00 00 00 00 00 00-FF FF FF FF FF FF 

Command monitor is used to monitor RSSI (Receive Signal Strength Indication)
of incoming packet. You may set an ethernet source address to monitor its
RSSI. The address can not be written into Flash ROM, and will be zero after
the driver is reset.

You must be aware of the sequence of setting commands are important. For
example, if you turn on roaming before setting ESSID , then it is possible
to hang the device.

Some commands are relative. You must take care of them. e.g.

 Infrastructure mode <-> roaming 
 roaming <-> BSSID 
 roaming <-> ESSID 

To understand the relationship, please refer WLU.EXE of DOS version. Before
applying command flash , all changes you made will only apply to the driver
and device temporarily. If you either use command reset to reset them or
reset the computer, the data in flash ROM will replace current setting.

Some commands take effect only if you reset the device again. So, to ensure
the change you made takes effect, always append flash write reset now after
them.

Z-Com Taiwan  1 March 1998 1

WLU(1)  Z-Com R&D Group WLU(1) EXAMPLES

1. To get driver's current version, channel, speed, and mode setup:

wlu eth1 version query channel query speed query mode query 

2. To set card to channel 7 temporarily 

wlu eth1 channel 7

3. Set to channel 7, then write current setup into Flash ROM, and reset
driver and device

wlu eth1 channel 7 flash write reset now

4.Set roaming on and set ESSID 123456, write to card and reset. (Notice the
sequence of roaming and ESSID...)

wlu eth1 ESSID 123456 roaming 1 flash write reset now

5. Set roaming off and set BSSID 00 60 B3 1A 2B 3C, write to card and reset.
(Notice the sequence of roaming and BSSID...)

wlu eth1 BSSID 00 60 b3 1a 2b 3c roaming 0 flash write reset now

WARNNING

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.

AUTHORS

Z-Com R & D Groups, Taiwan.

Z-Com Taiwan  1 March 1998 2