8 .Nd read/write wavelan config parameters
12 .Op Ar param value ...
13 .Sh DEPRECATION NOTICE
16 utility will be removed in
21 utility can be used to read and set parameters for the NCR/AT&T Wavelan
23 Various parameters stored in the non-volatile Parameter
24 Storage Area (PSA) on the card can be modified with this program, replacing
28 It can also be used to interrogate the optional signal
29 strength cache which may have been compiled into the driver.
33 parameter specifies the wavelan interface name (eg.
35 If no other arguments are supplied, the current contents of the PSA
36 are interpreted and displayed.
42 arguments can be used to change the value of several parameters.
45 pairs may be supplied.
46 .Bl -tag -width 15n -offset indent
50 IRQ value (used at next reset), may be one of 3,4,5,6,10,11,12,15.
52 Local MAC value (ethernet address).
59 (as set at the factory).
61 The NWID is a 2-byte parameter passed to the card's radio modem.
62 NWIDs allow multiple logically discrete networks to operate
63 independently whilst occupying the same airspace.
64 Packets with a different NWID are simply ignored by the modem.
65 In the hardware, NWIDs are stored long-term in non-volatile memory
66 (called the PSA or programmable storage area), and are loaded by
67 software into the radio modem when the driver is
69 This sets the default NWID loaded at startup.
71 This sets the current operating NWID (but does not save it to the
74 The driver may maintain a per interface fixed size cache of signal strength,
75 silence, and quality levels, which are indexed by sender MAC addresses.
76 Input packets are stored in the cache, and when received, the values
77 stored in the radio modem are interrogated and stored.
78 There are also two sysctl values (iponly and multicast only) which
79 can be used for filtering out some input packets.
81 cache mechanism stores only non-unicast IP packets, but this can
85 input packet causes a cache update, hence one can monitor
86 the antennae signal strength to a remote system.
87 There are three commands that can be given as values:
89 which prints out the raw signal strength data as found in the radio
92 which scales the raw hardware values to 0..100%, and
94 which clears out the cache in case you want to store new samples.
97 Note that if the IRQ on the Wavelan card is incorrect, the interface
98 will be configured, but will not function.
101 utility should then be used to reconfigure the card to a sensible
104 Set the NWID to 0x1234:
105 .Bd -literal -offset indent
106 # wlconfig wl0 nwid 0x1234
109 Show the current settings:
110 .Bd -literal -offset indent
113 Base address options : 0x300, 0x390, 0x3c0, 0x3e0
117 Default MAC address : 08:00:0e:20:3d:4b
118 Soft MAC address : 00:00:00:00:00:00
119 Current MAC address : Default
120 Adapter compatibility : PC-AT 2.4GHz
122 Call code required : NO
124 Quality threshold : 3
125 Hardware version : 0 (Rel1/Rel2)
126 Network ID enable : YES
128 Datalink security : NO
129 Databus width : 16 (variable)
130 Configuration state : unconfigured
135 Print a scaled version of the signal strength cache:
136 .Bd -literal -offset indent
137 # wlconfig wl0 cache scale
143 This implementation of the
145 utility is completely new, written for Hilink Internet by