UMSM(4)

NAME
umsm - Qualcomm MSM modem device

SYNOPSIS
umsm* at uhub?
ucom* at umsm?

DESCRIPTION
The umsm driver supports Qualcomm MSM modem adapters. The MSM chipset is found in EVDO and UMTS 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:
Device | Bus
AirPrime PC5220 | CardBus
Alcatel One Touch X060 | USB
Alcatel One Touch X200 | USB
Alcatel One Touch X210 | USB
Alcatel One Touch X220 | USB
AnyDATA ADU-500A | USB
AnyDATA ADU-E100H | USB
AnyDATA A2502 | USB
C-motech CNU 680 | USB
Emobile D01HW (Huawei OEM) | USB
Emobile D02HW (Huawei OEM) | USB
Emobile D12HW (Huawei OEM) | USB
Emobile D22HW (Huawei OEM) | USB
Emobile D31HW (Huawei OEM) | USB
Emobile H12HW (Huawei OEM) | USB
Emobile D21LC (longcheer OEM) | USB
Huawei Mobile E156G | USB
Huawei Mobile E160E | USB
Huawei Mobile E161 | USB
Huawei Mobile E160g | USB
Huawei Mobile E1692 | USB
Huawei Mobile E172 | USB
Huawei Mobile E173 | USB
Huawei Mobile E173s | USB
Huawei Mobile E180 | USB
Huawei Mobile E181 | USB
Huawei Mobile E182 | USB
Huawei Mobile E220 | USB
Huawei Mobile E303 | USB
Huawei Mobile E510 | USB
Huawei Mobile E1750 | USB
Huawei Mobile E1752 | USB
Huawei Mobile E1820 | USB
Huawei Mobile EM770W | PCI Express Mini Card
Huawei Mobile K4510 | USB
Huawei Mobile Connect E169g | USB
Huawei Mobile Connect E618 | USB
Huawei Mobile Connect E620 | USB
IIJMobile 120FU (ZTE OEM) | USB
Kyocera KPC650 | CardBus
Novatel Wireless ES620 | USB
Novatel Wireless Ovation U727 | USB
Novatel Wireless U760 | USB
NTT DoCoMo A2502 | USB
ONDA Communication H600 | CardBus
ONDA Communication MSA110UP | USB
Option GlobeSurfer ICON7.2 | USB
Option GlobeTrotter 3G+ | CardBus
Option GlobeTrotter 3G Quad | CardBus
Option GlobeTrotter 3G Quad Plus | CardBus
Option GlobeTrotter GT Fusion | CardBus
Option GlobeTrotter GT Max | CardBus
Option GlobeTrotter HSDPA | USB
Option GlobeTrotter HSDPA ICON225 | USB
Option GlobeTrotter HSUPA 380E | PCI Express Mini Card
Sierra Wireless MC8755 | PCI Express Mini Card
Sierra Wireless MC8775 | PCI Express Mini Card
Sierra Wireless MC8790 | PCI Express Mini Card
Sierra Wireless AirCard 580 | CardBus
Sierra Wireless AirCard 875 | CardBus
Sierra Wireless AirCard 881 | CardBus
Sierra Wireless AirCard 881U | USB
Sierra Wireless Inc. USB 305 | USB
Softbank C01SW (Sierra OEM) | USB
Toshiba 3G HSDPA MiniCard | PCI Express Mini Card
Vodafone Mobile Connect 3G | CardBus
Vodafone Mobile Broadband K3765 | USB
ZTE AC2746 | USB
ZTE MF112 | USB
ZTE MF190 | USB
ZTE MF633 | USB
ZTE MF637 | USB

Devices suspected of being compatible are:
Device | Bus
Dell W5500 | PCI Express Mini Card
Huawei E270+ | USB
Huawei E1550 | USB
Huawei E1690 | USB
Huawei E1762 | USB
Novatel Wireless ExpressCard | ExpressCard
Novatel Wireless Merlin V620 | CardBus
Novatel Wireless Merlin V740 | CardBus
Novatel Wireless Merlin X950D | ExpressCard
Novatel Wireless MC950D | USB
Novatel Wireless S720 | CardBus
Novatel Wireless U720 | USB
Novatel Wireless U740 | CardBus
Novatel Wireless U870 | CardBus
Novatel Wireless V720 | CardBus
Novatel Wireless X950D | ExpressCard
Novatel Wireless XU870 HSDPA | ExpressCard
Sierra Wireless AirCard 595 | CardBus
Sierra Wireless AirCard 597E | CardBus
Sierra Wireless AirCard 880 | CardBus
Sierra Wireless AirCard 880E | ExpressCard
Sierra Wireless AirCard 880U | USB
Sierra Wireless AirCard 881E | ExpressCard
Sierra Wireless AirCard 885U | USB
Sierra Wireless C597 | USB
Sierra Wireless EM5625 | USB
Sierra Wireless MC5720 | PCI Express Mini Card
Sierra Wireless MC5725 | PCI Express Mini Card
Sierra Wireless MC8765 | PCI Express Mini Card
Sierra Wireless MC8780 | PCI Express Mini Card
Sierra Wireless MC8781 | 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.

EXAMPLES
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.

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

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

HISTORY
The umsm device driver first appeared in OpenBSD 4.0.

AUTHORS
-nosplit The umsm driver was written by Jonathan Gray <jsg@openbsd.org> and Yojiro UO <yuo@nui.org>.

CAVEATS
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.