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 Aug 12, 2009 27.Os 28.Dt UHSO 4 29.Sh NAME 30.Nm hso 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 50To establish a connection on the packet interface the use of the proprietary 51AT commands 52.Dq Li AT_OWANCALL 53and 54.Dq Li AT_OWANDATA 55are required on any of the 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.El 74.Pp 75The device features a mass storage device referred to as 76.Dq Zero-CD 77which contains drivers for Microsoft Windows. 78The driver automatically switches the device to modem mode. 79.Sh EXAMPLES 80Establishing a packet interface connection 81.Bd -literal -offset indent 82AT+CGDCONT=1,,"apn.provider" 83AT_OWANCALL=1,1,1 84OK 85_OWANCALL=1,1 86 87AT_OWANDATA=1 88_OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \e 89 0.0.0.0, 0.0.0.0, 72000 90.Ed 91.Pp 92Configuring the interface 93.Bd -literal -offset indent 94ifconfig uhso0 10.11.12.13 up 95route add default -interface uhso0 96echo "nameserver 10.2.3.4" > /etc/resolv.conf 97echo "nameserver 10.2.3.5" >> /etc/resolv.conf 98.Ed 99.Pp 100The connection can be terminated with 101.Bd -literal -offset indent 102AT_OWANCALL=1,0,1 103.Ed 104.Sh FILES 105.Bl -tag -width "XXXXXX" 106.It Pa /dev/cuaU?.? 107.El 108.Sh SEE ALSO 109.Xr ucom 4 , 110.Xr usb 4 111.Sh AUTHORS 112The 113.Nm 114driver was written by 115.An Fredrik Lindberg Aq fli@shapeshifter.se . 116