1941e2863SAndrew Thompson.\" Copyright (c) 2009 Fredrik Lindberg 2941e2863SAndrew Thompson.\" All rights reserved. 3941e2863SAndrew Thompson.\" 4941e2863SAndrew Thompson.\" Redistribution and use in source and binary forms, with or without 5941e2863SAndrew Thompson.\" modification, are permitted provided that the following conditions 6941e2863SAndrew Thompson.\" are met: 7941e2863SAndrew Thompson.\" 1. Redistributions of source code must retain the above copyright 8941e2863SAndrew Thompson.\" notice, this list of conditions and the following disclaimer. 9941e2863SAndrew Thompson.\" 2. Redistributions in binary form must reproduce the above copyright 10941e2863SAndrew Thompson.\" notice, this list of conditions and the following disclaimer in the 11941e2863SAndrew Thompson.\" documentation and/or other materials provided with the distribution. 12941e2863SAndrew Thompson.\" 13941e2863SAndrew Thompson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 14941e2863SAndrew Thompson.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 15941e2863SAndrew Thompson.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 16941e2863SAndrew Thompson.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 17941e2863SAndrew Thompson.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 18941e2863SAndrew Thompson.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 19941e2863SAndrew Thompson.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 20941e2863SAndrew Thompson.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 21941e2863SAndrew Thompson.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 22941e2863SAndrew Thompson.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 23941e2863SAndrew Thompson.\" 24941e2863SAndrew Thompson.\" $FreeBSD$ 25941e2863SAndrew Thompson.\" 26891d46ceSEdward Tomasz Napierala.Dd July 20, 2010 27941e2863SAndrew Thompson.Dt UHSO 4 28aa12cea2SUlrich Spörlein.Os 29941e2863SAndrew Thompson.Sh NAME 309b6ffc1fSAndrew Thompson.Nm uhso 31941e2863SAndrew Thompson.Nd support for several HSxPA devices from Option N.V. 32941e2863SAndrew Thompson.Sh SYNOPSIS 33941e2863SAndrew ThompsonThe module can be loaded at boot time by placing the following line in 34941e2863SAndrew Thompson.Xr loader.conf 5 : 35941e2863SAndrew Thompson.Bd -literal -offset indent 36941e2863SAndrew Thompsonuhso_load="YES" 37941e2863SAndrew Thompson.Ed 38941e2863SAndrew Thompson.Sh DESCRIPTION 39941e2863SAndrew ThompsonThe 40941e2863SAndrew Thompson.Nm 41941e2863SAndrew Thompsondriver provides support for several HSxPA devices from Option N.V. that are 42941e2863SAndrew Thompsonbased on their packet interface. 43941e2863SAndrew ThompsonEach device has a set of serial ports and a raw IP packet interface. 44941e2863SAndrew ThompsonThe serial ports of the device are accessed through the 45941e2863SAndrew Thompson.Xr ucom 4 4621a9d6e7SAndrew Thompsondriver which makes them behave like 4721a9d6e7SAndrew Thompson.Xr tty 4 4821a9d6e7SAndrew Thompsondevices. 49941e2863SAndrew ThompsonThe packet interface is exposed as a network interface. 50941e2863SAndrew Thompson.Pp 51f644abcfSAndrew ThompsonEstablishing a connection on the packet interface is achieved by using the 52f644abcfSAndrew Thompsonproprietary AT commands 53941e2863SAndrew Thompson.Dq Li AT_OWANCALL 54941e2863SAndrew Thompsonand 55941e2863SAndrew Thompson.Dq Li AT_OWANDATA 569b6ffc1fSAndrew Thompsonon any of the available serial ports. 57941e2863SAndrew Thompson.Pp 58941e2863SAndrew ThompsonThe network interface must be configured manually using the data obtain from 59941e2863SAndrew Thompsonthese calls. 60941e2863SAndrew Thompson.Pp 61941e2863SAndrew ThompsonEach device usually have at least two or more serial ports, their individual purpose 62941e2863SAndrew Thompsoncan be identified through 63941e2863SAndrew Thompson.Xr sysctl 8 . 6421a9d6e7SAndrew ThompsonPorts identified as 6521a9d6e7SAndrew Thompson.Dq Modem 6621a9d6e7SAndrew Thompsonfeatures a normal modem interface that can be used with PPP. 6721a9d6e7SAndrew ThompsonPorts identified as 6821a9d6e7SAndrew Thompson.Dq Diagnostic 6921a9d6e7SAndrew Thompsonuses a proprietary binary interface used for firmware upgrades, this port does not 7021a9d6e7SAndrew Thompsonhave a AT command interface and can not be used to control the device. 7121a9d6e7SAndrew ThompsonOther ports features an AT command interface that can be used for normal device control. 72941e2863SAndrew Thompson.Sh HARDWARE 73941e2863SAndrew ThompsonThe 74941e2863SAndrew Thompson.Nm 7521a9d6e7SAndrew Thompsondriver should work with most devices from Option. 7621a9d6e7SAndrew ThompsonThe following devices have been verified to work 77941e2863SAndrew Thompson.Pp 78941e2863SAndrew Thompson.Bl -bullet -compact 79941e2863SAndrew Thompson.It 80941e2863SAndrew ThompsonOption GlobeSurfer iCON 7.2 (new firmware) 81941e2863SAndrew Thompson.It 82*0f92e529SHans Petter SelaskyOption GlobeTrotter Max 7.2 (new firmware) 83*0f92e529SHans Petter Selasky.It 84941e2863SAndrew ThompsonOption iCON 225 859b6ffc1fSAndrew Thompson.It 8621a9d6e7SAndrew ThompsonOption iCON 452 8721a9d6e7SAndrew Thompson.It 889b6ffc1fSAndrew ThompsonOption iCON 505 89941e2863SAndrew Thompson.El 90941e2863SAndrew Thompson.Pp 91941e2863SAndrew ThompsonThe device features a mass storage device referred to as 92941e2863SAndrew Thompson.Dq Zero-CD 93f644abcfSAndrew Thompsonwhich contains drivers for Microsoft Windows; this is the default 949b6ffc1fSAndrew Thompsonmode for the device. 959b6ffc1fSAndrew ThompsonThe 969b6ffc1fSAndrew Thompson.Nm 979b6ffc1fSAndrew Thompsondriver automatically switches the device from 989b6ffc1fSAndrew Thompson.Dq Zero-CD 999b6ffc1fSAndrew Thompsonmode to modem mode. 1009b6ffc1fSAndrew ThompsonThis behavior can be disabled by setting 1019b6ffc1fSAndrew Thompson.Va hw.usb.uhso.auto_switch 1029b6ffc1fSAndrew Thompsonto 0 using 1039b6ffc1fSAndrew Thompson.Xr sysctl 8 1040b31f1f7SUlrich Spörlein.Sh FILES 1050b31f1f7SUlrich Spörlein.Bl -tag -width "XXXXXX" 1060b31f1f7SUlrich Spörlein.It Pa /dev/cuaU?.? 1070b31f1f7SUlrich Spörlein.El 108941e2863SAndrew Thompson.Sh EXAMPLES 10921a9d6e7SAndrew ThompsonEstablishing a packet interface connection using the AT command interface available 11021a9d6e7SAndrew Thompsonat one of the serial ports 111941e2863SAndrew Thompson.Bd -literal -offset indent 112941e2863SAndrew ThompsonAT+CGDCONT=1,,"apn.provider" 113941e2863SAndrew ThompsonAT_OWANCALL=1,1,1 114941e2863SAndrew ThompsonOK 115941e2863SAndrew Thompson_OWANCALL=1,1 116941e2863SAndrew Thompson 117941e2863SAndrew ThompsonAT_OWANDATA=1 118941e2863SAndrew Thompson_OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \e 119941e2863SAndrew Thompson 0.0.0.0, 0.0.0.0, 72000 120941e2863SAndrew Thompson.Ed 121941e2863SAndrew Thompson.Pp 122941e2863SAndrew ThompsonConfiguring the interface 123941e2863SAndrew Thompson.Bd -literal -offset indent 124941e2863SAndrew Thompsonifconfig uhso0 10.11.12.13 up 125941e2863SAndrew Thompsonroute add default -interface uhso0 126941e2863SAndrew Thompsonecho "nameserver 10.2.3.4" > /etc/resolv.conf 127941e2863SAndrew Thompsonecho "nameserver 10.2.3.5" >> /etc/resolv.conf 128941e2863SAndrew Thompson.Ed 129941e2863SAndrew Thompson.Pp 130941e2863SAndrew ThompsonThe connection can be terminated with 131941e2863SAndrew Thompson.Bd -literal -offset indent 132941e2863SAndrew ThompsonAT_OWANCALL=1,0,1 133941e2863SAndrew Thompson.Ed 134941e2863SAndrew Thompson.Sh SEE ALSO 135891d46ceSEdward Tomasz Napierala.Xr uhsoctl 1 , 136941e2863SAndrew Thompson.Xr ucom 4 , 137941e2863SAndrew Thompson.Xr usb 4 138941e2863SAndrew Thompson.Sh AUTHORS 139941e2863SAndrew ThompsonThe 140941e2863SAndrew Thompson.Nm 141941e2863SAndrew Thompsondriver was written by 142941e2863SAndrew Thompson.An Fredrik Lindberg Aq fli@shapeshifter.se . 143