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.\" 269b6ffc1fSAndrew Thompson.Dd January 14, 2010 27941e2863SAndrew Thompson.Os 28941e2863SAndrew Thompson.Dt UHSO 4 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 46941e2863SAndrew Thompsondriver which makes them behave like a 47941e2863SAndrew Thompson.Xr tty 4 . 48941e2863SAndrew ThompsonThe packet interface is exposed as a network interface. 49941e2863SAndrew Thompson.Pp 50f644abcfSAndrew ThompsonEstablishing a connection on the packet interface is achieved by using the 51f644abcfSAndrew Thompsonproprietary AT commands 52941e2863SAndrew Thompson.Dq Li AT_OWANCALL 53941e2863SAndrew Thompsonand 54941e2863SAndrew Thompson.Dq Li AT_OWANDATA 559b6ffc1fSAndrew Thompsonon any of the available serial ports. 56941e2863SAndrew Thompson.Pp 57941e2863SAndrew ThompsonThe network interface must be configured manually using the data obtain from 58941e2863SAndrew Thompsonthese calls. 59941e2863SAndrew Thompson.Pp 60941e2863SAndrew ThompsonEach device usually have at least two or more serial ports, their individual purpose 61941e2863SAndrew Thompsoncan be identified through 62941e2863SAndrew Thompson.Xr sysctl 8 . 63941e2863SAndrew Thompson.Sh HARDWARE 64941e2863SAndrew ThompsonThe 65941e2863SAndrew Thompson.Nm 66941e2863SAndrew Thompsondriver supports at least the following cards 67941e2863SAndrew Thompson.Pp 68941e2863SAndrew Thompson.Bl -bullet -compact 69941e2863SAndrew Thompson.It 70941e2863SAndrew ThompsonOption GlobeSurfer iCON 7.2 (new firmware) 71941e2863SAndrew Thompson.It 72941e2863SAndrew ThompsonOption iCON 225 739b6ffc1fSAndrew Thompson.It 749b6ffc1fSAndrew ThompsonOption iCON 505 75941e2863SAndrew Thompson.El 76941e2863SAndrew Thompson.Pp 77941e2863SAndrew ThompsonThe device features a mass storage device referred to as 78941e2863SAndrew Thompson.Dq Zero-CD 79f644abcfSAndrew Thompsonwhich contains drivers for Microsoft Windows; this is the default 809b6ffc1fSAndrew Thompsonmode for the device. 819b6ffc1fSAndrew ThompsonThe 829b6ffc1fSAndrew Thompson.Nm 839b6ffc1fSAndrew Thompsondriver automatically switches the device from 849b6ffc1fSAndrew Thompson.Dq Zero-CD 859b6ffc1fSAndrew Thompsonmode to modem mode. 869b6ffc1fSAndrew ThompsonThis behavior can be disabled by setting 879b6ffc1fSAndrew Thompson.Va hw.usb.uhso.auto_switch 889b6ffc1fSAndrew Thompsonto 0 using 899b6ffc1fSAndrew Thompson.Xr sysctl 8 90941e2863SAndrew Thompson.Sh EXAMPLES 91941e2863SAndrew ThompsonEstablishing a packet interface connection 92941e2863SAndrew Thompson.Bd -literal -offset indent 93941e2863SAndrew ThompsonAT+CGDCONT=1,,"apn.provider" 94941e2863SAndrew ThompsonAT_OWANCALL=1,1,1 95941e2863SAndrew ThompsonOK 96941e2863SAndrew Thompson_OWANCALL=1,1 97941e2863SAndrew Thompson 98941e2863SAndrew ThompsonAT_OWANDATA=1 99941e2863SAndrew Thompson_OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \e 100941e2863SAndrew Thompson 0.0.0.0, 0.0.0.0, 72000 101941e2863SAndrew Thompson.Ed 102941e2863SAndrew Thompson.Pp 103941e2863SAndrew ThompsonConfiguring the interface 104941e2863SAndrew Thompson.Bd -literal -offset indent 105941e2863SAndrew Thompsonifconfig uhso0 10.11.12.13 up 106941e2863SAndrew Thompsonroute add default -interface uhso0 107941e2863SAndrew Thompsonecho "nameserver 10.2.3.4" > /etc/resolv.conf 108941e2863SAndrew Thompsonecho "nameserver 10.2.3.5" >> /etc/resolv.conf 109941e2863SAndrew Thompson.Ed 110941e2863SAndrew Thompson.Pp 111941e2863SAndrew ThompsonThe connection can be terminated with 112941e2863SAndrew Thompson.Bd -literal -offset indent 113941e2863SAndrew ThompsonAT_OWANCALL=1,0,1 114941e2863SAndrew Thompson.Ed 115941e2863SAndrew Thompson.Sh FILES 116941e2863SAndrew Thompson.Bl -tag -width "XXXXXX" 117941e2863SAndrew Thompson.It Pa /dev/cuaU?.? 118941e2863SAndrew Thompson.El 119941e2863SAndrew Thompson.Sh SEE ALSO 120941e2863SAndrew Thompson.Xr ucom 4 , 121941e2863SAndrew Thompson.Xr usb 4 122941e2863SAndrew Thompson.Sh AUTHORS 123941e2863SAndrew ThompsonThe 124941e2863SAndrew Thompson.Nm 125941e2863SAndrew Thompsondriver was written by 126941e2863SAndrew Thompson.An Fredrik Lindberg Aq fli@shapeshifter.se . 127