Ericsson F3507g Mobile Broadband Module

2009-10-30T22:21:44Z

Frank42:

__TOC__

Here are some basics about Ericsson F3507g MiniPCIe WWAN/GPS card (USB ID <tt>0bdb:1900</tt> and <tt>0bdb:1902</tt>):

* the card will not work without an inserted SIM, even the GPS function. If you want to use just GPS, any SIM would work, even if it is not attached to any active account with any GSM provider.
* the card provides three CDC ACM interfaces (<tt>CONFIG_USB_ACM=m</tt>), two CDC WDM interfaces (<tt>CONFIG_USB_WDM=m</tt>) and one CDC Ethernet interface (<tt>CONFIG_USB_NET_CDCETHER=m</tt>), and identifies them as
for n in `ls /sys/class/*/*{ACM,wdm,usb0}*/device/interface`;do echo $(echo $n|awk -F '/' '{print $5}') : $(cat $n);done

usb0 : Ericsson F3507g Mobile Broadband Minicard Network Adapter
ttyACM0 : Ericsson F3507g Mobile Broadband Minicard Modem
ttyACM1 : Ericsson F3507g Mobile Broadband Minicard Data Modem
ttyACM2 : Ericsson F3507g Mobile Broadband Minicard GPS Port
cdc-wdm0 : Ericsson F3507g Mobile Broadband Minicard Device Management
cdc-wdm1 : Ericsson F3507g Mobile Broadband Minicard PC SC Port
'''Note''':
*apparently, for a while <tt>option</tt> USB-serial driver had claimed USB ID <tt>0bdb:1900</tt>, but this was wrong, and as of kernel 2.6.28.9 that commit was reversed. If instead of <tt>/dev/ttyACM*</tt> you see <tt>/dev/ttyUSB*</tt>, it means that <tt>option</tt> module is loaded. You may need to blacklist it to make sure it doesn't happen.
*Support for the CDC Ethernet interface appears only in kernel 2.6.28.8. But if your kernel is older, you can still connect to the net using one of the "Modem" interfaces.

As Ericsson's naming scheme suggests, idealy we would use <tt>/dev/cdc-wdm0</tt> for controlling the card, <tt>usb0</tt> as a network device, <tt>/dev/ttyACM0</tt> or <tt>/dev/ttyACM1</tt> as a modem, and <tt>/dev/ttyACM2</tt> for GPS. This works for manual testing, but unfortunately, due to [http://markmail.org/message/2sd7culbgekugow2 limitations] of <tt>chat</tt>, does not play very well in scripts. So, instead of <tt>/dev/cdc-wdm0</tt>, for controlling the card we will use <tt>/dev/ttyACM1</tt>.

==Turning the card on==
First, check whenever the SIM is protected by PIN by sending

AT+CPIN?

to <tt>/dev/ttyACM1</tt>. You can do it with any terminal terminal program like <tt>cu</tt> or <tt>minicom</tt>. If the answer is

+CPIN: READY

then the SIM is unlocked. If the answer is

+CPIN: SIM PIN

you need first to unlock it by sending

AT+CPIN="YOUR-PIN"

to <tt>/dev/ttyACM1</tt>. Now the card can be turned on by sending

AT+CFUN=1

to <tt>/dev/ttyACM1</tt>. The answer should be

+PACSP0

Don't try to do anything until you see it. To force GSM-only connection, send

AT+CFUN=5

to <tt>/dev/ttyACM1</tt>. To force WCDMA-only connection, send

AT+CFUN=6

to <tt>/dev/ttyACM1</tt>.

==Turning the card off==
To put the card into energy-saving mode (this is the default), you can send

AT+CFUN=4

to <tt>/dev/ttyACM1</tt>. To remove all power from the card, send

AT+CFUN=0

to <tt>/dev/ttyACM1</tt>. Be carefull with the last command. It turns the card completely off, and it will no longer accept any AT-commands before the hard reset. To physically reset the card flip the wireless switch off, and then on. You can do the same by sending <tt>echo 0 > /sys/devices/platform/thinkpad_acpi/rfkill/rfkill0/state</tt> (to turn off) and then <tt>echo 1 > /sys/devices/platform/thinkpad_acpi/rfkill/rfkill0/state</tt> (to turn on).

