4.Os 5.Dt WLCONFIG 8 6.Sh NAME 7.Nm wlconfig 8.Nd read/write wavelan config parameters 9.Sh SYNOPSIS 10.Nm 11.Ar ifname 12.Op Ar param value ... 13.Sh DESCRIPTION 14The 15.Nm 16command can be used to read and set parameters for the NCR/AT&T Wavelan 17radio LAN card. Various parameters stored in the nonvolatile Parameter 18Storage Area (PSA) on the card can be modified with this program, which 19obviates the need for the DOS-based 20.Nm instconf.exe 21program. It can also be used to interrogate the optional signal 22strength cache which may have been compiled into the driver. 23.Pp 24The 25.Ar ifname 26parameter specifies the wavelan interface name (eg. 27.Pa wl0 28). If no other arguments are supplied, the current contents of the PSA 29are interpreted and displayed. 30.Pp 31The 32.Ar param 33and 34.Ar value 35arguments can be used to change the value of several parameters. 36Any number of 37.Ar param value 38pairs may be supplied. 39.Bl -tag -width 15n -compat -offset indent 40.It Va param 41.Va value 42.It irq 43IRQ value (used at next reset), may be one of 3,4,5,6,10,11,12,15. 44.It mac 45Local MAC value (ethernet address). 46.It macsel 47.Sq soft 48(as set by the 49.Sq mac 50parameter) or 51.Sq default 52(as set at the factory). 53.It nwid 54The NWID is a 2-byte parameter passed to the card's radio modem. 55NWIDs allow multiple logically discrete networks to operate 56independantly whilse occupying the same airspace. 57Packets with a different NWID are simply ignored by the modem. 58In the hardware, NWIDs are stored long-term in non-volative memory 59(called the PSA or programmable storage area), and are loaded by 60software into the radio modem when the driver is 61initialized. This sets the default NWID loaded at startup. 62.It currnwid 63This sets the current operating NWID (but does not save it to the 64PSA). 65.It cache 66The driver may maintain a per interface fixed size cache of signal strength, 67silence, and quality levels, which are indexed by sender MAC addresses. 68Input packets are stored in the cache, and when received, the values 69stored in the radio modem are interrogated and stored. 70There are also two sysctl values (iponly and multicast only) which 71can be used for filtering out some input packets. By default, the 72cache mechanism stores only non-unicast IP packets, but this can 73be changed with 74.Xr sysctl 8 . 75Each non-filtered 76input packet causes a cache update, hence one can monitor 77the antennae signal strength to a remote system. 78There are three commands that can be given as values: 79.Sq raw , 80which prints out the raw signal strength data as found in the radio 81modem hardware value, 82.Sq scale , 83which scales the raw hardware values to 0..100%, and 84.Sq zero 85which clears out the cache in case you want to store new samples. 86.El 87.Pp 88Note that if the IRQ on the Wavelan card is incorrect, the interface 89will be configured, but will not function. The 90.Nm 91program should then be used to reconfigure the card to a sensible 92value. 93.Sh EXAMPLES 94Set the NWID to 0x1234 : 95.Bd -literal -offset 96# wlconfig wl0 nwid 0x1234 97.Ed 98.Pp 99Show the current settings : 100.Bd -literal -offset 101# wlconfig wl0 102Board type : ISA 103Base address options : 0x300, 0x390, 0x3c0, 0x3e0 104Waitstates : 0 105Bus mode : ISA 106IRQ : 10 107Default MAC address : 08:00:0e:20:3d:4b 108Soft MAC address : 00:00:00:00:00:00 109Current MAC address : Default 110Adapter compatibility : PC-AT 2.4GHz 111Threshold preset : 1 112Call code required : NO 113Subband : 2425MHz 114Quality threshold : 3 115Hardware version : 0 (Rel1/Rel2) 116Network ID enable : YES 117NWID : 0xdead 118Datalink security : NO 119Databus width : 16 (variable) 120Configuration state : unconfigured 121CRC-16 : 0x3c26 122CRC status : OK 123.Pp 124Print a scaled version of the signal strength cache : 125.Bd -literal -offset 126# wlconfig wl0 cache scale 127.Ed 128.Sh SEE ALSO 129.Xr wl 4 , 130.Xr sysctl 8 131.Sh HISTORY 132This implementation of the 133.Nm 134command is completely new, written for Hilink Internet by 135.An Michael Smith , 136and updated by 137.An Jim Binkley &c .
|