OpenBSD manual page server

Manual Page Search Parameters

UMSM(4) Device Drivers Manual UMSM(4)

umsmQualcomm MSM modem device

umsm* at uhub?
ucom* at umsm?

The umsm driver supports Qualcomm MSM modem adapters. The MSM chipset is found in EVDO, UMTS and LTE capable modems. Typically these are CardBus and PCI Express Mini Cards that incorporate a USB controller with the actual device attached to it.

The following devices are known to work with the umsm driver:

CardBus
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
USB
PCI Express Mini Card
USB
USB
USB
USB
USB
CardBus
USB
USB
USB
USB
USB
CardBus
USB
USB
CardBus
CardBus
CardBus
CardBus
CardBus
USB
USB
PCI Express Mini Card
PCI Express Mini Card
PCI Express Mini Card
PCI Express Mini Card
CardBus
CardBus
CardBus
USB
USB
USB
PCI Express Mini Card
CardBus
USB
USB
USB
USB
USB
USB

Devices suspected of being compatible are:

PCI Express Mini Card
USB
USB
USB
ExpressCard
CardBus
CardBus
ExpressCard
USB
CardBus
USB
CardBus
CardBus
CardBus
ExpressCard
ExpressCard
CardBus
CardBus
CardBus
ExpressCard
USB
ExpressCard
USB
USB
USB
PCI Express Mini Card
PCI Express Mini Card
PCI Express Mini Card
PCI Express Mini Card
PCI Express Mini Card

Some modems have multiple serial ports, however almost all modems have only one effective serial port for PPP connections. For example, the Huawei E220 has two serial ports, but only the first port can be used to make connections; the second one is for management. The Option GlobeTrotter HSDPA/HSUPA modems have three serial ports, but only the last port can be used to make PPP connections.

Some modems require multi-link ppp(8) operation. For example, the Huawei E1550 has four serial ports. When initiating a connection, the control commands have to be issued on the third port, and after that the actual PPP connection comes up on the first port. The function of the second and fourth ports is unknown.

An example /etc/ppp/ppp.conf configuration for Verizon Wireless might look something like below; see ppp(8) for more information.

default:
   set device /dev/cuaU0
   set speed 230400
   set dial "ABORT BUSY ABORT NO\\sCARRIER TIMEOUT 5 \
             \"\" AT OK-AT-OK ATE1Q0s7=60 OK \\dATDT\\T TIMEOUT 40 CONNECT"
   set phone "#777"
   set login
   set authname 4517654321@vzw3g.com
   set authkey vzw
   set timeout 120
   set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0 0.0.0.0
   add default HISADDR
   enable dns

In this example the phone number is (451) 765-4321: replace this with the number issued for the card or your phone's number if a handset is being used.

The Huawei E1550 requires a multi-link /etc/ppp/ppp.conf configuration as follows:

default:
   set speed 460800
   set login
   set authname
   set authkey
   set timeout 0
   set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0 0.0.0.0
   set cd off
   set mrru 1500
   clone ctrl,data
   link deflink remove
   link ctrl set device /dev/cuaU2
   link ctrl set dial "ABORT ERROR ABORT BUSY TIMEOUT 5 \
      \"\" ATZ \
      OK-ATZ-OK AT+CPIN? \
      +CPIN:\\sREADY\\r\\n\\r\\nOK-AT+CPIN=5027-OK ATE1Q0 \
      OK AT+CGDCONT=1,\\\"IP\\\",\\\"pinternet.interkom.de\\\" \
      OK \\dATDT\\T \
      CONNECT-\\dATDT\\T-CONNECT"
   link ctrl set phone "*99#"
   link ctrl set openmode passive
   link ctrl open
   link data set device /dev/cuaU0
   link data set dial
   link data set lcpretry 10 6
   link data open
   add default HISADDR
   enable dns

An example demand dial configuration for Cingular Wireless using pppd(8) appears below.

/etc/ppp/cingular-chat:

TIMEOUT 10
REPORT CONNECT
ABORT BUSY
ABORT 'NO CARRIER'
ABORT ERROR
'' ATZ OK AT&F OK
AT+CGDCONT=1,"IP","isp.cingular" OK
ATD*99***1# CONNECT

/etc/ppp/peers/ac875:

cuaU0
115200
debug
noauth
nocrtscts
:10.254.254.1
ipcp-accept-remote
defaultroute
user isp@cingulargprs.com
demand
active-filter 'not udp port 123'
persist
idle 600
connect "/usr/sbin/chat -v -f /etc/ppp/cingular-chat"

/etc/ppp/chap-secrets:

# Secrets for authentication using CHAP
# client		server	secret		IP addresses
isp@cingulargprs.com	*	CINGULAR1

pppd(8) is then started using:

# pppd call ac875

ucom(4), uhub(4), usb(4), ppp(8), pppd(8)

The umsm device driver first appeared in OpenBSD 4.0.

The umsm driver was written by Jonathan Gray ⟨jsg@openbsd.org⟩ and Yojiro UO ⟨yuo@nui.org⟩.

For Verizon Wireless (and possibly other services), cards require a one-time activation before they will work; umsm does not currently support this.

The additional IEEE 802.11 wireless chipset found in the Option GlobeTrotter GT FUSION is not yet supported.

January 4, 2013 OpenBSD-5.3