1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
<table class="head">
<tr>
<td class="head-ltitle">UHSO(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">UHSO(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">uhso</code> — <span class="Nd">support for
several HSxPA devices from Option N.V.</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">The module can be loaded at boot time by placing the following
line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>uhso_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">uhso</code> driver provides support for
several HSxPA devices from Option N.V. that are based on their packet
interface. Each device has a set of serial ports and a raw IP packet
interface. The serial ports of the device are accessed through the
<a class="Xr">ucom(4)</a> driver which makes them behave like
<a class="Xr">tty(4)</a> devices. The packet interface is exposed as a
network interface.</p>
<p class="Pp">Establishing a connection on the packet interface is achieved by
using the proprietary AT commands
“<code class="Li">AT_OWANCALL</code>” and
“<code class="Li">AT_OWANDATA</code>” on any of the available
serial ports.</p>
<p class="Pp">The network interface must be configured manually using the data
obtain from these calls.</p>
<p class="Pp">Each device usually have at least two or more serial ports, their
individual purpose can be identified through <a class="Xr">sysctl(8)</a>.
Ports identified as “Modem” features a normal modem interface
that can be used with PPP. Ports identified as “Diagnostic”
uses a proprietary binary interface used for firmware upgrades, this port
does not have a AT command interface and can not be used to control the
device. Other ports features an AT command interface that can be used for
normal device control.</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">uhso</code> driver should work with most
devices from Option. The following devices have been verified to work</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bl-compact">
<li>Option GlobeSurfer iCON 7.2 (new firmware)</li>
<li>Option GlobeTrotter Max 7.2 (new firmware)</li>
<li>Option iCON 225</li>
<li>Option iCON 452</li>
<li>Option iCON 505</li>
</ul>
<p class="Pp">The device features a mass storage device referred to as
“Zero-CD” which contains drivers for Microsoft Windows; this
is the default mode for the device. The <code class="Nm">uhso</code> driver
automatically switches the device from “Zero-CD” mode to modem
mode. This behavior can be disabled by setting
<var class="Va">hw.usb.uhso.auto_switch</var> to 0 using
<a class="Xr">sysctl(8)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag">
<dt><span class="Pa">/dev/cuaU?.?</span></dt>
<dd style="width: auto;"> </dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">Establishing a packet interface connection using the AT command
interface available at one of the serial ports</p>
<div class="Bd Pp Bd-indent Li">
<pre>AT+CGDCONT=1,,"apn.provider"
AT_OWANCALL=1,1,1
OK
_OWANCALL=1,1
AT_OWANDATA=1
_OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \
0.0.0.0, 0.0.0.0, 72000</pre>
</div>
<p class="Pp">Configuring the interface</p>
<div class="Bd Pp Bd-indent Li">
<pre>ifconfig uhso0 10.11.12.13 up
route add default -interface uhso0
echo "nameserver 10.2.3.4" > /etc/resolv.conf
echo "nameserver 10.2.3.5" >> /etc/resolv.conf</pre>
</div>
<p class="Pp">The connection can be terminated with</p>
<div class="Bd Pp Bd-indent Li">
<pre>AT_OWANCALL=1,0,1</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">uhsoctl(1)</a>, <a class="Xr">ucom(4)</a>,
<a class="Xr">usb(4)</a></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">uhso</code> driver was written by
<span class="An">Fredrik Lindberg</span>
<<a class="Mt" href="mailto:fli@shapeshifter.se">fli@shapeshifter.se</a>>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">July 20, 2010</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
