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 July 20, 2010 27 .Dt UHSO 4 28 .Os 29 .Sh NAME 30 .Nm uhso 31 .Nd support for several HSxPA devices from Option N.V. 32 .Sh SYNOPSIS 33 The module can be loaded at boot time by placing the following line in 34 .Xr loader.conf 5 : 35 .Bd -literal -offset indent 36 uhso_load="YES" 37 .Ed 38 .Sh DESCRIPTION 39 The 40 .Nm 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 45 .Xr ucom 4 46 driver which makes them behave like 47 .Xr tty 4 48 devices. 49 The packet interface is exposed as a network interface. 50 .Pp 51 Establishing a connection on the packet interface is achieved by using the 52 proprietary AT commands 53 .Dq Li AT_OWANCALL 54 and 55 .Dq Li AT_OWANDATA 56 on any of the available serial ports. 57 .Pp 58 The network interface must be configured manually using the data obtain from 59 these calls. 60 .Pp 61 Each device usually have at least two or more serial ports, their individual purpose 62 can be identified through 63 .Xr sysctl 8 . 64 Ports identified as 65 .Dq Modem 66 features a normal modem interface that can be used with PPP. 67 Ports identified as 68 .Dq Diagnostic 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. 72 .Sh HARDWARE 73 The 74 .Nm 75 driver should work with most devices from Option. 76 The following devices have been verified to work 77 .Pp 78 .Bl -bullet -compact 79 .It 80 Option GlobeSurfer iCON 7.2 (new firmware) 81 .It 82 Option GlobeTrotter Max 7.2 (new firmware) 83 .It 84 Option iCON 225 85 .It 86 Option iCON 452 87 .It 88 Option iCON 505 89 .El 90 .Pp 91 The device features a mass storage device referred to as 92 .Dq Zero-CD 93 which contains drivers for Microsoft Windows; this is the default 94 mode for the device. 95 The 96 .Nm 97 driver automatically switches the device from 98 .Dq Zero-CD 99 mode to modem mode. 100 This behavior can be disabled by setting 101 .Va hw.usb.uhso.auto_switch 102 to 0 using 103 .Xr sysctl 8 104 .Sh FILES 105 .Bl -tag -width "XXXXXX" 106 .It Pa /dev/cuaU?.? 107 .El 108 .Sh EXAMPLES 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" 113 AT_OWANCALL=1,1,1 114 OK 115 _OWANCALL=1,1 116 117 AT_OWANDATA=1 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 120 .Ed 121 .Pp 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 128 .Ed 129 .Pp 130 The connection can be terminated with 131 .Bd -literal -offset indent 132 AT_OWANCALL=1,0,1 133 .Ed 134 .Sh SEE ALSO 135 .Xr uhsoctl 1 , 136 .Xr ucom 4 , 137 .Xr usb 4 138 .Sh AUTHORS 139 The 140 .Nm 141 driver was written by 142 .An Fredrik Lindberg Aq fli@shapeshifter.se . 143