Provided by: freebsd-manpages_8.2-1_all bug

NAME

     upgt -- Conexant/Intersil PrismGT SoftMAC USB IEEE 802.11b/g wireless
     network device

SYNOPSIS

     To compile this driver into the kernel, place the following lines in your
     kernel configuration file:

           device ehci
           device uhci
           device ohci
           device usb
           device upgt
           device wlan

     Alternatively, to load the driver as a module at boot time, place the
     following line in loader.conf(5):

           if_upgt_load="YES"

DESCRIPTION

     The upgt driver supports the USB 2.0 Conexant/Intersil PrismGT series
     wireless adapters based on the GW3887 chipset.

     These are the modes the upgt driver can operate in:

     BSS mode       Also known as infrastructure mode, this is used when
                    associating with an access point, through which all
                    traffic passes.  This mode is the default.

     monitor mode   In this mode the driver is able to receive packets without
                    associating with an access point.  This disables the
                    internal receive filter and enables the card to capture
                    packets from networks which it wouldn't normally have
                    access to, or to scan for access points.

     upgt supports software WEP.  Wired Equivalent Privacy (WEP) is the de
     facto encryption standard for wireless networks.  It can be typically
     configured in one of three modes: no encryption; 40-bit encryption; or
     104-bit encryption.  Unfortunately, due to serious weaknesses in WEP
     protocol it is strongly recommended that it not be used as the sole
     mechanism to secure wireless communication.  WEP is not enabled by
     default.

     The upgt driver can be configured at runtime with ifconfig(8).

FILES

     This driver requires the upgtfw firmware to be installed before it will
     work.  The firmware files are not publicly available.  A package of the
     firmware which can be installed via pkg_add(1) is available:

           http://weongyo.org/project/upgt/upgt-firmware-2.13.1.0.tar.gz

HARDWARE

     The upgt driver supports USB 2.0 Conexant/Intersil PrismGT series
     wireless adapters based on the GW3887 chipset, among them:

     +o   Belkin F5D7050 (version 1000)
     +o   Cohiba Proto Board
     +o   D-Link DWL-G120 Cohiba
     +o   FSC Connect2Air E-5400 USB D1700
     +o   Gigaset USB Adapter 54
     +o   Inventel UR045G
     +o   SMC EZ ConnectG SMC2862W-G
     +o   Sagem XG703A
     +o   Spinnaker DUT
     +o   Spinnaker Proto Board

EXAMPLES

     Join an existing BSS network (i.e., connect to an access point):

           ifconfig wlan create wlandev upgt0 inet 192.168.0.20 \
               netmask 0xffffff00

     Join a specific BSS network with network name ``my_net'':

           ifconfig wlan create wlandev upgt0 ssid my_net up

     Join a specific BSS network with 64-bit WEP encryption:

           ifconfig wlan create wlandev upgt0 ssid my_net \
                   wepmode on wepkey 0x1234567890 weptxkey 1 up

SEE ALSO

     arp(4), netintro(4), usb(4), wlan(4), ifconfig(8)

HISTORY

     The upgt driver first appeared in OpenBSD 4.3.

AUTHORS

     The upgt driver was written by Marcus Glocker <mglocker@openbsd.org>.

     The hardware specification was reverse engineered by the people at
     http://www.prism54.org.

CAVEATS

     The upgt driver just supports the USB 2.0 devices (GW3887 chipset) but
     not the USB 1.0 devices containing the NET2280, ISL3880, and ISL3886
     chipsets.  Some further efforts would be necessary to add USB 1.0 support
     to the driver.