1 .\" Copyright (c) 2009 Fredrik Lindberg
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
14 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
15 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
16 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
17 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
18 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
22 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 .Nd support for several HSxPA devices from Option N.V.
33 The module can be loaded at boot time by placing the following line in
35 .Bd -literal -offset indent
41 driver provides support for several HSxPA devices from Option N.V. that are
42 based on their packet interface.
43 Each device has a set of serial ports and a raw IP packet interface.
44 The serial ports of the device are accessed through the
46 driver which makes them behave like
49 The packet interface is exposed as a network interface.
51 Establishing a connection on the packet interface is achieved by using the
52 proprietary AT commands
56 on any of the available serial ports.
58 The network interface must be configured manually using the data obtain from
61 Each device usually have at least two or more serial ports, their individual purpose
62 can be identified through
66 features a normal modem interface that can be used with PPP.
69 uses a proprietary binary interface used for firmware upgrades, this port does not
70 have a AT command interface and can not be used to control the device.
71 Other ports features an AT command interface that can be used for normal device control.
75 driver should work with most devices from Option.
76 The following devices have been verified to work
80 Option GlobeSurfer iCON 7.2 (new firmware)
82 Option GlobeTrotter Max 7.2 (new firmware)
91 The device features a mass storage device referred to as
93 which contains drivers for Microsoft Windows; this is the default
97 driver automatically switches the device from
100 This behavior can be disabled by setting
101 .Va hw.usb.uhso.auto_switch
105 .Bl -tag -width "XXXXXX"
109 Establishing a packet interface connection using the AT command interface available
110 at one of the serial ports
111 .Bd -literal -offset indent
112 AT+CGDCONT=1,,"apn.provider"
118 _OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \e
119 0.0.0.0, 0.0.0.0, 72000
122 Configuring the interface
123 .Bd -literal -offset indent
124 ifconfig uhso0 10.11.12.13 up
125 route add default -interface uhso0
126 echo "nameserver 10.2.3.4" > /etc/resolv.conf
127 echo "nameserver 10.2.3.5" >> /etc/resolv.conf
130 The connection can be terminated with
131 .Bd -literal -offset indent
141 driver was written by
142 .An Fredrik Lindberg Aq fli@shapeshifter.se .