| wl.4 (79538) | wl.4 (79727) |
|---|---|
| 1.\" 2.\" Copyright (c) 1997, Jim Binkley 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 14 unchanged lines hidden (view full) --- 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" | 1.\" 2.\" Copyright (c) 1997, Jim Binkley 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 14 unchanged lines hidden (view full) --- 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" |
| 31.\" $FreeBSD: head/share/man/man4/man4.i386/wl.4 79538 2001-07-10 15:31:11Z ru $ | 31.\" $FreeBSD: head/share/man/man4/man4.i386/wl.4 79727 2001-07-14 19:41:16Z schweikh $ |
| 32.Dd July 7, 1997 33.Dt WL 4 i386 34.Os 35.Sh NAME 36.Nm wl 37.Nd T1 speed ISA/radio lan card 38.Sh SYNOPSIS 39.Cd "device wl0 at isa? port 0x300 irq 5" 40.Sh DESCRIPTION 41The 42.Nm 43driver controls a radio lan card system made originally by 44NCR, then ATT, now Lucent. The system is spread-spectrum radio 45at around 915 mhz (or 2.4 ghz). With the supplied omni-directional antennae, 46about 400 feet (indoors, more outdoors) can be covered in circumference. 47This card can talk to the companion (wlp0) pccard. Speeds vary 48from 1 megabit to theoretically 2 megabits (roughly T1 in speed). 49.Pp | 32.Dd July 7, 1997 33.Dt WL 4 i386 34.Os 35.Sh NAME 36.Nm wl 37.Nd T1 speed ISA/radio lan card 38.Sh SYNOPSIS 39.Cd "device wl0 at isa? port 0x300 irq 5" 40.Sh DESCRIPTION 41The 42.Nm 43driver controls a radio lan card system made originally by 44NCR, then ATT, now Lucent. The system is spread-spectrum radio 45at around 915 mhz (or 2.4 ghz). With the supplied omni-directional antennae, 46about 400 feet (indoors, more outdoors) can be covered in circumference. 47This card can talk to the companion (wlp0) pccard. Speeds vary 48from 1 megabit to theoretically 2 megabits (roughly T1 in speed). 49.Pp |
| 50The card has three fundamental hardware | 50The card has three fundamental hardware |
| 51units, a so-called PSA or programmable storage area, a radio modem, | 51units, a so-called PSA or programmable storage area, a radio modem, |
| 52and a ethernet lan controller. The latter component is the | 52and a ethernet lan controller. The latter component is the |
| 53ancient (and not very honorable) Intel 82586 ethernet chip. 54Fundamentally it appears to the operating system as an ethernet system, 55and speaks IEEE MAC addresses. The radio modem simply translates 56ethernet packets to/from radio packets, that are either at 2.4 Ghz 57or 915 mhz depending on the radio modem. It supports a collision 58avoidance scheme. The lan controller | 53ancient (and not very honorable) Intel 82586 ethernet chip. 54Fundamentally it appears to the operating system as an ethernet system, 55and speaks IEEE MAC addresses. The radio modem simply translates 56ethernet packets to/from radio packets, that are either at 2.4 Ghz 57or 915 mhz depending on the radio modem. It supports a collision 58avoidance scheme. The lan controller |
| 59supports promiscuous mode, broadcast, and multicasting | 59supports promiscuous mode, broadcast, and multicasting |
| 60(although there is a glitch | 60(although there is a glitch |
| 61in the latter). "It thinks it is ethernet". 62.Pp | 61in the latter). "It thinks it is ethernet". 62.Pp |
| 63How it is used 64depends on the kind of antennae deployed with it. Point to point 65applications are possible as are ethernet-like lan use. The vendor | 63How it is used 64depends on the kind of antennae deployed with it. Point to point 65applications are possible as are ethernet-like lan use. The vendor |
| 66ships an omni-directional antennae that works in the | 66ships an omni-directional antennae that works in the |
| 67vicinity of 400 feet (indoors). 68Point to point antennae can be purchased that will go miles. 69.Sh SETUP 70The card can either be initialized with the vendor supplied DOS setup software. 71Typically minimally an IRQ, port, and Network ID must be supplied. | 67vicinity of 400 feet (indoors). 68Point to point antennae can be purchased that will go miles. 69.Sh SETUP 70The card can either be initialized with the vendor supplied DOS setup software. 71Typically minimally an IRQ, port, and Network ID must be supplied. |
| 72Michael Smith's | 72Michael Smith's |
| 73.Xr wlconfig 8 74utility can now be used to do this work from 75the UNIX side. The card is "not" plug and play. 76The network id controls whether one set of cards can hear another. 77If different, cards will read physical packets, but they will be discarded 78by the radio modem. 79.Sh CONTROL 80In addition to the config utility, there are several sysctl 81switches that can be used to modify runtime parameters. | 73.Xr wlconfig 8 74utility can now be used to do this work from 75the UNIX side. The card is "not" plug and play. 76The network id controls whether one set of cards can hear another. 77If different, cards will read physical packets, but they will be discarded 78by the radio modem. 79.Sh CONTROL 80In addition to the config utility, there are several sysctl 81switches that can be used to modify runtime parameters. |
| 82The | 82The |
| 83.Xr sysctl 8 84variables are as follows: 85.Bl -diag 86.It "machdep.wl_xmit_delay <useconds>" 87This variable will cause the driver to insert a delay on transmit. 88250 is the default. The delay should probably be a bit longer 89on faster cpus and less on slower cpus. It exists because the 82586 90was not designed to work with pentium-speed cpu systems and if overdriven 91will have copious xmit side errors. 92.It machdep.wl_ignore_nwid <0 | 1> 93This switch defaults to 0; i.e., the nwid is not ignored. It can 94be set to 1 to cause the nwid to not be used. This may be useful 95when the device is in promiscuous mode as one can watch for all 96packets and ignore nwid differences. | 83.Xr sysctl 8 84variables are as follows: 85.Bl -diag 86.It "machdep.wl_xmit_delay <useconds>" 87This variable will cause the driver to insert a delay on transmit. 88250 is the default. The delay should probably be a bit longer 89on faster cpus and less on slower cpus. It exists because the 82586 90was not designed to work with pentium-speed cpu systems and if overdriven 91will have copious xmit side errors. 92.It machdep.wl_ignore_nwid <0 | 1> 93This switch defaults to 0; i.e., the nwid is not ignored. It can 94be set to 1 to cause the nwid to not be used. This may be useful 95when the device is in promiscuous mode as one can watch for all 96packets and ignore nwid differences. |
| 97.It machdep.wl_xmit_watch <milliseconds> | 97.It machdep.wl_xmit_watch |
| 98This switch is not currently useful. | 98This switch is not currently useful. |
| 99.It machdep.wl_gather_snr <milliseconds> | 99.It machdep.wl_gather_snr |
| 100This switch is not currently useful. 101.Pp 102There is also a signal strength cache in the driver. It may be interrogated 103with 104.Xr wlconfig 8 . 105Incoming packets 106are checked for certain hardware radio-modem values including signal 107strength, silence, and quality, which range fro 0..63, 0..63, and 0..15 | 100This switch is not currently useful. 101.Pp 102There is also a signal strength cache in the driver. It may be interrogated 103with 104.Xr wlconfig 8 . 105Incoming packets 106are checked for certain hardware radio-modem values including signal 107strength, silence, and quality, which range fro 0..63, 0..63, and 0..15 |
| 108respectively. Thus one can read out signal strenth values to see 109how close/far peer nodes are. The signal strength cache is indexed by | 108respectively. Thus one can read out signal strenth values to see 109how close/far peer nodes are. The signal strength cache is indexed by |
| 110sender MAC address. 111There are two sysctls that change how it filters packets. Both are on 112by default. | 110sender MAC address. 111There are two sysctls that change how it filters packets. Both are on 112by default. |
| 113.It machdep.wl_wlcache_mcastonly <0 | 1> | 113.It machdep.wl_wlcache_mcastonly <0 | 1> |
| 114By default this switch is on. 115It forces the cache to filter out 116unicast packets. Only broadcast or multicast packets are accepted. 117.It machdep.wl_wlcache_iponly <0 | 1> 118By default this switch is on. It forces the driver to discard non-IP 119packets and also stores the IP src address. ARP packets are ignored, 120as are any other network protocol barring IPv4 packets. 121.El --- 40 unchanged lines hidden --- | 114By default this switch is on. 115It forces the cache to filter out 116unicast packets. Only broadcast or multicast packets are accepted. 117.It machdep.wl_wlcache_iponly <0 | 1> 118By default this switch is on. It forces the driver to discard non-IP 119packets and also stores the IP src address. ARP packets are ignored, 120as are any other network protocol barring IPv4 packets. 121.El --- 40 unchanged lines hidden --- |