1.\" Copyright (c) 2009 Fredrik Lindberg 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 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. 12.\" 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. 23.\" 24.\" $FreeBSD$ 25.\" 26.Dd January 14, 2010 27.Os 28.Dt UHSO 4 29.Sh NAME 30.Nm uhso 31.Nd support for several HSxPA devices from Option N.V. 32.Sh SYNOPSIS 33The module can be loaded at boot time by placing the following line in 34.Xr loader.conf 5 : 35.Bd -literal -offset indent 36uhso_load="YES" 37.Ed 38.Sh DESCRIPTION 39The 40.Nm 41driver provides support for several HSxPA devices from Option N.V. that are 42based on their packet interface. 43Each device has a set of serial ports and a raw IP packet interface. 44The serial ports of the device are accessed through the 45.Xr ucom 4 46driver which makes them behave like a 47.Xr tty 4 . 48The packet interface is exposed as a network interface. 49.Pp 50Establishing a connection on the packet interface is achieved by using the 51proprietary AT commands 52.Dq Li AT_OWANCALL 53and 54.Dq Li AT_OWANDATA 55on any of the available serial ports. 56.Pp 57The network interface must be configured manually using the data obtain from 58these calls. 59.Pp 60Each device usually have at least two or more serial ports, their individual purpose 61can be identified through 62.Xr sysctl 8 . 63.Sh HARDWARE 64The 65.Nm 66driver supports at least the following cards 67.Pp 68.Bl -bullet -compact 69.It 70Option GlobeSurfer iCON 7.2 (new firmware) 71.It 72Option iCON 225 73.It 74Option iCON 505 75.El 76.Pp 77The device features a mass storage device referred to as 78.Dq Zero-CD 79which contains drivers for Microsoft Windows; this is the default 80mode for the device. 81The 82.Nm 83driver automatically switches the device from 84.Dq Zero-CD 85mode to modem mode. 86This behavior can be disabled by setting 87.Va hw.usb.uhso.auto_switch 88to 0 using 89.Xr sysctl 8 90.Sh EXAMPLES 91Establishing a packet interface connection 92.Bd -literal -offset indent 93AT+CGDCONT=1,,"apn.provider" 94AT_OWANCALL=1,1,1 95OK 96_OWANCALL=1,1 97 98AT_OWANDATA=1 99_OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \e 100 0.0.0.0, 0.0.0.0, 72000 101.Ed 102.Pp 103Configuring the interface 104.Bd -literal -offset indent 105ifconfig uhso0 10.11.12.13 up 106route add default -interface uhso0 107echo "nameserver 10.2.3.4" > /etc/resolv.conf 108echo "nameserver 10.2.3.5" >> /etc/resolv.conf 109.Ed 110.Pp 111The connection can be terminated with 112.Bd -literal -offset indent 113AT_OWANCALL=1,0,1 114.Ed 115.Sh FILES 116.Bl -tag -width "XXXXXX" 117.It Pa /dev/cuaU?.? 118.El 119.Sh SEE ALSO 120.Xr ucom 4 , 121.Xr usb 4 122.Sh AUTHORS 123The 124.Nm 125driver was written by 126.An Fredrik Lindberg Aq fli@shapeshifter.se . 127