==Using the card as a wireless modem==
Once the card is turned on, there are two ways to connect to the net. The first one is just to use the card as any "normal" GPRS modem and start <tt>pppd</tt> daemon on one of <tt>/dev/ttyACM*</tt>. The other way is to use CDC Ethernet interface. It is supposed to be more efficient, but it requires a pretty recent (>=2.6.28.8) kernel.

====Connecting to the net via pppd====
For the first approach, the easiest way to do it is to use <tt>wvdial</tt>. For example, to connect to AT&T Wireless network, your <tt>/etc/wvdial.conf</tt> would have to be something like this
[Dialer 3G]
Modem = /dev/ttyACM0
Init1 = AT+CGDCONT=1,"IP","'''proxy'''"
Stupid mode = 1
phone= *99#
Username = *
Password = *
'''Note''': if you are using a SIM from a different mobile provider, you may need to change the access point name (APN) "'''proxy'''" in <tt>Init1</tt> string and Username/Password to something else. You can find the appropriate APN [http://www.pinstack.com/carrier_settings_apn_gateway.html here].

====Connecting to the net via CDC Ethernet interface====
The [http://marc.info/?l=linux-usb&m=123334979706403&w=2 second approach] works for kernels >=2.6.28.8. Configure the APN by sending

AT+CGDCONT=1,"IP","'''proxy'''"

to <tt>/dev/ttyACM1</tt>. Instead of "'''proxy'''" you may need to use to something else. Find the appropriate APN [http://www.pinstack.com/carrier_settings_apn_gateway.html here]. To initiate the connection, send

AT*ENAP=1,1

to <tt>/dev/ttyACM1</tt>. Now, if your wireless provider lets you in, you are connected. Launch <tt>dhclient</tt>

dhclient usb0

and start surfing the net. To disconnect, send

AT*ENAP=0

to <tt>/dev/ttyACM1</tt>.

==Using the card as a GPS receiver==
Once the card is turned on, we can use it to get GPS info via NMEA protocol. First, you have to configure the a few NMEA options. It is done by sending

AT*E2GPSCTL=X,Y,Z

to <tt>/dev/ttyACM1</tt>. Here

*X can be 0 (NMEA stream turned off) or 1 (NMEA stream turned on)
*Y can be an integer form 1 to 60, and sets the frequency of how often the card emits the NMEA sentences
*Z can be 0 (DGPS is turned off) or 1 (DGPS is turned on)

so, to configure the GPSr to update every 5 seconds, and turn DGPS on, you would send

AT*E2GPSCTL=1,5,1

to <tt>/dev/ttyACM1</tt>. Once the GPSr is configured, we can get the NMEA stream on /dev/ttyACM2 by sending

AT*E2GPSNPD

to <tt>/dev/ttyACM2</tt>. Once you do that, <tt>/dev/ttyACM2</tt> will no longer accept any new AT-commands. But you still can change the the behavior of the NMEA stream by sending the appropriate

AT*E2GPSCTL=X,Y,Z

to <tt>/dev/ttyACM1</tt>. Now you can read the NMEA stream by saying

cat /dev/ttyACM2

or better yet, start <tt>gpsd</tt> interface on <tt>/dev/ttyACM2</tt>.

Note: There is a now a sourceforge project dedicated to the Ericsson Mobile Broadband modules. Gps control sw that does the above automatically is available and also a graphical user interface. Details are available on the [http://sourceforge.net/apps/mediawiki/mbm/index.php?title=Main_Page#GPS_Control_.28mbm-gpsd.29 MBM Wiki].

==Scripting everything==
Install the packages

apt-get install sysfsutils gpsd wvdial

In order to save the power, lets use '''sysfsutils''' to completely power off the WWAN card on boot. Append the following line to <tt>/etc/sysfs.conf</tt>

devices/platform/thinkpad_acpi/rfkill/rfkill0/state = 0

It will power down the card on boot, but when the laptop wakes from sleep, in some cases the card is powered up agian. To re-apply these settings on wake-up, create a script named <tt>/etc/pm/sleep.d/10sysfsutils</tt>:

#!/bin/sh
case $1 in
(hibernate|suspend)
;;
(thaw|resume)
/etc/init.d/sysfsutils start
;;
*) echo "somebody is calling me totally wrong."
;;
esac

Don't forget to <tt>chmod a+x /etc/pm/sleep.d/10sysfsutils</tt>. Create a file called <tt>/usr/local/etc/F3507g</tt> containing the following:

GPSDPID="/var/run/gpsd.pid"
CONTROL_DEVICE="/dev/ttyACM1"
GPS_DEVICE="/dev/ttyACM2"
'''PIN=""'''
'''APN="proxy"'''

powerup_F3507g () {
echo -n "Powering up F3507g card.."
echo 1 > /sys/devices/platform/thinkpad_acpi/rfkill/rfkill0/state
while [ ! -c $CONTROL_DEVICE ]; do sleep 0.5; echo -n "."; done
echo "done"
echo -n "Turning on F3507g card..."
sleep 3
if [ -n "$PIN" ]; then
/usr/sbin/chat -v "" "AT+CPIN?" "SIM PIN" "AT" "OK" "AT+CPIN=\"$PIN\"" "OK" > $CONTROL_DEVICE < $CONTROL_DEVICE
fi
/usr/sbin/chat -v "" "AT+CPIN?" "READY" "AT+CFUN=1" "+PACSP0" "AT" "OK" > $CONTROL_DEVICE < $CONTROL_DEVICE
echo "done"
}

powerdown_F3507g () {
echo -n "Turning off F3507g card..."
/usr/sbin/chat -v "" "AT+CFUN=4" "OK" > $CONTROL_DEVICE < $CONTROL_DEVICE
echo "done"
echo -n "Powering down F3507g card.."
echo 0 > /sys/devices/platform/thinkpad_acpi/rfkill/rfkill0/state
while [ -c $CONTROL_DEVICE ]; do sleep 0.5; echo -n "."; done
echo "done"
}

configure_GPS () {
/usr/sbin/chat -v "" "AT*E2GPSCTL=$1,$2,$3" "OK" > $CONTROL_DEVICE < $CONTROL_DEVICE
}

turnon_GPS () {
echo -n "Starting NMEA stream on $GPS_DEVICE..."
configure_GPS 1 1 1
sleep 1
/usr/sbin/chat -v "" "AT*E2GPSNPD" "GPGGA" > $GPS_DEVICE < $GPS_DEVICE
start-stop-daemon --start --exec /usr/sbin/gpsd -- -P $GPSDPID $GPS_DEVICE
echo "done"
}

turnoff_GPS () {
echo -n "Stopping NMEA stream on $GPS_DEVICE..."
start-stop-daemon --stop --pidfile $GPSDPID
configure_GPS 0 1 0
echo "done"
turnoff_F3507g
}

turnon_usbnet () {
echo -n "Starting usbnet connection..."
/usr/sbin/chat -v "" "AT+CGDCONT=1,\"IP\",\"$APN\"" "OK" "AT*ENAP=1,1" "OK" > $CONTROL_DEVICE < $CONTROL_DEVICE
echo "done"
}

turnoff_usbnet () {
echo -n "Stopping usbnet connection..."
/usr/sbin/chat -v "" "AT*ENAP=0" "OK" > $CONTROL_DEVICE < $CONTROL_DEVICE
echo "done"
turnoff_F3507g
}

turnoff_F3507g () {
[ -z $(grep gps /etc/network/run/ifstate) ] && \
[ -z $(grep usb0 /etc/network/run/ifstate) ] && \
[ -z $(grep 3G /etc/network/run/ifstate) ] && \
ifdown F3507g
}

Give the correct '''PIN''' and find the '''APN''' for your wireless provider [http://www.pinstack.com/carrier_settings_apn_gateway.html here]. Append the following lines to your <tt>/etc/network/interfaces</tt> file

iface F3507g inet manual
up . /usr/local/etc/F3507g; powerup_F3507g
down . /usr/local/etc/F3507g; powerdown_F3507g

iface 3G inet wvdial
pre-up ifup F3507g
post-down . /usr/local/etc/F3507g; turnoff_F3507g
provider 3G

iface gps inet manual
up . /usr/local/etc/F3507g; ifup F3507g; turnon_GPS
down . /usr/local/etc/F3507g; turnoff_GPS

iface usb0 inet dhcp
pre-up . /usr/local/etc/F3507g; ifup F3507g; turnon_usbnet
post-down . /usr/local/etc/F3507g; turnoff_usbnet

Configure <tt>/etc/wvdial.conf</tt> to look like this:

[Dialer 3G]
Modem = /dev/ttyACM0
Init1 = AT+CGDCONT=1,"IP","'''proxy'''"
Stupid mode = 1
phone= *99#
Username = *
Password = *

'''Note''': you may need to change the access point name (APN) "'''proxy'''" in <tt>Init1</tt> string and Username/Password to something else. Find the appropriate APN [http://www.pinstack.com/carrier_settings_apn_gateway.html here].

Now broadband connection could be started in the same way as you start any other network interface, just by saying <tt>ifup usb0</tt> (or <tt>ifup 3G</tt>, if connecting via <tt>pppd</tt>). To shut it down, say <tt>ifdown usb0</tt> (or <tt>ifdown 3G</tt>). Similarly, GPS interface is started by <tt>ifup gps</tt> and turned off by <tt>ifdown gps</tt>. Once you get a fix, you can use your favourite GPS mapping application like [http://www.tangogps.org tangogps]. The "cold start" seems to take quite a bit however, and sometimes it cannot get a fix if indoors.

==Using F3507g with NetworkManager==
Work is ongoing to add support for Ericsson Mobile Broadband Modules to GNOME NetworkManager / modem-manager. More information is available on the [http://mbm.sourceforge.net/ MBM project website] and the [http://sourceforge.net/apps/mediawiki/mbm/index.php?title=MBM MBM wiki].

The F3507g card (in a ThinkPad {{T400s}}) works out of the box on Fedora 11. No configuration is needed beyond setting the data plan provider in the nm-applet GUI.

Using mbm-gpsd gps works flawlessly with the F3507g on Karmic Koala with modemmanager packages from [https://launchpad.net/~modemmanager/+archive/ppa Ubuntu PPA], the mbm-gpsd installed by source using the description from [http://sourceforge.net/apps/mediawiki/mbm/index.php?title=MBM#GPS_Control_.28mbm-gpsd.29 here] and knowing the PIN of your SIM card.

==Other thoughts==
While <tt>AT+CFUN=*</tt> and <tt>AT+CPIN=*</tt> are pretty standard commands for wireless modems and are well-documented (e.g. [http://developer.sonyericsson.com/getDocument.do?docId=65054 here] and [http://www.sierrawireless.com/resources/documents/support/2130617_Supported_AT_Command_Reference_Rev_2.1.pdf here]), it appears that the commands <tt>AT*E2GPSCTL</tt> and <tt>AT*E2GPSNPD</tt> are unique to the Ericsson F3507g card. All credit for discovering them goes to "Nickolai Zeldovich" who left a comment in this [http://redmonk.com/sogrady/2008/09/24/apone/ thread]. I imagine one could find them via a USB sniffer on a working Windows machine (or a Linux machine with Windows running in a virtual machine). Another way to get them is to try to look for "gps" string in Windows drivers. What is interesting, F3507g supports a few other AT-commands with "GPS" substring (you can get all supported AT-commands by sending <tt>AT*</tt> to <tt>/dev/ttyACM1</tt> after activating it with <tt>AT+CFUN=1</tt>). Anyway, there is a [http://www.natisbad.org/E4300/Dell_Wireless_5530_AT_cmd_ref.html project] aiming to document all AT-commands for the Ericsson F3507g card.

==Related Links==
*[http://www.natisbad.org/E4300/Dell_Wireless_5530_AT_cmd_ref.html F3705g - AT commands reference]
*[http://www.pinstack.com/carrier_settings_apn_gateway.html Carrier internet Settings (Apn, Gateway, etc)]
*[http://mbm.sourceforge.net/ MBM project website (Support for f3507g/f3607gw in NetworkManager, kernel drivers, gps control software etc)]

==Bugs==
* Ubuntu 8.10 kernel suffers from the "option" regression mentioned above. However both CDC ACM and CDC Ethernet interfaces are treated correctly by Ubuntu 9.04 kernel.
* Playing around with the device under Linux can cause it to disappear under Windows Vista. Issue + Fix described [http://forums.lenovo.com/t5/T400-T500-and-newer-T-series/Ericsson-f3507g-doesn-t-appear-under-Vista32-anymore-but-works/m-p/138874 here]

==Models==
*{{X200}}
*{{X200 Tablet}}
*{{X301}}
*{{T400}}
*{{T400s}}
*{{T500}}
*{{R400}}

Category:R400

2009-10-30T22:20:57Z

Frank42: /* Standard Features */

{| width="100%"
|style="vertical-align:top" |
<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
==== Standard Features ====
* One of the following processors:
** [[Intel Core 2 Duo (Merom)]] T5870 and 5670
** [[Intel Core 2 Duo (Penryn)]] P8400, P8600, T9400 and T9600
** [[Intel Celeron (Merom L)]] 575 and 585
* Chipset
** Mobile Intel® GM45 Express CS/ICH 9M-E
** Mobile Intel® GMA X4500 H D
** Mobile Intel® GL667 MH z (Celeron®)
* One of the following graphics adapters:
** [[Intel_Graphics_Media_Accelerator_4500MHD]]
** [[ATI Mobility Radeon HD 3470]] discrete graphics card
** OR: Both of them ([[Switchable Graphics|Switchable Graphics Card Technology]])
**
* One of the following displays:
** 14.1" wide: WXGA (1280 x 800, 107DPI, 185+ nit)
** 14.1" wide: WXGA+ (1440 x 900, 120DPI, 200+ nit)
*System Memory
** Up to 8GB of PC2-8500 1066MH z DDR3
** Intel Turbo M emory 2.0
*Harddrive
** 80, 160, 250 or 320GB 5400RPM SATA HDD
** 160, 200GB (FDE) 7200 RPM SATA HDD
* [[Ethernet Controllers#Intel Gigabit (10/100/1000)|Intel Gigabit Ethernet Controller]]
* [[MiniPCI Express slot]] 1 with one of the following:
** None (empty)
** [[Intel WiFi Link 5300]] (3x3 AGN)
** [[Intel WiFi Link 5100]] (1x2AGN)
** [[ThinkPad 11b/g Wireless LAN M ini PCI Express Adapter III]]
* 1 [[CardBus slot]] (Type 2)
* under which there one of:
** [[ExpressCard slot|ExpressCard/54 slot]]
** SmartCard reader
** [[Ricoh_R5C843|4-in-1 Memory reader]]
* [[Embedded Security Subsystem|IBM Embedded Security Subsystem 2.0]]
* [[Active Protection System|IBM Active Protection System]]
* [[Integrated Fingerprint Reader]] on select models
* [[ThinkPad_Bluetooth_with_Enhanced_Data_Rate_(BDC-2)|Bluetooth]] on select models
* [[UltraNav]] (TrackPoint / Touchpad combo)
* Integrated camera (on selected models)
* IEEE1394 Firewire (on selected models)
* [[Ericsson_F3507g_Mobile_Broadband_Module]] (on selected models)
</div>
|style="vertical-align:top" |
|}

[[Category:R Series]]

ThinkWiki - User contributions [en]

Ericsson F3507g Mobile Broadband Module

Category:R400