UHSO(4) Device Drivers Manual UHSO(4)

uhso
Option N.V. Wireless WAN modem driver

uhso* at uhub? port ?

The uhso driver supports at least the following adapters:

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

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.

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

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

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.

July 19, 2014 NetBSD 9.4