tail head cat sleep
QR code linking to this page
Main index Section 4
Go to:
Options

Manual Pages  — UHSO

NAME

uhso – support for several HSxPA devices from Option N.V.

CONTENTS

SYNOPSIS

The module can be loaded at boot time by placing the following line in loader.conf(5): 
uhso_load="YES"

DESCRIPTION

The uhso 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 ucom(4) driver which makes them behave like tty(4) devices. The packet interface is exposed as a network interface.

Establishing a connection on the packet interface is achieved by using the proprietary AT commands "AT_OWANCALL" and "AT_OWANDATA" on any of the available serial ports.

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

Each device usually have at least two or more serial ports, their individual purpose can be identified through sysctl(8). Ports identified as "Modem" features a normal modem interface that can be used with PPP. Ports identified as "Diagnostic" uses a proprietary binary interface used for firmware upgrades, this port does not have a AT command interface and can not be used to control the device. Other ports features an AT command interface that can be used for normal device control.

HARDWARE

The uhso driver should work with most devices from Option. The following devices have been verified to work

The device features a mass storage device referred to as "Zero-CD" which contains drivers for Microsoft Windows; this is the default mode for the device. The uhso driver automatically switches the device from "Zero-CD" mode to modem mode. This behavior can be disabled by setting hw.usb.uhso.auto_switch to 0 using sysctl(8).

FILES

/dev/cuaU?.?
 

EXAMPLES

Establishing a packet interface connection using the AT command interface available at one of the serial ports 
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, \
        0.0.0.0, 0.0.0.0, 72000

Configuring the interface 

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

The connection can be terminated with 

AT_OWANCALL=1,0,1

SEE ALSO

uhsoctl(1), ucom(4), usb(4)

AUTHORS

The uhso driver was written by Fredrik Lindberg <Mt fli@shapeshifter.se>.
UHSO (4) July 20, 2010
tail head cat sleep
QR code linking to this page
Main index Section 4
Go to:
Options

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“ Computer science would have progressed much further and faster if all of the time and effort that has been spent maintaining and nurturing Unix had been spent on a sounder operating system. ”
— The Unix Haters' handbook