1.\" $OpenBSD: umsm.4,v 1.72 2011/09/03 22:59:08 jmc Exp $ 2.\" 3.\" Copyright (c) 2006 Jonathan Gray <jsg@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: September 3 2011 $ 18.Dt UMSM 4 19.Os 20.Sh NAME 21.Nm umsm 22.Nd Qualcomm MSM modem device 23.Sh SYNOPSIS 24.Cd "umsm* at uhub?" 25.Cd "ucom* at umsm?" 26.Sh DESCRIPTION 27The 28.Nm 29driver supports Qualcomm MSM modem adapters. 30The MSM chipset is found in EVDO and UMTS capable modems. 31Typically these are CardBus and PCI Express Mini Cards that incorporate a 32USB controller with the actual device attached to it. 33.Pp 34The following devices are known to work with the 35.Nm 36driver: 37.Bl -column "Option GlobeTrotter HSDPA ICON225" "Bus" -offset 6n 38.It Em Device Ta Em Bus 39.It Li "AirPrime PC5220" Ta "CardBus" 40.It Li "Alcatel One Touch X060" Ta "USB" 41.It Li "Alcatel One Touch X200" Ta "USB" 42.It Li "AnyDATA ADU-500A" Ta "USB" 43.It Li "AnyDATA ADU-E100H" Ta "USB" 44.It Li "AnyDATA A2502" Ta "USB" 45.It Li "C-motech CNU 680" Ta "USB" 46.It Li "Emobile D01HW (Huawei OEM)" Ta "USB" 47.It Li "Emobile D02HW (Huawei OEM)" Ta "USB" 48.It Li "Emobile D12HW (Huawei OEM)" Ta "USB" 49.It Li "Emobile D22HW (Huawei OEM)" Ta "USB" 50.It Li "Emobile D31HW (Huawei OEM)" Ta "USB" 51.It Li "Emobile H12HW (Huawei OEM)" Ta "USB" 52.It Li "Emobile D21LC (longcheer OEM)" Ta "USB" 53.It Li "Huawei Mobile E156G" Ta "USB" 54.It Li "Huawei Mobile E160E" Ta "USB" 55.It Li "Huawei Mobile E161" Ta "USB" 56.It Li "Huawei Mobile E160g" Ta "USB" 57.It Li "Huawei Mobile E1692" Ta "USB" 58.It Li "Huawei Mobile E172" Ta "USB" 59.It Li "Huawei Mobile E180" Ta "USB" 60.It Li "Huawei Mobile E181" Ta "USB" 61.It Li "Huawei Mobile E182" Ta "USB" 62.It Li "Huawei Mobile E220" Ta "USB" 63.It Li "Huawei Mobile E510" Ta "USB" 64.It Li "Huawei Mobile E1750" Ta "USB" 65.It Li "Huawei Mobile E1752" Ta "USB" 66.It Li "Huawei Mobile Connect E169g" Ta "USB" 67.It Li "Huawei Mobile Connect E618" Ta "USB" 68.It Li "Huawei Mobile Connect E620" Ta "USB" 69.It Li "IIJMobile 120FU (ZTE OEM)" Ta "USB" 70.It Li "Kyocera KPC650" Ta "CardBus" 71.It Li "Novatel Wireless ES620" Ta "USB" 72.It Li "Novatel Wireless Ovation U727" Ta "USB" 73.It Li "Novatel Wireless U760" Ta "USB" 74.It Li "NTT DoCoMo A2502" Ta "USB" 75.It Li "ONDA Communication H600" Ta "CardBus" 76.It Li "ONDA Communication MSA110UP" Ta "USB" 77.It Li "Option GlobeSurfer ICON7.2" Ta "USB" 78.It Li "Option GlobeTrotter 3G+" Ta "CardBus" 79.It Li "Option GlobeTrotter 3G Quad" Ta "CardBus" 80.It Li "Option GlobeTrotter 3G Quad Plus" Ta "CardBus" 81.It Li "Option GlobeTrotter GT Fusion" Ta "CardBus" 82.It Li "Option GlobeTrotter GT Max" Ta "CardBus" 83.It Li "Option GlobeTrotter HSDPA" Ta "USB" 84.It Li "Option GlobeTrotter HSDPA ICON225" Ta "USB" 85.It Li "Option GlobeTrotter HSUPA 380E" Ta "PCI Express Mini Card" 86.It Li "Sierra Wireless MC8755" Ta "PCI Express Mini Card" 87.It Li "Sierra Wireless MC8775" Ta "PCI Express Mini Card" 88.It Li "Sierra Wireless MC8790" Ta "PCI Express Mini Card" 89.It Li "Sierra Wireless AirCard 580" Ta "CardBus" 90.It Li "Sierra Wireless AirCard 875" Ta "CardBus" 91.It Li "Sierra Wireless AirCard 881" Ta "CardBus" 92.It Li "Sierra Wireless AirCard 881U" Ta "USB" 93.It Li "Sierra Wireless Inc. USB 305" Ta "USB" 94.It Li "Softbank C01SW (Sierra OEM)" Ta "USB" 95.It Li "Toshiba 3G HSDPA MiniCard" Ta "PCI Express Mini Card" 96.It Li "Vodafone Mobile Connect 3G" Ta "CardBus" 97.It Li "Vodafone Mobile Broadband K3765" Ta "USB" 98.It Li "ZTE AC2746" Ta "USB" 99.It Li "ZTE MF112" Ta "USB" 100.It Li "ZTE MF633" Ta "USB" 101.It Li "ZTE MF637" Ta "USB" 102.El 103.Pp 104Devices suspected of being compatible are: 105.Bl -column "Option GlobeTrotter HSDPA ICON225" "Bus" -offset 6n 106.It Em Device Ta Em Bus 107.It Li "Dell W5500" Ta "PCI Express Mini Card" 108.It Li "Huawei E270+" Ta "USB" 109.It Li "Huawei E1550" Ta "USB" 110.It Li "Huawei E1690" Ta "USB" 111.It Li "Huawei E1762" Ta "USB" 112.It Li "Huawei E1820" Ta "USB" 113.It Li "Novatel Wireless ExpressCard" Ta "ExpressCard" 114.It Li "Novatel Wireless Merlin V620" Ta "CardBus" 115.It Li "Novatel Wireless Merlin V740" Ta "CardBus" 116.It Li "Novatel Wireless Merlin X950D" Ta "ExpressCard" 117.It Li "Novatel Wireless MC950D" Ta "USB" 118.It Li "Novatel Wireless S720" Ta "CardBus" 119.It Li "Novatel Wireless U720" Ta "USB" 120.It Li "Novatel Wireless U740" Ta "CardBus" 121.It Li "Novatel Wireless U870" Ta "CardBus" 122.It Li "Novatel Wireless V720" Ta "CardBus" 123.It Li "Novatel Wireless X950D" Ta "ExpressCard" 124.It Li "Novatel Wireless XU870 HSDPA" Ta "ExpressCard" 125.It Li "Sierra Wireless AirCard 595" Ta "CardBus" 126.It Li "Sierra Wireless AirCard 597E" Ta "CardBus" 127.It Li "Sierra Wireless AirCard 880" Ta "CardBus" 128.It Li "Sierra Wireless AirCard 880E" Ta "ExpressCard" 129.It Li "Sierra Wireless AirCard 880U" Ta "USB" 130.It Li "Sierra Wireless AirCard 881E" Ta "ExpressCard" 131.It Li "Sierra Wireless AirCard 885U" Ta "USB" 132.It Li "Sierra Wireless C597" Ta "USB" 133.It Li "Sierra Wireless EM5625" Ta "USB" 134.It Li "Sierra Wireless MC5720" Ta "PCI Express Mini Card" 135.It Li "Sierra Wireless MC5725" Ta "PCI Express Mini Card" 136.It Li "Sierra Wireless MC8755" Ta "PCI Express Mini Card" 137.It Li "Sierra Wireless MC8765" Ta "PCI Express Mini Card" 138.It Li "Sierra Wireless MC8780" Ta "PCI Express Mini Card" 139.It Li "Sierra Wireless MC8781" Ta "PCI Express Mini Card" 140.El 141.Pp 142Some modems have multiple serial ports, 143however almost all modems have only one effective serial port 144for PPP connections. 145For example, the Huawei E220 has two serial ports, 146but only the first port can be used to make connections; 147the second one is for management. 148The Option GlobeTrotter HSDPA/HSUPA modems have three serial ports, 149but only the last port can be used to make PPP connections. 150.Sh EXAMPLES 151An example 152.Pa /etc/ppp/ppp.conf 153configuration for Verizon Wireless might look something like below; 154see 155.Xr ppp 8 156for more information. 157.Bd -literal -offset indent 158default: 159 set device /dev/cuaU0 160 set speed 230400 161 set dial "ABORT BUSY ABORT NO\e\esCARRIER TIMEOUT 5 \e 162 \e"\e" AT OK-AT-OK ATE1Q0s7=60 OK \e\edATDT\e\eT TIMEOUT 40 CONNECT" 163 set phone "#777" 164 set login 165 set authname 4517654321@vzw3g.com 166 set authkey vzw 167 set timeout 120 168 set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0 0.0.0.0 169 add default HISADDR 170 enable dns 171.Ed 172.Pp 173In this example the phone number is (451) 765-4321: replace this with 174the number issued for the card or your phone's number if a handset is being 175used. 176.Pp 177An example demand dial configuration for Cingular Wireless using 178.Xr pppd 8 179appears below. 180.Pp 181.Pa /etc/ppp/cingular-chat : 182.Bd -literal -offset indent 183TIMEOUT 10 184REPORT CONNECT 185ABORT BUSY 186ABORT 'NO CARRIER' 187ABORT ERROR 188\&'' ATZ OK AT&F OK 189AT+CGDCONT=1,"IP","isp.cingular" OK 190ATD*99***1# CONNECT 191.Ed 192.Pp 193.Pa /etc/ppp/peers/ac875 : 194.Bd -literal -offset indent 195cuaU0 196115200 197debug 198noauth 199nocrtscts 200:10.254.254.1 201ipcp-accept-remote 202defaultroute 203user isp@cingulargprs.com 204demand 205active-filter 'not udp port 123' 206persist 207idle 600 208connect "/usr/sbin/chat -v -f /etc/ppp/cingular-chat" 209.Ed 210.Pp 211.Pa /etc/ppp/chap-secrets : 212.Bd -literal -offset indent 213# Secrets for authentication using CHAP 214# client server secret IP addresses 215isp@cingulargprs.com * CINGULAR1 216.Ed 217.Pp 218.Xr pppd 8 219is then started using: 220.Pp 221.Dl # pppd call ac875 222.Sh SEE ALSO 223.Xr ucom 4 , 224.Xr uhub 4 , 225.Xr usb 4 , 226.Xr ppp 8 , 227.Xr pppd 8 228.Sh HISTORY 229The 230.Nm 231device driver first appeared in 232.Ox 4.0 . 233.Sh AUTHORS 234.An -nosplit 235The 236.Nm 237driver was written by 238.An Jonathan Gray 239.Aq jsg@openbsd.org , 240and 241.An Yojiro UO 242.Aq yuo@nui.org . 243.Sh CAVEATS 244For Verizon Wireless (and possibly other services), 245cards require a one-time activation before they will work; 246.Nm 247does not currently support this. 248.Pp 249The additional IEEE 802.11 wireless chipset found in the Option 250GlobeTrotter GT FUSION is not yet supported. 251