Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
WLCONFIG(8)             FreeBSD System Manager's Manual            WLCONFIG(8)

     wlconfig -- read/write wavelan config parameters

     wlconfig ifname [param value ...]

     The wlconfig utility can be used to read and set parameters for the
     NCR/AT&T Wavelan radio LAN card.  Various parameters stored in the non-
     volatile Parameter Storage Area (PSA) on the card can be modified with
     this program, replacing the DOS-based instconf.exe program.  It can also
     be used to interrogate the optional signal strength cache which may have
     been compiled into the driver.

     The ifname parameter specifies the wavelan interface name (eg.  wl0).  If
     no other arguments are supplied, the current contents of the PSA are
     interpreted and displayed.

     The param and value arguments can be used to change the value of several
     parameters.  Any number of param value pairs may be supplied.

           param            value

           irq              IRQ value (used at next reset), may be one of

           mac              Local MAC value (ethernet address).

           macsel           `soft' (as set by the `mac' parameter) or
                            `default' (as set at the factory).

           nwid             The NWID is a 2-byte parameter passed to the
                            card's radio modem.  NWIDs allow multiple logi-
                            cally discrete networks to operate independently
                            whilst occupying the same airspace.  Packets with
                            a different NWID are simply ignored by the modem.
                            In the hardware, NWIDs are stored long-term in
                            non-volatile memory (called the PSA or pro-
                            grammable storage area), and are loaded by soft-
                            ware into the radio modem when the driver is ini-
                            tialized.  This sets the default NWID loaded at

           currnwid         This sets the current operating NWID (but does not
                            save it to the PSA).

           cache            The driver may maintain a per interface fixed size
                            cache of signal strength, silence, and quality
                            levels, which are indexed by sender MAC addresses.
                            Input packets are stored in the cache, and when
                            received, the values stored in the radio modem are
                            interrogated and stored.  There are also two
                            sysctl values (iponly and multicast only) which
                            can be used for filtering out some input packets.
                            By default, the cache mechanism stores only non-
                            unicast IP packets, but this can be changed with
                            sysctl(8).  Each non-filtered input packet causes
                            a cache update, hence one can monitor the antennae
                            signal strength to a remote system.  There are
                            three commands that can be given as values: `raw',
                            which prints out the raw signal strength data as
                            found in the radio modem hardware value, `scale',
                            which scales the raw hardware values to 0..100%,
                            and `zero' which clears out the cache in case you
                            want to store new samples.

     Note that if the IRQ on the Wavelan card is incorrect, the interface will
     be configured, but will not function.  The wlconfig utility should then
     be used to reconfigure the card to a sensible value.

     Set the NWID to 0x1234:

     # wlconfig wl0 nwid 0x1234

     Show the current settings:

     # wlconfig wl0
     Board type            : ISA
     Base address options  : 0x300, 0x390, 0x3c0, 0x3e0
     Waitstates            : 0
     Bus mode              : ISA
     IRQ                   : 10
     Default MAC address   : 08:00:0e:20:3d:4b
     Soft MAC address      : 00:00:00:00:00:00
     Current MAC address   : Default
     Adapter compatibility : PC-AT 2.4GHz
     Threshold preset      : 1
     Call code required    : NO
     Subband               : 2425MHz
     Quality threshold     : 3
     Hardware version      : 0 (Rel1/Rel2)
     Network ID enable     : YES
     NWID                  : 0xdead
     Datalink security     : NO
     Databus width         : 16 (variable)
     Configuration state   : unconfigured
     CRC-16                : 0x3c26
     CRC status            : OK

     Print a scaled version of the signal strength cache:

     # wlconfig wl0 cache scale

     wl(4), sysctl(8)

     This implementation of the wlconfig utility is completely new, written
     for Hilink Internet by Michael Smith, and updated by Jim Binkley &c.

FreeBSD 4.10                   December 26, 1996                  FreeBSD 4.10


Want to link to this manual page? Use this URL:

home | help