UHSO(4)

UHSO(4) | NetBSD Kernel Interfaces Manual | UHSO(4)

# NAME

uhso — Option N.V. Wireless WAN modem driver

# SYNOPSIS

uhso* at uhub? port ?

# HARDWARE

The uhso driver supports at least the following adapters:

GlobeSurfer HSUPA
GlobeSurfer iCON 7.2
GlobeTrotter Express 40x
GlobeTrotter Express HSUPA
GlobeTrotter HSUPA
GlobeTrotter Max HSDPA
GlobeTrotter Module 382
GlobeTrotter iCON 225
GlobeTrotter iCON 321
GlobeTrotter iCON 322
GlobeTrotter iCON 401
GlobeTrotter iCON 505
GlobeTrotter iCON EDGE

# DESCRIPTION

The Option N.V. modems appear at first as a umass(4) device containing the Windows and MacOS drivers and, upon receipt of a SCSI “REZERO UNIT” command, will detach from the USB bus and reattach as a Wireless WAN modem. Unless disabled by clearing the sysctl(8) variable hw.uhso.autoswitch, the driver will handle that automatically.

The modems provide a number of IO channels spread over several USB interfaces which are mapped by function to a standard port number in each driver instance. The defined channels are:

Channel Name | Port
Control | 0
Diagnostic | 1
Diagnostic 2 | 2
Application | 3
Application 2 | 4
GPS | 5
GPS Control | 6
PC Smartcard | 7
Modem | 8
MSD | 9
Voice | 10
Network | 11

Apart from the Network port, which is attached as a network interface, the ports are attached as tty(4) devices using the port number as the minor device number. In order to connect using pppd(8), the Modem tty should be used (eg /dev/ttyHS0.08).

The Network port provides a direct IPv4 interface, but before this can be used the modem needs to be placed in connected mode and network settings subsequently retrieved using the proprietary “_OWANCALL” and “_OWANDATA” AT commands on the Control port.

Note that the Modem and Network ports should not be enabled at the same time for USB performance reasons.

# FILES

/dev/ttyHS?.??
/dev/dtyHS?.??
/dev/ctyHS?.??

# SEE ALSO

intro(4), netintro(4), tty(4), uhub(4), usb(4), ifconfig(8)

# HISTORY

This driver originated as the hso module for FreeBSD written by Frederik Lindberg. It was rewritten for NetBSD, and to provide more complete device support with information extracted from the hso driver for Linux provided by Option N.V.

The rewrite and this manual page by Iain Hibbert.

August 26, 2011 | NetBSD 5.99