VodafoneUSBModem
The Vodafone K3770 and K3772-Z modems allow you to connect your mbed to the internet from (almost) any location in the world.
The K3770/K3772-Z modems can be purchased directly from :
Many supermarkets and independent phone stores also sell these modems.
Hardware Setup¶
![]() | ![]() |
Because of the high current that the USB dongle requires, it is not possible to power it from the Vu pin on the mbed. In the example show, an external linear regulator board has been used to provide a high current regulated 5v supply from a 9v wall adaptor. The parts shown are :
Hello World¶
This example application uses the VodafoneUSBModem and the HTTPClient interface, enabling the mbed to fetch a URL over HTTP, and print the contents.
There are various other "hello world" programs that demonstrate SMS, NTP, Socket and Websocket interfaces, as well as management commands (check balance, link status, etc). See "Resources" section below.
You'll notice that this "Hello World" program is a little more complex that others, as we're using the mbed RTOS to manage the memory and processing resources/requirement of the USB Modem driver and the TCP/IP stack.
» Import this program
#include "mbed.h" #include "VodafoneUSBModem.h" #include "HTTPClient.h" void test(void const*) { VodafoneUSBModem modem; HTTPClient http; char str[512]; int ret = modem.connect("pp.vodafone.co.uk"); if(ret) { printf("Could not connect\n"); return; } //GET data printf("Trying to fetch page...\n"); ret = http.get("http://mbed.org/media/uploads/donatien/hello.txt", str, 128); if (!ret) { printf("Page fetched successfully - read %d characters\n", strlen(str)); printf("Result: %s\n", str); } else { printf("Error - ret = %d - HTTP return code = %d\n", ret, http.getHTTPResponseCode()); } //POST data HTTPMap map; HTTPText text(str, 512); map.put("Hello", "World"); map.put("test", "1234"); printf("Trying to post data...\n"); ret = http.post("http://httpbin.org/post", map, &text); if (!ret) { printf("Executed POST successfully - read %d characters\n", strlen(str)); printf("Result: %s\n", str); } else { printf("Error - ret = %d - HTTP return code = %d\n", ret, http.getHTTPResponseCode()); } modem.disconnect(); while(1) { } } int main() { Thread testTask(test, NULL, osPriorityNormal, 1024 * 4); DigitalOut led(LED1); while(1) { led=!led; Thread::wait(1000); } return 0; }
Library¶
» Import this library into a programVodafoneUSBModem
Resources and references¶
Network APN¶
To connect to the internet you must establish a PPP connection. You can then use BSD Sockets or any high-level component (HTTP Client, NTP Client).
To establish this connection, one single function is used:
int ret = modem.connect("pp.vodafone.co.uk");
pp.vodafone.co.uk is the APN value for a Vodafone Pay as you Go SIM. Change it to the relevant value if your SIM is different:
| SIM Type | Contract Type | Plan | APN | User | Password |
|---|---|---|---|---|---|
| Mobile Broadband | Pay as you go | £5 for 250MB, lasting up to 30 days | smart | web | web |
| Mobile Broadband | Pay as you go | £15 for 2GB, lasting up to 30 days | ppbundle.internet | web | web |
| Mobile Broadband | Pay as you go | £15 for 1GB, lasting up to 90 days | pp.internet | web | web |
| Mobile Broadband | Pay monthly | Any | internet | web | web |
| Phone | Pay as you go | Any | pp.vodafone.co.uk | web | web |
| Phone | Pay monthly | Any | internet | web | web |
For details please check Vodafone's dedicated page.
The variable, "ret", allows you to check whether the connection was successful or not (0 on success, a negative value on error).
Please note that the "connect" command can take a few minutes to complete in worst case scenarios, as it initializes the modem and then waits for network registration.
Other Examples¶
» Import this programVodafoneUSBModemNTPClientTest
NTP Client Test with the Vodafone USB Modem library
Click here to the programs that are using the NTPClient
» Import this programVodafoneUSBModemSMSTest
SMS test with the Vodafone library
» Import this programVodafoneUSBModemWebsocketTest
Websocket client test with Vodafone USB Modems
Click here to the programs that are using the WebsocketClient
» Import this programVodafoneUSBModemUSSDTest
Test of USSD commands transmission over the Vodafone network with the Vodafone library








Please login to post comments.