diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:43 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:43 -0400 |
| commit | ac5e55f5f2af5b92794c2aded46c6bae85b5f5ed (patch) | |
| tree | 9367490586c84cba28652e443e3166d66c33b0d9 /static/freebsd/man4/upgt.4 3.html | |
| parent | 253e67c8b3a72b3a4757fdbc5845297628db0a4a (diff) | |
docs: Added All FreeBSD Manuals
Diffstat (limited to 'static/freebsd/man4/upgt.4 3.html')
| -rw-r--r-- | static/freebsd/man4/upgt.4 3.html | 153 |
1 files changed, 153 insertions, 0 deletions
diff --git a/static/freebsd/man4/upgt.4 3.html b/static/freebsd/man4/upgt.4 3.html new file mode 100644 index 00000000..5804e4a0 --- /dev/null +++ b/static/freebsd/man4/upgt.4 3.html @@ -0,0 +1,153 @@ +<table class="head"> + <tr> + <td class="head-ltitle">UPGT(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">UPGT(4)</td> + </tr> +</table> +<div class="manual-text"> +<section class="Sh"> +<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> +<p class="Pp"><code class="Nm">upgt</code> — + <span class="Nd">Conexant/Intersil PrismGT SoftMAC USB IEEE 802.11b/g + wireless network driver</span></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> +<p class="Pp">To compile this driver into the kernel, place the following lines + in your kernel configuration file:</p> +<div class="Bd Pp Bd-indent"><code class="Cd">device ehci</code> +<br/> +<code class="Cd">device uhci</code> +<br/> +<code class="Cd">device ohci</code> +<br/> +<code class="Cd">device usb</code> +<br/> +<code class="Cd">device upgt</code> +<br/> +<code class="Cd">device wlan</code></div> +<p class="Pp">Alternatively, to load the driver as a module at boot time, place + the following line in <a class="Xr">loader.conf(5)</a>:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>if_upgt_load="YES"</pre> +</div> +</section> +<section class="Sh"> +<h1 class="Sh" id="DEPRECATION_NOTICE"><a class="permalink" href="#DEPRECATION_NOTICE">DEPRECATION + NOTICE</a></h1> +<p class="Pp">The <code class="Nm">upgt</code> driver is slated to be removed in + <span class="Ux">FreeBSD 16.0</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> +<p class="Pp">The <code class="Nm">upgt</code> driver supports the USB 2.0 + Conexant/Intersil PrismGT series wireless adapters based on the GW3887 + chipset.</p> +<p class="Pp">These are the modes the <code class="Nm">upgt</code> driver can + operate in:</p> +<dl class="Bl-tag"> + <dt id="infrastructure">BSS mode</dt> + <dd>Also known as + <a class="permalink" href="#infrastructure"><i class="Em">infrastructure</i></a> + mode, this is used when associating with an access point, through which + all traffic passes. This mode is the default.</dd> + <dt>monitor mode</dt> + <dd>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.</dd> +</dl> +<p class="Pp"><code class="Nm">upgt</code> 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.</p> +<p class="Pp">The <code class="Nm">upgt</code> driver can be configured at + runtime with <a class="Xr">ifconfig(8)</a>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1> +<p class="Pp">This driver requires the <code class="Nm">upgtfw</code> 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 + <a class="Xr">pkg_add(1)</a> is available:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>http://weongyo.org/project/upgt/upgt-firmware-2.13.1.0.tar.gz</pre> +</div> +</section> +<section class="Sh"> +<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1> +<p class="Pp">The <code class="Nm">upgt</code> driver supports USB 2.0 + Conexant/Intersil PrismGT series wireless adapters based on the GW3887 + chipset, among them:</p> +<p class="Pp"></p> +<ul class="Bl-bullet Bl-compact"> + <li>Belkin F5D7050 (version 1000)</li> + <li>Cohiba Proto Board</li> + <li>D-Link DWL-G120 Cohiba</li> + <li>FSC Connect2Air E-5400 USB D1700</li> + <li>Gigaset USB Adapter 54</li> + <li>Inventel UR045G</li> + <li>Netgear WG111v1 (rev2)</li> + <li>SMC EZ ConnectG SMC2862W-G</li> + <li>Sagem XG703A</li> + <li>Spinnaker DUT</li> + <li>Spinnaker Proto Board</li> +</ul> +</section> +<section class="Sh"> +<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> +<p class="Pp">Join an existing BSS network (i.e., connect to an access + point):</p> +<div class="Bd Pp Bd-indent Li"> +<pre>ifconfig wlan create wlandev upgt0 inet 192.168.0.20 \ + netmask 0xffffff00</pre> +</div> +<p class="Pp">Join a specific BSS network with network name + “<code class="Li">my_net</code>”:</p> +<p class="Pp"></p> +<div class="Bd Bd-indent"><code class="Li">ifconfig wlan create wlandev upgt0 + ssid my_net up</code></div> +<p class="Pp">Join a specific BSS network with 64-bit WEP encryption:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>ifconfig wlan create wlandev upgt0 ssid my_net \ + wepmode on wepkey 0x1234567890 weptxkey 1 up</pre> +</div> +</section> +<section class="Sh"> +<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE + ALSO</a></h1> +<p class="Pp"><a class="Xr">arp(4)</a>, <a class="Xr">netintro(4)</a>, + <a class="Xr">usb(4)</a>, <a class="Xr">wlan(4)</a>, + <a class="Xr">ifconfig(8)</a></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> +<p class="Pp">The <code class="Nm">upgt</code> driver first appeared in + <span class="Ux">OpenBSD 4.3</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> +<p class="Pp">The <code class="Nm">upgt</code> driver was written by + <span class="An">Marcus Glocker</span> + <<a class="Mt" href="mailto:mglocker@openbsd.org">mglocker@openbsd.org</a>>.</p> +<p class="Pp">The hardware specification was reverse engineered by the people at + <span class="Pa">http://www.prism54.org</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1> +<p class="Pp">The <code class="Nm">upgt</code> 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.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">October 24, 2025</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |
