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.

Revision:
21:c4d64830bf02
Parent:
19:2b5d097ca15d
Child:
22:29322c22577e
--- a/MDM.h	Mon Mar 24 07:38:05 2014 +0000
+++ b/MDM.h	Tue Apr 08 09:15:37 2014 +0000
@@ -1,6 +1,8 @@
 #pragma once 
 
 #include "mbed.h"
+#include <stdarg.h>
+
 #include "Pipe.h"
 #include "SerialPipe.h"
 
@@ -13,22 +15,97 @@
  #define _C027DEFAULT(name)
 #endif
 
+typedef uint32_t IP;
+    
 class MDMParser
 {
 public:
-    #define WAIT      -1
-    #define NOT_FOUND  0
+    // waitFinalResp Responses
+    #define NOT_FOUND    0
+    #define WAIT        -1 // TIMEOUT
+    #define OK          -2 
+    #define ERROR       -3
+    #define PROMPT      -4
+    // getLine Responses
+    #define LENGTH(x)  (x & 0x00FFFF)
+    #define TYPE(x)    (x & 0xFF0000)
+    #define TYPE_UNKNOWN    0x000000
+    #define TYPE_OK         0x110000
+    #define TYPE_ERROR      0x120000
+    #define TYPE_RING       0x210000
+    #define TYPE_CONNECT    0x220000
+    #define TYPE_NOCARRIER  0x230000
+    #define TYPE_NODIALTONE 0x240000
+    #define TYPE_BUSY       0x250000
+    #define TYPE_NOANSWER   0x260000
+    #define TYPE_PROMPT     0x300000
+    #define TYPE_PLUS       0x400000
+    // Socket Return Codes
+    #define SOCKET_ERROR -1
+    #define SOCKET_OK     0 
+    
+    MDMParser(void);
     
-    #define LENGTH(x)   (x & 0x00FFFF)
-//    #define PROTOCOL(x) (x & 0xFF0000)
+    // interaction with AT command interface
     virtual int getLine(char* buf, int len) = 0; 
-    virtual int getResp(char* buf, int len) = 0; 
     virtual int send(const char* buf, int len);
-    
+    int sendFormated(const char* format, ...);
+    typedef int (*_CB)(int type, const char* buf, int len, void* param);
+    int waitFinalResp(_CB cb = NULL, void* param = NULL, int timeout_ms = 5000);
+
+    // network
+    bool init(const char* pin = NULL);
+    bool checkNetStatus(void);
+    bool powerOff(void);
+    // internet connection
+    bool join(const char* apn, const char* user = NULL, const char* password = NULL);
+    bool disconnect(void);
+    bool gethostbyname(const char* host, IP* ip);
+    // sockets
+    typedef enum { IPPROTO_TCP, IPPROTO_UDP } IpProtocol;
+    int socketSocket(IpProtocol ipproto);
+    bool socketConnect(int socket, const char * host, int port);
+    int socketSend(int socket, const char * buf, int len);
+    int socketSendTo(int socket, IP ip, int port, const char * buf, int len);
+    int socketReadable(int socket);
+    int socketRecv(int socket, char* buf, int len);
+    int socketRecvFrom(int socket, char* buf, int len, IP* ip);
+    bool socketClose(int socket);
+    bool socketFree(int socket);
+    // sms
+    bool smsSend(const char* num, const char* buf);
+    bool smsDelete(int ix);
+    bool smsRead(int ix, char* num, char* buf, int len);
+    // ussd
+    int ussdCommand(const char* cmd, char* buf, int len);
 protected:
     static int _getLine(Pipe<char>* pipe, char* buffer, int length);
-    static int _getResp(Pipe<char>* pipe, char* buffer, int length);
+    static int _parseMatch(Pipe<char>* pipe, int len, const char* sta, const char* end);
+    static int _parseFormated(Pipe<char>* pipe, int len, const char* fmt);
     virtual int _send(const void* buf, int len) = 0;
+private:
+    typedef enum { MODEL_UNKNOWN, MODEL_SARA_G350, MODEL_LISA_U200, MODEL_LISA_C200 } Model; 
+    typedef enum { SIM_UNKNOWN, SIM_PIN, SIM_READY } Sim; 
+    typedef enum { NET_UNKNOWN, NET_DENIED, NET_NONE, NET_HOME, NET_ROAMING } Net; 
+    static int _cbATI(int type, const char* buf, int len, Model* model);
+    static int _cbUDNSRN(int type, const char* buf, int len, IP* ip);
+    static int _cbUSOCR(int type, const char* buf, int len, int* socket);
+    static int _cbUSORD(int type, const char* buf, int len, char* out);
+    typedef struct { char* buf; IP ip; int port; } USORFparam;
+    static int _cbUSORF(int type, const char* buf, int len, USORFparam* param);
+    typedef struct { char* buf; char* num; } CMGRparam;
+    static int _cbCUSD(int type, const char* buf, int len, char* buf);
+    static int _cbCMGR(int type, const char* buf, int len, CMGRparam* param);
+    static IP strToIp(const char* str);
+    IP _ip;
+    Model _model;
+    Sim _sim;
+    Net _net;
+    int _rssi;
+private:
+    typedef enum { SOCK_FREE, SOCK_CREATED, SOCK_CONNECTED } SockState;
+    typedef struct { SockState state; int pending; } SockCtrl;
+    SockCtrl _sockets[16];    
 };
 
 // -----------------------------------------------------------------------
@@ -44,9 +121,8 @@
               PinName cts   _C027DEFAULT(MDMCTS),
 #endif
               int rxSize    = 256 , 
-              int txSize    = 256 );
+              int txSize    = 128 );
     virtual int getLine(char* buffer, int length);
-    virtual int getResp(char* buffer, int length);
 protected:
     virtual int _send(const void* buf, int len);
 };
@@ -60,7 +136,6 @@
 public: 
     MDMUsb(void);
     virtual int getLine(char* buffer, int length);
-    virtual int getResp(char* buffer, int length);
 protected:
     virtual int _send(const void* buf, int len);
 };