u-blox / C027_Support

support library for C027 helper functions for Buffer Pipes, Buffered Serial Port (rtos capable) and GPS parsing. It includes modem APIs for USSD, SMS and Sockets.

Dependents:   HTTPClient_Cellular_HelloWorld Cellular_HelloMQTT MbedSmartRestMain Car_Bon_car_module ... more

This library is intended to be used with u-blox products such as the C027 or a shield with u-blox cellular and GPS modules like the cellular and positioning shield from Embedded Artist.

For 2G/GSM and 3G/UMTS you need to:

  • have a SIM card and know its PIN number
  • need to know you network operators APN setting These setting should be passed to the connect or init and join functions. You can also extend the APN database in MDMAPN.h.

For CDMA products you need to make sure that you have provisioned and activated the modem with either Sprint or Verizon.

Diff: MDM.h

Revision:
57:869bd35f44cc
Parent:
54:7ba8e4c218e2
Child:
58:e38a2e942fbb
--- a/MDM.h	Mon May 12 13:05:27 2014 +0000
+++ b/MDM.h	Mon May 12 13:58:47 2014 +0000
@@ -78,15 +78,27 @@
 
     
     // ----------------------------------------------------------------
-    // Data Connection (GPRS)
+    // Device 
     // ----------------------------------------------------------------
     
+    /** Combined Init, checkNetStatus, join suitable for simple applications
+        \param simpin a optional pin of the SIM card
+        \param apn  the of the network provider e.g. "internet" or "apn.provider.com"
+        \param username is the user name text string for the authentication phase
+        \param password is the password text string for the authentication phase
+        \param dump set to true if you like to dump the status if successful
+        \return true if successful, false otherwise
+    */
+    bool connect(const char* simpin, 
+            const char* apn, const char* username, const char* password,
+            bool dump);    
+
     /** register (Attach) the MT to the GPRS service. 
-        \param pin  a optional pin of the SIM card
+        \param simpin a optional pin of the SIM card
         \param status an optional struture to with device information 
         \return true if successful, false otherwise
     */
-    bool init(const char* pin = NULL, DevStatus* status = NULL);
+    bool init(const char* simpin = NULL, DevStatus* status = NULL);
     
     /** check if the network is available 
         \param status an optional structure to with network information 
@@ -106,11 +118,12 @@
     
     /** register (Attach) the MT to the GPRS service. 
         \param apn  the of the network provider e.g. "internet" or "apn.provider.com"
-        \param user is the user name text string for the authentication phase
+        \param username is the user name text string for the authentication phase
         \param password is the password text string for the authentication phase
+        \param dump set to true if you like to dump the status if successful
         \return the ip that is assigned 
     */
-    MDMParser::IP join(const char* apn = NULL, const char* user = NULL, const char* password = NULL);
+    MDMParser::IP join(const char* apn = NULL, const char* username = NULL, const char* password = NULL);
     
     /** deregister (detach) the MT from the GPRS service.
         \return true if successful, false otherwise