diff options
Diffstat (limited to 'static/freebsd/man4/u3g.4 3.html')
| -rw-r--r-- | static/freebsd/man4/u3g.4 3.html | 149 |
1 files changed, 149 insertions, 0 deletions
diff --git a/static/freebsd/man4/u3g.4 3.html b/static/freebsd/man4/u3g.4 3.html new file mode 100644 index 00000000..04fc26ea --- /dev/null +++ b/static/freebsd/man4/u3g.4 3.html @@ -0,0 +1,149 @@ +<table class="head"> + <tr> + <td class="head-ltitle">U3G(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">U3G(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">u3g</code> — <span class="Nd">USB support + for 3G and 4G cellular modems</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 usb</code> +<br/> +<code class="Cd">device ucom</code> +<br/> +<code class="Cd">device u3g</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>u3g_load="YES"</pre> +</div> +<p class="Pp">If neither of the above is done, the driver will be automatically + loaded by devd(8) when the device is connected.</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">u3g</code> driver provides support for + USB-to-serial interfaces exposed by many 3G and 4G modems. The supported + adapters provide the necessary modem port for <a class="Xr">ppp(8)</a>, or + <span class="Pa">net/mpd5</span> connections. Depending on the specific + device, extra ports provide other functions such as an additional command + port, diagnostic port, GPS receiver port, or SIM toolkit port.</p> +<p class="Pp">The device is accessed through the <a class="Xr">ucom(4)</a> + driver which makes it behave like a <a class="Xr">tty(4)</a>.</p> +<p class="Pp">In some adapters a mass storage device supported by the + <a class="Xr">umass(4)</a> driver is present which contains Windows and Mac + OS X drivers. The device starts up in disk mode (TruInstall, ZeroCD, etc.) + and requires additional commands to switch it to modem mode. If your device + is not switching automatically, please try to add quirks. See + <a class="Xr">usbconfig(8)</a> and <a class="Xr">usb_quirk(4)</a>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1> +<p class="Pp">The <code class="Nm">u3g</code> driver supports the following + cellular modems:</p> +<p class="Pp"></p> +<ul class="Bl-bullet Bl-compact"> + <li>Option GT 3G Fusion, GT Fusion Quad, etc. (3G only, not WLAN)</li> + <li>Option GT 3G, GT 3G Quad, etc.</li> + <li>Vodafone Mobile Connect Card 3G</li> + <li>Vodafone Mobile Broadband K3772-Z</li> + <li>Qualcomm Inc. CDMA MSM</li> + <li>Qualcomm Inc. GOBI 1000, 2000 and 3000 devices with MDM1000 or MDM2000 + chipsets</li> + <li>QUECTEL BGX, ECX, EGX, EMX, EPX, RGX series</li> + <li>Quectel EM160R, EM060K (see + <a class="Sx" href="#CAVEATS">CAVEATS</a>)</li> + <li>Huawei B190, E180v, E220, E3372, E3372v153, E5573Cs322, ('<Huawei + Mobile>')</li> + <li>Novatel U740, MC950D, X950D, etc.</li> + <li>Sierra MC875U, MC8775U, EM7590, etc.</li> + <li>Panasonic CF-F9 GOBI</li> +</ul> +<p class="Pp">Many more are supported, see + <span class="Pa">/sys/dev/usb/serial/u3g.c</span> for the complete list.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1> +<dl class="Bl-tag Bl-compact"> + <dt><span class="Pa">/dev/ttyU*.*</span></dt> + <dd>for callin ports</dd> + <dt><span class="Pa">/dev/ttyU*.*.init</span></dt> + <dd style="width: auto;"> </dd> + <dt><span class="Pa">/dev/ttyU*.*.lock</span></dt> + <dd>corresponding callin initial-state and lock-state devices + <p class="Pp"></p> + </dd> + <dt><span class="Pa">/dev/cuaU*.*</span></dt> + <dd>for callout ports</dd> + <dt><span class="Pa">/dev/cuaU*.*.init</span></dt> + <dd style="width: auto;"> </dd> + <dt><span class="Pa">/dev/cuaU*.*.lock</span></dt> + <dd>corresponding callout initial-state and lock-state devices</dd> +</dl> +</section> +<section class="Sh"> +<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> +<p class="Pp">Connect to the Internet using the default configuration:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>ppp -background u3g</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">tty(4)</a>, <a class="Xr">ucom(4)</a>, + <a class="Xr">usb(4)</a>, <a class="Xr">usb_quirk(4)</a>, + <a class="Xr">devd(8)</a>, <a class="Xr">ppp(8)</a>, + <a class="Xr">usbconfig(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">u3g</code> driver appeared in + <span class="Ux">FreeBSD 7.2</span>, is based on the + <a class="Xr">uark(4)</a> driver, and written by <span class="An">Andrea + Guzzo</span> + <<a class="Mt" href="mailto:aguzzo@anywi.com">aguzzo@anywi.com</a>> in + September 2008.</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">u3g</code> driver was written by + <span class="An">Andrea Guzzo</span> + <<a class="Mt" href="mailto:aguzzo@anywi.com">aguzzo@anywi.com</a>> + and <span class="An">Nick Hibma</span> + <<a class="Mt" href="mailto:n_hibma@FreeBSD.org">n_hibma@FreeBSD.org</a>>. + Hardware for testing was provided by AnyWi Technologies, Leiden, NL.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1> +<p class="Pp">The Quectel EM160R is not officially supported in PPP mode. In + order to use it in PPP mode, the ctsrts option needs to be turned off, for + example, by adding:</p> +<p class="Pp"></p> +<div class="Bd Bd-indent"><code class="Li">set ctsrts off</code></div> +<p class="Pp">to <span class="Pa">/etc/ppp/ppp.conf</span> in the correct + section.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> +<p class="Pp">The automatic mode switch from disk mode to modem mode does not + work unless the driver is either built into the kernel or loaded before the + device is connected.</p> +<p class="Pp">The GOBI-based devices require the gobi loader available from the + <span class="Pa">sysutils/gobi_loader</span> port.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">December 5, 2024</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |