uhso.4 revision 202181
Copyright (c) 2009 Fredrik Lindberg
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

$FreeBSD: head/share/man/man4/uhso.4 202181 2010-01-13 03:16:31Z thompsa $

.Dd Aug 12, 2009 .Os .Dt UHSO 4 .Sh NAME .Nm hso .Nd support for several HSxPA devices from Option N.V. .Sh SYNOPSIS The module can be loaded at boot time by placing the following line in .Xr loader.conf 5 : d -literal -offset indent uhso_load="YES" .Ed .Sh DESCRIPTION The .Nm driver provides support for several HSxPA devices from Option N.V. that are based on their packet interface. Each device has a set of serial ports and a raw IP packet interface. The serial ports of the device are accessed through the .Xr ucom 4 driver which makes them behave like a .Xr tty 4 . The packet interface is exposed as a network interface.

p To establish a connection on the packet interface the use of the proprietary AT commands .Dq Li AT_OWANCALL and .Dq Li AT_OWANDATA are required on any of the serial ports.

p The network interface must be configured manually using the data obtain from these calls.

p Each device usually have at least two or more serial ports, their individual purpose can be identified through .Xr sysctl 8 . .Sh HARDWARE The .Nm driver supports at least the following cards

p l -bullet -compact t Option GlobeSurfer iCON 7.2 (new firmware) t Option iCON 225 .El

p The device features a mass storage device referred to as .Dq Zero-CD which contains drivers for Microsoft Windows. The driver automatically switches the device to modem mode. .Sh EXAMPLES Establishing a packet interface connection d -literal -offset indent AT+CGDCONT=1,,"apn.provider" AT_OWANCALL=1,1,1 OK _OWANCALL=1,1 AT_OWANDATA=1 _OWANDATA: 1, 10.11.12.13, 0.0.0.0, 10.2.3.4, 10.2.3.5, \e 0.0.0.0, 0.0.0.0, 72000 .Ed

p Configuring the interface d -literal -offset indent ifconfig uhso0 10.11.12.13 up route add default -interface uhso0 echo "nameserver 10.2.3.4" > /etc/resolv.conf echo "nameserver 10.2.3.5" >> /etc/resolv.conf .Ed

p The connection can be terminated with d -literal -offset indent AT_OWANCALL=1,0,1 .Ed .Sh FILES l -tag -width "XXXXXX" t Pa /dev/cuaU?.? .El .Sh SEE ALSO .Xr ucom 4 , .Xr usb 4 .Sh AUTHORS The .Nm driver was written by .An Fredrik Lindberg Aq fli@shapeshifter.se .