MF627 @May 17, 2013 8:53:06 PM

3G USB dongle

Packages we will require:

• eject - for converting the device from a CD-ROM into a modem
• ppp - for pppd and chat applications
• gammu and gammu-smsd - for receiving SMS text messages and running commands
• postfix - for sending email messages

sudo apt-get update
sudo apt-get install -y eject ppp gammu gammu-smsd postfix

Configure postfix as an Internet mail server.

Convert from CD-ROM to modem

The '3' 3G USB dongle I'm connecting to my Raspberry Pi is a ZTE MF627. It has two modes, when it's originally plugged in it appears as a USB CD-ROM, for automatically installing software drivers, and has to be ejected before it turns into a network device. When the device is a CD-ROM it's ID is 19d2:2000, when it's a network device the ID is 19d2:0031.

USB Modeswitch

If you have a modern Rasprian then USB Modeswitch will be installed and it will automatically eject the CD-ROM device for you. Otherwise you can run the eject command from udev, like this.

Create:
/etc/udev/rules.d/10-ZTE_MF627.rules
with this contents:
SUBSYSTEM=="block", KERNEL=="sr[0-9]*", SUBSYSTEMS=="usb", ATTRS{idVendor}=="19d2", ATTRS{idProduct}=="2000", RUN+="/bin/sh -c '/bin/sleep 12; /usr/bin/eject %k; /vib/sleep 1; /usr/bin/eject %k;'&", OPTIONS+="last_rule"

Now when the dongle is inserted the udev daemon spots the device and sends the eject command. You can check the device ID with lsusb.

We can test the device now with chat:

chat -s -v '' ATZ OK AT+CSQ OK >/dev/ttyUSB2 </dev/ttyUSB2

in the output you'll see the current signal strength.

Run pppd

First we'll create a pppd config file and it's associated modem chat file.

Create:
/etc/ppp/peers/giffgaff
with this contents:
/dev/ttyUSB2
460800
user giffgaff
password password

defaultroute
connect "/usr/sbin/chat -v -f /etc/ppp/peers/giffgaff.chat"
ipparam giffgaff
hide-password
lock
maxfail 0
mtu 1492
noauth
noipdefault
persist
usepeerdns

Create:
/etc/ppp/peers/giffgaff.chat
with this contents:
ABORT BUSY ABORT 'NO CARRIER'
ABORT VOICE ABORT 'NO DIALTONE'
ABORT 'NO DIAL TONE' ABORT 'NO ANSWER'
ABORT DELAYED
'' ATZ
OK ATQ0V1E1S0=0&C1&D2+FCLASS=0
OK AT+CGDCONT=1,"ip","giffgaff.com"
OK-AT-OK ATDT*99***1#
CONNECT \d\c

Create:
/etc/ppp/ip-up.d/default_route
with this contents:
#!/bin/sh -e
# Called when a new interface comes up

/sbin/route del default
Make it runnable
chmod a+x /etc/ppp/ip-up.d/default_route
and test with
pon giffgaff

Run from udev

Create:
/usr/local/bin/ZTE_MF627
with this contents:
#!/bin/sh -e

logger "$0" "$ACTION"

case $ACTION in
add )
sleep 2
service gammu-smsd stop
sleep 2
pon giffgaff
sleep 10
service gammu-smsd start
;;
remove )
service gammu-smsd stop
poff giffgaff
;;
esac

KERNEL=="ttyUSB0", SUBSYSTEM=="tty", ATTRS{idVendor}=="19d2", ATTRS{idProduct}=="0031", RUN+="/usr/local/bin/ZTE_MF627", OPTIONS+="last_rule"

---

!!!3G USB dongle!!! Packages we will require: * eject - for converting the device from a CD-ROM into a modem * ppp - for pppd and chat applications * gammu and gammu-smsd - for receiving SMS text messages and running commands * postfix - for sending email messages {{{__sudo apt-get update sudo apt-get install -y eject ppp gammu gammu-smsd postfix__}}} Configure postfix as an Internet mail server. !!Convert from CD-ROM to modem!! The '3' 3G USB dongle I'm connecting to my Raspberry Pi is a ZTE MF627. It has two modes, when it's originally plugged in it appears as a USB CD-ROM, for automatically installing software drivers, and has to be ejected before it turns into a network device. When the device is a CD-ROM it's ID is 19d2:2000, when it's a network device the ID is 19d2:0031. !USB Modeswitch! If you have a modern Rasprian then USB Modeswitch will be installed and it will automatically eject the CD-ROM device for you. Otherwise you can run the eject command from udev, like this. Create: {{{__/etc/udev/rules.d/10-ZTE_MF627.rules__}}} with this contents: {{{__SUBSYSTEM=="block", KERNEL=="sr[0-9]*", SUBSYSTEMS=="usb", ATTRS{idVendor}=="19d2", ATTRS{idProduct}=="2000", RUN+="/bin/sh -c '/bin/sleep 12; /usr/bin/eject %k; /vib/sleep 1; /usr/bin/eject %k;'&", OPTIONS+="last_rule"__}}} Now when the dongle is inserted the udev daemon spots the device and sends the eject command. You can check the device ID with lsusb. We can test the device now with chat: {{{__chat -s -v '' ATZ OK AT+CSQ OK >/dev/ttyUSB2 </dev/ttyUSB2__}}} in the output you'll see the current signal strength. !!Run pppd!! First we'll create a pppd config file and it's associated modem chat file. Create: {{{__/etc/ppp/peers/giffgaff__}}} with this contents: {{{__/dev/ttyUSB2 460800 user giffgaff password password defaultroute connect "/usr/sbin/chat -v -f /etc/ppp/peers/giffgaff.chat" ipparam giffgaff hide-password lock maxfail 0 mtu 1492 noauth noipdefault persist usepeerdns__}}} Create: {{{__/etc/ppp/peers/giffgaff.chat__}}} with this contents: {{{__ABORT BUSY ABORT 'NO CARRIER' ABORT VOICE ABORT 'NO DIALTONE' ABORT 'NO DIAL TONE' ABORT 'NO ANSWER' ABORT DELAYED '' ATZ OK ATQ0V1E1S0=0&C1&D2+FCLASS=0 OK AT+CGDCONT=1,"ip","giffgaff.com" OK-AT-OK ATDT*99***1# CONNECT \d\c__}}} Create: {{{__/etc/ppp/ip-up.d/default_route__}}} with this contents: {{{__#!/bin/sh -e # Called when a new interface comes up /sbin/route del default__}}} Make it runnable {{{__chmod a+x /etc/ppp/ip-up.d/default_route__}}} and test with {{{__pon giffgaff__}}} !Run from udev! Create: {{{__/usr/local/bin/ZTE_MF627__}}} with this contents: {{{__#!/bin/sh -e logger "$0" "$ACTION" case $ACTION in add ) sleep 2 service gammu-smsd stop sleep 2 pon giffgaff sleep 10 service gammu-smsd start ;; remove ) service gammu-smsd stop poff giffgaff ;; esac__}}} {{{__KERNEL=="ttyUSB0", SUBSYSTEM=="tty", ATTRS{idVendor}=="19d2", ATTRS{idProduct}=="0031", RUN+="/usr/local/bin/ZTE_MF627", OPTIONS+="last_rule"__}}}