Michael Baker / mbed-dev-exp

program to test exporting mbed-dev

Dependencies:   mbed-dev

Fork of FONA_CellPhone by Michael Baker

Adafruit_FONA.h@9:06eca688f2a3, 2016-03-15 (annotated)

Committer:
gtzintzarov3
Date:
Tue Mar 15 02:09:33 2016 +0000
Revision:
9:06eca688f2a3
Parent:
2:aaef20ac9044
Child:
10:9dd3e49dec97
GT: halfway through documenting

Who changed what in which revision?

UserRevisionLine numberNew contents of line
gtzintzarov3 0:851248a56628 1 /***************************************************
gtzintzarov3 0:851248a56628 2 This is a library for our Adafruit FONA Cellular Module
gtzintzarov3 0:851248a56628 3
gtzintzarov3 0:851248a56628 4 Designed specifically to work with the Adafruit FONA
gtzintzarov3 0:851248a56628 5 ----> http://www.adafruit.com/products/1946
gtzintzarov3 0:851248a56628 6 ----> http://www.adafruit.com/products/1963
gtzintzarov3 0:851248a56628 7
gtzintzarov3 0:851248a56628 8 These displays use TTL Serial to communicate, 2 pins are required to
gtzintzarov3 0:851248a56628 9 interface
gtzintzarov3 0:851248a56628 10 Adafruit invests time and resources providing this open source code,
gtzintzarov3 0:851248a56628 11 please support Adafruit and open-source hardware by purchasing
gtzintzarov3 0:851248a56628 12 products from Adafruit!
gtzintzarov3 0:851248a56628 13
gtzintzarov3 0:851248a56628 14 Written by Limor Fried/Ladyada for Adafruit Industries.
gtzintzarov3 0:851248a56628 15 BSD license, all text above must be included in any redistribution
gtzintzarov3 0:851248a56628 16 ****************************************************/
gtzintzarov3 0:851248a56628 17
gtzintzarov3 0:851248a56628 18 /*
gtzintzarov3 9:06eca688f2a3 19 * Modified by George Tzintzarov & Jesse Baker 03/14/2016 for use in mbed LPC1768
gtzintzarov3 0:851248a56628 20 */
gtzintzarov3 0:851248a56628 21
gtzintzarov3 0:851248a56628 22 #ifndef ADAFRUIT_FONA_H
gtzintzarov3 0:851248a56628 23 #define ADAFRUIT_FONA_H
gtzintzarov3 0:851248a56628 24
gtzintzarov3 0:851248a56628 25 #include "mbed.h"
gtzintzarov3 0:851248a56628 26
gtzintzarov3 0:851248a56628 27 //#define ADAFRUIT_FONA_DEBUG
gtzintzarov3 0:851248a56628 28
gtzintzarov3 0:851248a56628 29 #define FONA_HEADSETAUDIO 0
gtzintzarov3 0:851248a56628 30 #define FONA_EXTAUDIO 1
gtzintzarov3 0:851248a56628 31
gtzintzarov3 0:851248a56628 32 #define FONA_STTONE_DIALTONE 1
gtzintzarov3 0:851248a56628 33 #define FONA_STTONE_BUSY 2
gtzintzarov3 0:851248a56628 34 #define FONA_STTONE_CONGESTION 3
gtzintzarov3 0:851248a56628 35 #define FONA_STTONE_PATHACK 4
gtzintzarov3 0:851248a56628 36 #define FONA_STTONE_DROPPED 5
gtzintzarov3 0:851248a56628 37 #define FONA_STTONE_ERROR 6
gtzintzarov3 0:851248a56628 38 #define FONA_STTONE_CALLWAIT 7
gtzintzarov3 0:851248a56628 39 #define FONA_STTONE_RINGING 8
gtzintzarov3 0:851248a56628 40 #define FONA_STTONE_BEEP 16
gtzintzarov3 0:851248a56628 41 #define FONA_STTONE_POSTONE 17
gtzintzarov3 0:851248a56628 42 #define FONA_STTONE_ERRTONE 18
gtzintzarov3 0:851248a56628 43 #define FONA_STTONE_INDIANDIALTONE 19
gtzintzarov3 0:851248a56628 44 #define FONA_STTONE_USADIALTONE 20
gtzintzarov3 0:851248a56628 45
George windoge T 2:aaef20ac9044 46 #define FONA_DEFAULT_TIMEOUT_MS 500 //timeout between send AT and reply from FONA
gtzintzarov3 0:851248a56628 47
gtzintzarov3 0:851248a56628 48 #define FONA_HTTP_GET 0
gtzintzarov3 0:851248a56628 49 #define FONA_HTTP_POST 1
gtzintzarov3 0:851248a56628 50 #define FONA_HTTP_HEAD 2
gtzintzarov3 0:851248a56628 51
gtzintzarov3 0:851248a56628 52 #define RX_BUFFER_SIZE 255
gtzintzarov3 0:851248a56628 53
gtzintzarov3 9:06eca688f2a3 54 /** Adafruit FONA 800H Class
gtzintzarov3 9:06eca688f2a3 55 * Modified by George Tzintzarov & Jesse Baker 03/14/2016 for use in mbed LPC1768
gtzintzarov3 9:06eca688f2a3 56 */
gtzintzarov3 9:06eca688f2a3 57
gtzintzarov3 0:851248a56628 58 class Adafruit_FONA : public Stream {
gtzintzarov3 0:851248a56628 59 public:
gtzintzarov3 9:06eca688f2a3 60 /**
gtzintzarov3 9:06eca688f2a3 61 Listener for FONA events. Inherit this class to customize.
gtzintzarov3 9:06eca688f2a3 62 @code
gtzintzarov3 9:06eca688f2a3 63 #define FONA_RST p12
gtzintzarov3 9:06eca688f2a3 64 #define FONA_TX p13
gtzintzarov3 9:06eca688f2a3 65 #define FONA_RX p14
gtzintzarov3 9:06eca688f2a3 66 #define FONA_RI p11
gtzintzarov3 9:06eca688f2a3 67
gtzintzarov3 9:06eca688f2a3 68 Adafruit_FONA my_fona(FONA_TX, FONA_RX, FONA_RST, FONA_RI);
gtzintzarov3 9:06eca688f2a3 69 DigitalOut led1(LED1);
gtzintzarov3 9:06eca688f2a3 70 class FonaEventListener : public Adafruit_FONA::EventListener {
gtzintzarov3 9:06eca688f2a3 71 virtual void onRing() {
gtzintzarov3 9:06eca688f2a3 72 led1 = 1;
gtzintzarov3 9:06eca688f2a3 73 }
gtzintzarov3 9:06eca688f2a3 74
gtzintzarov3 9:06eca688f2a3 75 virtual void onNoCarrier() {
gtzintzarov3 9:06eca688f2a3 76 led1 = 0;
gtzintzarov3 9:06eca688f2a3 77 }
gtzintzarov3 9:06eca688f2a3 78 };
gtzintzarov3 9:06eca688f2a3 79 FonaEventListener fonaEventListener;
gtzintzarov3 9:06eca688f2a3 80 my_fona.setEventListener(&fonaEventListener);
gtzintzarov3 9:06eca688f2a3 81 @endcode
gtzintzarov3 9:06eca688f2a3 82 */
gtzintzarov3 9:06eca688f2a3 83
gtzintzarov3 0:851248a56628 84 class EventListener {
gtzintzarov3 0:851248a56628 85 public:
gtzintzarov3 0:851248a56628 86 /**
gtzintzarov3 0:851248a56628 87 * Method called when somebody call the FONA.
gtzintzarov3 0:851248a56628 88 */
gtzintzarov3 0:851248a56628 89 virtual void onRing() = 0;
gtzintzarov3 0:851248a56628 90
gtzintzarov3 0:851248a56628 91 /**
gtzintzarov3 0:851248a56628 92 * Method called when the calling person stop his call.
gtzintzarov3 0:851248a56628 93 */
gtzintzarov3 0:851248a56628 94 virtual void onNoCarrier() = 0;
gtzintzarov3 0:851248a56628 95 };
gtzintzarov3 0:851248a56628 96
gtzintzarov3 0:851248a56628 97 public:
gtzintzarov3 9:06eca688f2a3 98 /** Create instance of the Adafruit_FONA
gtzintzarov3 9:06eca688f2a3 99 @param tx Set mbed TX
gtzintzarov3 9:06eca688f2a3 100 @param rx Set mbed RX
gtzintzarov3 9:06eca688f2a3 101 @param rst Set reset pin
gtzintzarov3 9:06eca688f2a3 102 @param ringIndicator Set ring indicator pin. This is to let mbed know if there is an incoming call
gtzintzarov3 9:06eca688f2a3 103 */
gtzintzarov3 9:06eca688f2a3 104
gtzintzarov3 0:851248a56628 105 Adafruit_FONA(PinName tx, PinName rx, PinName rst, PinName ringIndicator) :
gtzintzarov3 0:851248a56628 106 _rstpin(rst, false), _ringIndicatorInterruptIn(ringIndicator),
gtzintzarov3 0:851248a56628 107 apn("FONAnet"), apnusername(NULL), apnpassword(NULL), httpsredirect(false), useragent("FONA"),
gtzintzarov3 0:851248a56628 108 _incomingCall(false), eventListener(NULL), mySerial(tx, rx), rxBufferInIndex(0), rxBufferOutIndex(0),
gtzintzarov3 0:851248a56628 109 currentReceivedLineSize(0) {}
gtzintzarov3 9:06eca688f2a3 110
gtzintzarov3 9:06eca688f2a3 111 /** Built-in Test to see if FONA is connected
gtzintzarov3 9:06eca688f2a3 112 @param baudrate test and set at baudrate
gtzintzarov3 9:06eca688f2a3 113 @return true upon success
gtzintzarov3 9:06eca688f2a3 114 @return false upon failure. Most likely something is not hooked up.
gtzintzarov3 9:06eca688f2a3 115
gtzintzarov3 9:06eca688f2a3 116 EXAMPLE CODE:
gtzintzarov3 9:06eca688f2a3 117 @code
gtzintzarov3 9:06eca688f2a3 118 // See if the FONA is responding
gtzintzarov3 9:06eca688f2a3 119 // fona is an instance of Adafruit_FONA
gtzintzarov3 9:06eca688f2a3 120 if (! fona.begin(9600)) {
gtzintzarov3 9:06eca688f2a3 121 printf("Couldn't find FONA\r\n");
gtzintzarov3 9:06eca688f2a3 122 while (1);
gtzintzarov3 9:06eca688f2a3 123 }
gtzintzarov3 9:06eca688f2a3 124 @endcode
gtzintzarov3 9:06eca688f2a3 125 */
gtzintzarov3 0:851248a56628 126 bool begin(int baudrate);
gtzintzarov3 9:06eca688f2a3 127
gtzintzarov3 9:06eca688f2a3 128 /** Set the event listener for incoming calls
gtzintzarov3 9:06eca688f2a3 129 @param eventListener A pointer to the event listener
gtzintzarov3 9:06eca688f2a3 130 @see Adafruit_FONA::EventListener for specific example
gtzintzarov3 9:06eca688f2a3 131 */
gtzintzarov3 9:06eca688f2a3 132
gtzintzarov3 0:851248a56628 133 void setEventListener(EventListener *eventListener);
gtzintzarov3 0:851248a56628 134
gtzintzarov3 9:06eca688f2a3 135 // Stream----------------------------------------------------------------------
gtzintzarov3 0:851248a56628 136 virtual int _putc(int value);
gtzintzarov3 0:851248a56628 137 virtual int _getc();
gtzintzarov3 0:851248a56628 138
gtzintzarov3 9:06eca688f2a3 139 /** Check if FONA has anything in its output buffer
gtzintzarov3 9:06eca688f2a3 140 @return 0 if nothing
gtzintzarov3 9:06eca688f2a3 141 */
gtzintzarov3 9:06eca688f2a3 142 int readable(void);
gtzintzarov3 9:06eca688f2a3 143
gtzintzarov3 9:06eca688f2a3 144 // RTC----------------------------------------------------------------------
gtzintzarov3 0:851248a56628 145 bool enableRTC(uint8_t i); // i = 0 <=> disable, i = 1 <=> enable
gtzintzarov3 0:851248a56628 146
gtzintzarov3 9:06eca688f2a3 147 // Battery and ADC----------------------------------------------------------------------
gtzintzarov3 9:06eca688f2a3 148 /** Get ADC voltage from external pin
gtzintzarov3 9:06eca688f2a3 149 @param v uint16_t pointer to insert ADC voltage data
gtzintzarov3 9:06eca688f2a3 150 @return TRUE if successful
gtzintzarov3 9:06eca688f2a3 151
gtzintzarov3 9:06eca688f2a3 152 EXAMPLE CODE:
gtzintzarov3 9:06eca688f2a3 153 @code
gtzintzarov3 9:06eca688f2a3 154 // read the ADC
gtzintzarov3 9:06eca688f2a3 155 // fona is an instance of Adafruit_FONA
gtzintzarov3 9:06eca688f2a3 156 uint16_t adc;
gtzintzarov3 9:06eca688f2a3 157 if (! fona.getADCVoltage(&adc)) {
gtzintzarov3 9:06eca688f2a3 158 printf("Failed to read ADC\r\n");
gtzintzarov3 9:06eca688f2a3 159 }
gtzintzarov3 9:06eca688f2a3 160 else {
gtzintzarov3 9:06eca688f2a3 161 printf("ADC = %d mV\r\n", adc);
gtzintzarov3 9:06eca688f2a3 162 }
gtzintzarov3 9:06eca688f2a3 163 @endcode
gtzintzarov3 9:06eca688f2a3 164 */
gtzintzarov3 0:851248a56628 165 bool getADCVoltage(uint16_t *v);
gtzintzarov3 9:06eca688f2a3 166
gtzintzarov3 9:06eca688f2a3 167 /** Get battery percentage level
gtzintzarov3 9:06eca688f2a3 168 @param p uint16_t pointer to insert battery percent data
gtzintzarov3 9:06eca688f2a3 169 @return TRUE if successful
gtzintzarov3 9:06eca688f2a3 170
gtzintzarov3 9:06eca688f2a3 171 EXAMPLE CODE:
gtzintzarov3 9:06eca688f2a3 172 @code
gtzintzarov3 9:06eca688f2a3 173 // read the battery percent level
gtzintzarov3 9:06eca688f2a3 174 // fona is an instance of Adafruit_FONA
gtzintzarov3 9:06eca688f2a3 175 uint16_t vbatPer;
gtzintzarov3 9:06eca688f2a3 176 if (! fona.getBattPercent(&vbatPer)) {
gtzintzarov3 9:06eca688f2a3 177 printf("Failed to read Batt\r\n");
gtzintzarov3 9:06eca688f2a3 178 }
gtzintzarov3 9:06eca688f2a3 179 else {
gtzintzarov3 9:06eca688f2a3 180 printf("VPct = %d%%\r\n", vbatPer);
gtzintzarov3 9:06eca688f2a3 181 }
gtzintzarov3 9:06eca688f2a3 182 @endcode
gtzintzarov3 9:06eca688f2a3 183 */
gtzintzarov3 9:06eca688f2a3 184
gtzintzarov3 0:851248a56628 185 bool getBattPercent(uint16_t *p);
gtzintzarov3 9:06eca688f2a3 186
gtzintzarov3 9:06eca688f2a3 187 /** Get battery voltage level
gtzintzarov3 9:06eca688f2a3 188 @param v uint16_t pointer to insert battery voltage data
gtzintzarov3 9:06eca688f2a3 189 @return TRUE if successful
gtzintzarov3 9:06eca688f2a3 190
gtzintzarov3 9:06eca688f2a3 191 EXAMPLE CODE:
gtzintzarov3 9:06eca688f2a3 192 @code
gtzintzarov3 9:06eca688f2a3 193 // read the battery voltage
gtzintzarov3 9:06eca688f2a3 194 // fona is an instance of Adafruit_FONA
gtzintzarov3 9:06eca688f2a3 195 uint16_t vbat;
gtzintzarov3 9:06eca688f2a3 196 if (! fona.getBattPercent(&vbat)) {
gtzintzarov3 9:06eca688f2a3 197 printf("Failed to read Batt\r\n");
gtzintzarov3 9:06eca688f2a3 198 }
gtzintzarov3 9:06eca688f2a3 199 else {
gtzintzarov3 9:06eca688f2a3 200 printf("Vbat = %d%%\r\n", vbat);
gtzintzarov3 9:06eca688f2a3 201 }
gtzintzarov3 9:06eca688f2a3 202 @endcode
gtzintzarov3 9:06eca688f2a3 203 */
gtzintzarov3 0:851248a56628 204 bool getBattVoltage(uint16_t *v);
gtzintzarov3 0:851248a56628 205
gtzintzarov3 9:06eca688f2a3 206 // SIM query----------------------------------------------------------------------
gtzintzarov3 9:06eca688f2a3 207 /** Unlock SIM if needed
gtzintzarov3 9:06eca688f2a3 208 @param pin 4 digit char arrary
gtzintzarov3 9:06eca688f2a3 209 @return TRUE if successful
gtzintzarov3 9:06eca688f2a3 210 */
gtzintzarov3 0:851248a56628 211 bool unlockSIM(char *pin);
gtzintzarov3 9:06eca688f2a3 212 /** Get the SIM chip card interface device (CCID)
gtzintzarov3 9:06eca688f2a3 213 @param ccid make sure it is at least 21 bytes long
gtzintzarov3 9:06eca688f2a3 214 @return length of CCID
gtzintzarov3 9:06eca688f2a3 215 */
gtzintzarov3 0:851248a56628 216 uint8_t getSIMCCID(char *ccid);
gtzintzarov3 9:06eca688f2a3 217 /** Get the Network Status of FONA
gtzintzarov3 9:06eca688f2a3 218 @return Code 0-5
gtzintzarov3 9:06eca688f2a3 219 @see
gtzintzarov3 9:06eca688f2a3 220
gtzintzarov3 9:06eca688f2a3 221 */
gtzintzarov3 0:851248a56628 222 uint8_t getNetworkStatus(void);
gtzintzarov3 0:851248a56628 223 uint8_t getRSSI(void);
gtzintzarov3 0:851248a56628 224
gtzintzarov3 9:06eca688f2a3 225 // IMEI----------------------------------------------------------------------
gtzintzarov3 9:06eca688f2a3 226 /** Get the International Mobile Station Equipment Identity (IMEI)
gtzintzarov3 9:06eca688f2a3 227 @param imei A char array with minimum length 16
gtzintzarov3 9:06eca688f2a3 228 @return The IMEI of the device
gtzintzarov3 9:06eca688f2a3 229 EXAMPLE CODE:
gtzintzarov3 9:06eca688f2a3 230 @code
gtzintzarov3 9:06eca688f2a3 231 // Print SIM card IMEI number.
gtzintzarov3 9:06eca688f2a3 232 char imei[15] = {0}; // MUST use a 16 character buffer for IMEI!
gtzintzarov3 9:06eca688f2a3 233 uint8_t imeiLen = fona.getIMEI(imei); //fona is an instance of Adafruit_FONA
gtzintzarov3 9:06eca688f2a3 234 if (imeiLen > 0) {
gtzintzarov3 9:06eca688f2a3 235 pcSerial.printf("SIM card IMEI: %s\r\n", imei);
gtzintzarov3 9:06eca688f2a3 236 }
gtzintzarov3 9:06eca688f2a3 237 @endcode
gtzintzarov3 9:06eca688f2a3 238 */
gtzintzarov3 0:851248a56628 239 uint8_t getIMEI(char *imei);
gtzintzarov3 0:851248a56628 240
gtzintzarov3 0:851248a56628 241 // set Audio output
gtzintzarov3 0:851248a56628 242 bool setAudio(uint8_t a);
gtzintzarov3 0:851248a56628 243 bool setVolume(uint8_t i);
gtzintzarov3 0:851248a56628 244 uint8_t getVolume(void);
gtzintzarov3 0:851248a56628 245 bool playToolkitTone(uint8_t t, uint16_t len);
gtzintzarov3 0:851248a56628 246 bool setMicVolume(uint8_t a, uint8_t level);
gtzintzarov3 0:851248a56628 247 bool playDTMF(char tone);
gtzintzarov3 0:851248a56628 248
gtzintzarov3 0:851248a56628 249 // FM radio functions
gtzintzarov3 0:851248a56628 250 bool tuneFMradio(uint16_t station);
gtzintzarov3 0:851248a56628 251 bool FMradio(bool onoff, uint8_t a = FONA_HEADSETAUDIO);
gtzintzarov3 0:851248a56628 252 bool setFMVolume(uint8_t i);
gtzintzarov3 0:851248a56628 253 int8_t getFMVolume();
gtzintzarov3 0:851248a56628 254 int8_t getFMSignalLevel(uint16_t station);
gtzintzarov3 0:851248a56628 255
gtzintzarov3 0:851248a56628 256 // SMS handling
gtzintzarov3 0:851248a56628 257 bool setSMSInterrupt(uint8_t i);
gtzintzarov3 0:851248a56628 258 uint8_t getSMSInterrupt(void);
gtzintzarov3 0:851248a56628 259 int8_t getNumSMS(void);
gtzintzarov3 0:851248a56628 260 bool readSMS(uint8_t i, char *smsbuff, uint16_t max, uint16_t *readsize);
gtzintzarov3 0:851248a56628 261 bool sendSMS(char *smsaddr, char *smsmsg);
gtzintzarov3 0:851248a56628 262 bool deleteSMS(uint8_t i);
gtzintzarov3 0:851248a56628 263 bool getSMSSender(uint8_t i, char *sender, int senderlen);
gtzintzarov3 0:851248a56628 264
gtzintzarov3 0:851248a56628 265 // Time
gtzintzarov3 0:851248a56628 266 bool enableNetworkTimeSync(bool onoff);
gtzintzarov3 0:851248a56628 267 bool enableNTPTimeSync(bool onoff, const char* ntpserver=0);
gtzintzarov3 0:851248a56628 268 bool getTime(char* buff, uint16_t maxlen);
gtzintzarov3 0:851248a56628 269
gtzintzarov3 0:851248a56628 270 // GPRS handling
gtzintzarov3 0:851248a56628 271 bool enableGPRS(bool onoff);
gtzintzarov3 0:851248a56628 272 uint8_t GPRSstate(void);
gtzintzarov3 0:851248a56628 273 bool getGSMLoc(uint16_t *replycode, char *buff, uint16_t maxlen);
gtzintzarov3 0:851248a56628 274 bool getGSMLoc(float *lat, float *lon);
gtzintzarov3 0:851248a56628 275 void setGPRSNetworkSettings(const char* apn, const char* username=0, const char* password=0);
gtzintzarov3 0:851248a56628 276
gtzintzarov3 0:851248a56628 277 // GPS handling
gtzintzarov3 0:851248a56628 278 bool enableGPS(bool onoff);
gtzintzarov3 0:851248a56628 279 int8_t GPSstatus(void);
gtzintzarov3 0:851248a56628 280 uint8_t getGPS(uint8_t arg, char *buffer, uint8_t maxbuff);
gtzintzarov3 0:851248a56628 281 bool getGPS(float *lat, float *lon, float *speed_kph=0, float *heading=0, float *altitude=0);
gtzintzarov3 0:851248a56628 282 bool enableGPSNMEA(uint8_t nmea);
gtzintzarov3 0:851248a56628 283
gtzintzarov3 0:851248a56628 284 // TCP raw connections
gtzintzarov3 0:851248a56628 285 bool TCPconnect(char *server, uint16_t port);
gtzintzarov3 0:851248a56628 286 bool TCPclose(void);
gtzintzarov3 0:851248a56628 287 bool TCPconnected(void);
gtzintzarov3 0:851248a56628 288 bool TCPsend(char *packet, uint8_t len);
gtzintzarov3 0:851248a56628 289 uint16_t TCPavailable(void);
gtzintzarov3 0:851248a56628 290 uint16_t TCPread(uint8_t *buff, uint8_t len);
gtzintzarov3 0:851248a56628 291
gtzintzarov3 0:851248a56628 292 // HTTP low level interface (maps directly to SIM800 commands).
gtzintzarov3 0:851248a56628 293 bool HTTP_init();
gtzintzarov3 0:851248a56628 294 bool HTTP_term();
gtzintzarov3 0:851248a56628 295 void HTTP_para_start(const char* parameter, bool quoted = true);
gtzintzarov3 0:851248a56628 296 bool HTTP_para_end(bool quoted = true);
gtzintzarov3 0:851248a56628 297 bool HTTP_para(const char* parameter, const char *value);
gtzintzarov3 0:851248a56628 298 bool HTTP_para(const char* parameter, int32_t value);
gtzintzarov3 0:851248a56628 299 bool HTTP_data(uint32_t size, uint32_t maxTime=10000);
gtzintzarov3 0:851248a56628 300 bool HTTP_action(uint8_t method, uint16_t *status, uint16_t *datalen, int32_t timeout = 10000);
gtzintzarov3 0:851248a56628 301 bool HTTP_readall(uint16_t *datalen);
gtzintzarov3 0:851248a56628 302 bool HTTP_ssl(bool onoff);
gtzintzarov3 0:851248a56628 303
gtzintzarov3 0:851248a56628 304 // HTTP high level interface (easier to use, less flexible).
gtzintzarov3 0:851248a56628 305 bool HTTP_GET_start(char *url, uint16_t *status, uint16_t *datalen);
gtzintzarov3 0:851248a56628 306 void HTTP_GET_end(void);
gtzintzarov3 0:851248a56628 307 bool HTTP_POST_start(char *url, const char* contenttype, const uint8_t *postdata, uint16_t postdatalen, uint16_t *status, uint16_t *datalen);
gtzintzarov3 0:851248a56628 308 void HTTP_POST_end(void);
gtzintzarov3 0:851248a56628 309 void setUserAgent(const char* useragent);
gtzintzarov3 0:851248a56628 310
gtzintzarov3 0:851248a56628 311 // HTTPS
gtzintzarov3 0:851248a56628 312 void setHTTPSRedirect(bool onoff);
gtzintzarov3 0:851248a56628 313
gtzintzarov3 0:851248a56628 314 // PWM (buzzer)
gtzintzarov3 0:851248a56628 315 bool setPWM(uint16_t period, uint8_t duty = 50);
gtzintzarov3 0:851248a56628 316
gtzintzarov3 0:851248a56628 317 // Phone calls
gtzintzarov3 0:851248a56628 318 bool callPhone(char *phonenum);
gtzintzarov3 0:851248a56628 319 bool hangUp(void);
gtzintzarov3 0:851248a56628 320 bool pickUp(void);
gtzintzarov3 0:851248a56628 321 bool callerIdNotification(bool enable);
gtzintzarov3 0:851248a56628 322 bool incomingCallNumber(char* phonenum);
gtzintzarov3 0:851248a56628 323
gtzintzarov3 0:851248a56628 324 // Helper functions to verify responses.
gtzintzarov3 0:851248a56628 325 bool expectReply(const char* reply, uint16_t timeout = 10000);
gtzintzarov3 0:851248a56628 326
gtzintzarov3 0:851248a56628 327 private:
gtzintzarov3 0:851248a56628 328 DigitalOut _rstpin;
gtzintzarov3 0:851248a56628 329 InterruptIn _ringIndicatorInterruptIn;
gtzintzarov3 0:851248a56628 330
George windoge T 2:aaef20ac9044 331 char replybuffer[255]; // the output of getreply(), readline() is the function that changes the replybuffer
gtzintzarov3 0:851248a56628 332 char* apn;
gtzintzarov3 0:851248a56628 333 char* apnusername;
gtzintzarov3 0:851248a56628 334 char* apnpassword;
gtzintzarov3 0:851248a56628 335 bool httpsredirect;
gtzintzarov3 0:851248a56628 336 char* useragent;
gtzintzarov3 0:851248a56628 337
gtzintzarov3 0:851248a56628 338 volatile bool _incomingCall;
gtzintzarov3 0:851248a56628 339 EventListener *eventListener;
gtzintzarov3 0:851248a56628 340 Serial mySerial;
gtzintzarov3 0:851248a56628 341
gtzintzarov3 0:851248a56628 342 // Circular buffer used to receive serial data from an interruption
gtzintzarov3 0:851248a56628 343 int rxBuffer[RX_BUFFER_SIZE + 1];
gtzintzarov3 0:851248a56628 344 volatile int rxBufferInIndex; // Index where new data is added to the buffer
gtzintzarov3 0:851248a56628 345 volatile int rxBufferOutIndex; // Index where data is removed from the buffer
gtzintzarov3 0:851248a56628 346 char currentReceivedLine[RX_BUFFER_SIZE]; // Array containing the current received line
gtzintzarov3 0:851248a56628 347 int currentReceivedLineSize;
gtzintzarov3 0:851248a56628 348
gtzintzarov3 0:851248a56628 349 inline bool isRxBufferFull() {
gtzintzarov3 0:851248a56628 350 return ((rxBufferInIndex + 1) % RX_BUFFER_SIZE) == rxBufferOutIndex;
gtzintzarov3 0:851248a56628 351 }
gtzintzarov3 0:851248a56628 352
gtzintzarov3 0:851248a56628 353 inline bool isRxBufferEmpty() {
gtzintzarov3 0:851248a56628 354 return rxBufferInIndex == rxBufferOutIndex;
gtzintzarov3 0:851248a56628 355 }
gtzintzarov3 0:851248a56628 356
gtzintzarov3 0:851248a56628 357 inline void incrementRxBufferInIndex() {
gtzintzarov3 0:851248a56628 358 rxBufferInIndex = (rxBufferInIndex + 1) % RX_BUFFER_SIZE;
gtzintzarov3 0:851248a56628 359 }
gtzintzarov3 0:851248a56628 360
gtzintzarov3 0:851248a56628 361 inline void incrementRxBufferOutIndex() {
gtzintzarov3 0:851248a56628 362 rxBufferOutIndex = (rxBufferOutIndex + 1) % RX_BUFFER_SIZE;
gtzintzarov3 0:851248a56628 363 }
gtzintzarov3 0:851248a56628 364
gtzintzarov3 0:851248a56628 365 /**
gtzintzarov3 0:851248a56628 366 * Method called when Serial data is received (interrupt routine).
gtzintzarov3 0:851248a56628 367 */
gtzintzarov3 0:851248a56628 368 void onSerialDataReceived();
gtzintzarov3 0:851248a56628 369
gtzintzarov3 0:851248a56628 370 // HTTP helpers
gtzintzarov3 0:851248a56628 371 bool HTTP_setup(char *url);
gtzintzarov3 0:851248a56628 372
gtzintzarov3 0:851248a56628 373 void flushInput();
gtzintzarov3 0:851248a56628 374 uint16_t readRaw(uint16_t b);
gtzintzarov3 0:851248a56628 375 uint8_t readline(uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS, bool multiline = false);
gtzintzarov3 0:851248a56628 376 uint8_t getReply(const char* send, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 377 uint8_t getReply(const char* prefix, char *suffix, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 378 uint8_t getReply(const char* prefix, int32_t suffix, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 379 uint8_t getReply(const char* prefix, int32_t suffix1, int32_t suffix2, uint16_t timeout); // Don't set default value or else function call is ambiguous.
gtzintzarov3 0:851248a56628 380 uint8_t getReplyQuoted(const char* prefix, const char* suffix, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 381
gtzintzarov3 0:851248a56628 382 bool sendCheckReply(const char* send, const char* reply, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 383 bool sendCheckReply(const char* prefix, char *suffix, const char* reply, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 384 bool sendCheckReply(const char* prefix, int32_t suffix, const char* reply, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 385 bool sendCheckReply(const char* prefix, int32_t suffix, int32_t suffix2, const char* reply, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 386 bool sendCheckReplyQuoted(const char* prefix, const char* suffix, const char* reply, uint16_t timeout = FONA_DEFAULT_TIMEOUT_MS);
gtzintzarov3 0:851248a56628 387
gtzintzarov3 0:851248a56628 388 bool parseReply(const char* toreply, uint16_t *v, char divider = ',', uint8_t index=0);
gtzintzarov3 0:851248a56628 389 bool parseReply(const char* toreply, char *v, char divider = ',', uint8_t index=0);
gtzintzarov3 0:851248a56628 390 bool parseReplyQuoted(const char* toreply, char* v, int maxlen, char divider, uint8_t index);
gtzintzarov3 0:851248a56628 391
gtzintzarov3 0:851248a56628 392 bool sendParseReply(const char* tosend, const char* toreply, uint16_t *v, char divider = ',', uint8_t index = 0);
gtzintzarov3 0:851248a56628 393
gtzintzarov3 0:851248a56628 394 void onIncomingCall();
gtzintzarov3 0:851248a56628 395 };
gtzintzarov3 0:851248a56628 396
gtzintzarov3 0:851248a56628 397 #endif