UPGT(4)
β¨ UPGT(4) β¨
okay so bestie, welcome to the UPGT(4) page from the Kernel Interfaces Manual π
this is the whole tea on the Conexant/Intersil PrismGT SoftMAC USB IEEE 802.11b/g wireless network driver β pull up a chair, we're getting into it π«Ά
πΈ NAME πΈ
upgt β the Conexant/Intersil PrismGT SoftMAC USB IEEE 802.11b/g wireless network driver. yes that's a whole mouthful, no I will not be shortening it π
π SYNOPSIS π
so if you wanna compile this driver into the kernel (main character energy, no modules), you drop these lines into your kernel configuration file, mwah:
device ehci
device uhci
device ohci
device usb
device upgt
device wlan
or alternatively π« β if you'd rather load the driver as a module at boot time, put this single line in loader.conf(5):
if_upgt_load="YES"
π DEPRECATION NOTICE π
not me having to be the one to tell you this π but the upgt driver is slated to be removed in FreeBSD 16.0. it's giving end of an era fr fr. still iconic, still works, but plan accordingly bestie π
π¦ DESCRIPTION π¦
okay so the upgt driver supports the USB 2.0 Conexant/Intersil PrismGT series wireless adapters β the ones based on the GW3887 chipset β¨
these are the modes the upgt driver can operate in, and honestly? both slay:
- BSS mode β also known as infrastructure mode. this is what you use when associating with an access point, and all your traffic passes through it. this mode is the default, so it's the one you get automatically, periodt π
- monitor mode β in this mode the driver can receive packets without associating with an access point. it 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. lil sneaky peeky energy, we love her π
upgt supports software WEP. Wired Equivalent Privacy (WEP) is the de facto encryption standard for wireless networks. it can typically be configured in one of three modes: no encryption; 40-bit encryption; or 104-bit encryption π
β οΈ but listen β unfortunately, due to serious weaknesses in the WEP protocol it is strongly recommended that it not be used as the sole mechanism to secure wireless communication. like genuinely, do not. it's giving wet paper bag security π
also WEP is not enabled by default, so you'd have to go out of your way to turn it on.
the upgt driver can be configured at runtime with ifconfig(8) β
π FILES π
heads up: this driver requires the upgtfw firmware to be installed before it will work. and here's the kicker β the firmware files are not publicly available π
but!! a package of the firmware that can be installed via pkg_add(1) is available, at this exact URL, copy it carefully bestie:
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, this absolutely stacked lineup:
- Belkin F5D7050 (version 1000)
- Cohiba Proto Board
- D-Link DWL-G120 Cohiba
- FSC Connect2Air E-5400 USB D1700
- Gigaset USB Adapter 54
- Inventel UR045G
- Netgear WG111v1 (rev2)
- SMC EZ ConnectG SMC2862W-G
- Sagem XG703A
- Spinnaker DUT
- Spinnaker Proto Board
π EXAMPLES π
join an existing BSS network (i.e., connect to an access point) β here's the code, verbatim, don't @ me:
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 (yes, even though we just dragged WEP, here's how π):
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) β go read them, iykyk π§
β HISTORY β
the upgt driver first appeared in OpenBSD 4.3. vintage. we stan a legend π
π AUTHORS π
the upgt driver was written by Marcus Glocker <mglocker@openbsd.org> π«Ά
and the hardware specification was reverse engineered by the people at:
http://www.prism54.org
absolute icons, all of them π
π CAVEATS π
okay so 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 β so like, don't come for her about it π it's not a bug, it's a scope choice bestie.
<div align="center">π</div>
that's the whole page, bestie! this one's from the Debian edition, dated October 24, 2025 β go forth and be wireless π¦π β¨
π¦ where this page comes from
- freebsd 15.1: base 15.1
- nixpkgs unstable: source
- Copyright (c) 2007 Marcus Glocker <mglocker@openbsd.org>
- Copyright (c) 2005-2007 Damien Bergamini <damien.bergamini@free.fr>
- Copyright (c) 2006 Theo de Raadt
- Copyright (c) 2006 The DragonFly Project. All rights reserved
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms