UMSM(4)                   OpenBSD Programmer's Manual                  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
           AnyDATA ADU-500A                 USB
           AnyDATA ADU-E100H                USB
           AnyDATA A2502                    USB
           Emobile D01HW (Huawei OEM)       USB
           Emobile D02HW (Huawei OEM)       USB
           Emobile D12HW (Huawei OEM)       USB
           Emobile D22HW (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 E172               USB
           Huawei Mobile E180               USB
           Huawei Mobile E220               USB
           Huawei Mobile E510               USB
           Huawei Mobile Connect E169g      USB
           Huawei Mobile Connect E618       USB
           Huawei Mobile Connect E620       USB
           Kyocera KPC650                   CardBus
           Novatel Wireless ES620           USB
           Novatel Wireless Ovation U727    USB
           NTT DoCoMo A2502                 USB
           ONDA Communication H600          CardBus
           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 AirCard 580      CardBus
           Sierra Wireless AirCard 875      CardBus
           Sierra Wireless AirCard 881      CardBus
           Sierra Wireless AirCard 881U     USB
           Softbank C01SW (Sierra OEM)      USB
           Vodafone Mobile Connect 3G       CardBus

     Devices suspected of being compatible are:

           Device                           Bus
           Dell W5500                       PCI Express Mini Card
           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 U760            USB
           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 MC8755           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 Globe-
     Trotter 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
           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
     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 Globe-
     Trotter GT FUSION is not yet supported.

OpenBSD 4.7                    December 27, 2009                             3
