123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752 |
- /**
- * file TinyGsmClientXBee.h
- * author Volodymyr Shymanskyy
- * license LGPL-3.0
- * copyright Copyright (c) 2016 Volodymyr Shymanskyy
- * date Nov 2016
- */
-
- #ifndef TinyGsmClientXBee_h
- #define TinyGsmClientXBee_h
-
- //#define TINY_GSM_DEBUG Serial
-
- #if !defined(TINY_GSM_RX_BUFFER)
- #define TINY_GSM_RX_BUFFER 256
- #endif
-
- #define TINY_GSM_MUX_COUNT 1 // Multi-plexing isn't supported using command mode
-
- #include "TinyGsmCommon.h"
-
- #define GSM_NL "\r"
- static const char GSM_OK[] TINY_GSM_PROGMEM = "OK" GSM_NL;
- static const char GSM_ERROR[] TINY_GSM_PROGMEM = "ERROR" GSM_NL;
-
- enum SimStatus {
- SIM_ERROR = 0,
- SIM_READY = 1,
- SIM_LOCKED = 2,
- };
-
- enum XBeeType {
- S6B = 0,
- LTEC1 = 1,
- };
-
- enum RegStatus {
- REG_UNREGISTERED = 0,
- REG_SEARCHING = 2,
- REG_DENIED = 3,
- REG_OK_HOME = 1,
- REG_OK_ROAMING = 5,
- REG_UNKNOWN = 4,
- };
-
-
- class TinyGsm
- {
-
- public:
-
- class GsmClient : public Client
- {
- friend class TinyGsm;
-
- public:
- GsmClient() {}
-
- GsmClient(TinyGsm& modem, uint8_t mux = 0)
- {
- init(&modem, mux);
- }
-
- bool init(TinyGsm* modem, uint8_t mux = 0)
- {
- this->at = modem;
- this->mux = mux;
- sock_connected = false;
-
- at->sockets[mux] = this;
-
- return true;
- }
-
- public:
- virtual int connect(const char *host, uint16_t port)
- {
- at->streamClear(); // Empty anything remaining in the buffer;
- at->commandMode();
- sock_connected = at->modemConnect(host, port, mux, false);
- at->writeChanges();
- at->exitCommand();
- return sock_connected;
- }
-
- virtual int connect(IPAddress ip, uint16_t port)
- {
- at->streamClear(); // Empty anything remaining in the buffer;
- at->commandMode();
- sock_connected = at->modemConnect(ip, port, mux, false);
- at->writeChanges();
- at->exitCommand();
- return sock_connected;
- }
-
- // This is a hack to shut the socket by setting the timeout to zero and
- // then sending an empty line to the server.
- virtual void stop()
- {
- at->streamClear(); // Empty anything remaining in the buffer;
- at->commandMode();
- at->sendAT(GF("TM0")); // Set socket timeout to 0;
- at->waitResponse();
- at->writeChanges();
- at->exitCommand();
- at->modemSend("", 1, mux);
- at->commandMode();
- at->sendAT(GF("TM64")); // Set socket timeout back to 10seconds;
- at->waitResponse();
- at->writeChanges();
- at->exitCommand();
- at->streamClear(); // Empty anything remaining in the buffer;
- sock_connected = false;
- }
-
- virtual size_t write(const uint8_t *buf, size_t size)
- {
- TINY_GSM_YIELD();
- //at->maintain();
- return at->modemSend(buf, size, mux);
- }
-
- virtual size_t write(uint8_t c)
- {
- return write(&c, 1);
- }
-
- virtual int available()
- {
- TINY_GSM_YIELD();
- return at->stream.available();
- }
-
- virtual int read(uint8_t *buf, size_t size)
- {
- TINY_GSM_YIELD();
- return at->stream.readBytes(buf, size);
- }
-
- virtual int read()
- {
- TINY_GSM_YIELD();
- return at->stream.read();
- }
-
- virtual int peek()
- {
- return at->stream.peek();
- }
- virtual void flush()
- {
- at->stream.flush();
- }
-
- virtual uint8_t connected()
- {
- if (available()) {
- return true;
- }
- return sock_connected;
- }
- virtual operator bool()
- {
- return connected();
- }
-
- /*
- * Extended API
- */
-
- String remoteIP() TINY_GSM_ATTR_NOT_IMPLEMENTED;
-
- private:
- TinyGsm* at;
- uint8_t mux;
- bool sock_connected;
- };
-
- class GsmClientSecure : public GsmClient
- {
- public:
- GsmClientSecure() {}
-
- GsmClientSecure(TinyGsm& modem, uint8_t mux = 1)
- : GsmClient(modem, mux)
- {}
-
- public:
- virtual int connect(const char *host, uint16_t port)
- {
- at->streamClear(); // Empty anything remaining in the buffer;
- at->commandMode();
- sock_connected = at->modemConnect(host, port, mux, true);
- at->writeChanges();
- at->exitCommand();
- return sock_connected;
- }
-
- virtual int connect(IPAddress ip, uint16_t port)
- {
- at->streamClear(); // Empty anything remaining in the buffer;
- at->commandMode();
- sock_connected = at->modemConnect(ip, port, mux, true);
- at->writeChanges();
- at->exitCommand();
- return sock_connected;
- }
- };
-
- public:
-
- explicit TinyGsm(Stream& stream)
- : stream(stream)
- {
- memset(sockets, 0, sizeof(sockets));
- }
-
- /*
- * Basic functions
- */
- bool begin()
- {
- return init();
- }
-
- bool init()
- {
- guardTime = 1100;
- commandMode();
- sendAT(GF("AP0")); // Put in transparent mode
- waitResponse();
- sendAT(GF("GT64")); // shorten the guard time to 100ms
- waitResponse();
- writeChanges();
- sendAT(GF("HS")); // Get the "Hardware Series"; 0x601 for S6B (Wifi)
- // wait for the response
- unsigned long startMillis = millis();
- while (!stream.available() && millis() - startMillis < 1000) {};
- String res = streamReadUntil('\r'); // Does not send an OK, just the result
- exitCommand();
- if (res == "601") {
- beeType = S6B;
- } else {
- beeType = LTEC1;
- }
- guardTime = 125;
- return true;
- }
-
- bool testAT(unsigned long timeout = 10000L)
- {
- for (unsigned long start = millis(); millis() - start < timeout; ) {
- if (commandMode()) {
- sendAT();
- if (waitResponse(200) == 1) {
- return true;
- }
- exitCommand();
- }
- delay(100);
- }
- return false;
- }
-
- void maintain() {}
-
- bool factoryDefault()
- {
- commandMode();
- sendAT(GF("RE"));
- bool ret_val = waitResponse() == 1;
- writeChanges();
- exitCommand();
- return ret_val;
- }
-
- bool hasSSL()
- {
- if (beeType == S6B) {
- return false;
- } else {
- return true;
- }
- }
-
- /*
- * Power functions
- */
-
- bool restart()
- {
- commandMode();
- sendAT(GF("FR"));
- if (waitResponse() != 1) {
- return false;
- }
- delay (2000); // Actually resets about 2 seconds later
- for (unsigned long start = millis(); millis() - start < 60000L; ) {
- if (commandMode()) {
- exitCommand();
- return true;
- }
- }
- exitCommand();
- return false;;
- }
-
- void setupPinSleep()
- {
- commandMode();
- sendAT(GF("SM"),1);
- waitResponse();
- if (beeType == S6B) {
- sendAT(GF("SO"),200);
- waitResponse();
- }
- writeChanges();
- exitCommand();
- }
-
- /*
- * SIM card functions
- */
-
- bool simUnlock(const char *pin) // Not supported
- {
- return false;
- }
-
- String getSimCCID()
- {
- commandMode();
- sendAT(GF("S#"));
- // wait for the response
- unsigned long startMillis = millis();
- while (!stream.available() && millis() - startMillis < 1000) {};
- String res = streamReadUntil('\r'); // Does not send an OK, just the result
- exitCommand();
- return res;
- }
-
- String getIMEI()
- {
- commandMode();
- sendAT(GF("IM"));
- // wait for the response
- unsigned long startMillis = millis();
- while (!stream.available() && millis() - startMillis < 1000) {};
- String res = streamReadUntil('\r'); // Does not send an OK, just the result
- exitCommand();
- return res;
- }
-
- SimStatus getSimStatus(unsigned long timeout = 10000L)
- {
- return SIM_READY; // unsupported
- }
-
- RegStatus getRegistrationStatus()
- {
- commandMode();
- sendAT(GF("AI"));
- // wait for the response
- unsigned long startMillis = millis();
- while (!stream.available() && millis() - startMillis < 1000) {};
- String res = streamReadUntil('\r'); // Does not send an OK, just the result
- exitCommand();
-
- if(res == GF("0")) {
- return REG_OK_HOME;
- }
-
- else if(res == GF("13") || res == GF("2A")) {
- return REG_UNREGISTERED;
- }
-
- else if(res == GF("FF") || res == GF("22") || res == GF("23") ||
- res == GF("40") || res == GF("41") || res == GF("42")) {
- return REG_SEARCHING;
- }
-
- else if(res == GF("24") || res == GF("25") || res == GF("27")) {
- return REG_DENIED;
- }
-
- else {
- return REG_UNKNOWN;
- }
- }
-
- String getOperator()
- {
- commandMode();
- sendAT(GF("MN"));
- // wait for the response
- unsigned long startMillis = millis();
- while (!stream.available() && millis() - startMillis < 1000) {};
- String res = streamReadUntil('\r'); // Does not send an OK, just the result
- exitCommand();
- return res;
- }
-
- /*
- * Generic network functions
- */
-
- int getSignalQuality()
- {
- commandMode();
- if (beeType == S6B) {
- sendAT(GF("LM")); // ask for the "link margin" - the dB above sensitivity
- } else {
- sendAT(GF("DB")); // ask for the cell strength in dBm
- }
- // wait for the response
- unsigned long startMillis = millis();
- while (!stream.available() && millis() - startMillis < 1000) {};
- char buf[2] = {0}; // Set up buffer for response
- buf[0] = streamRead();
- buf[1] = streamRead();
- // DBG(buf[0], buf[1], "\n");
- exitCommand();
- int intr = strtol(buf, 0, 16);
- if (beeType == S6B) {
- return -93 + intr; // the maximum sensitivity is -93dBm
- } else {
- return -1*intr; // need to convert to negative number
- }
- }
-
- bool isNetworkConnected()
- {
- RegStatus s = getRegistrationStatus();
- return (s == REG_OK_HOME || s == REG_OK_ROAMING);
- }
-
- bool waitForNetwork(unsigned long timeout = 60000L)
- {
- for (unsigned long start = millis(); millis() - start < timeout; ) {
- if (isNetworkConnected()) {
- return true;
- }
- delay(250);
- }
- return false;
- }
-
- /*
- * WiFi functions
- */
- bool networkConnect(const char* ssid, const char* pwd)
- {
-
- commandMode();
-
- sendAT(GF("EE"), 2); // Set security to WPA2
- waitResponse();
-
- sendAT(GF("ID"), ssid);
- if (waitResponse() != 1) {
- goto fail;
- }
-
- sendAT(GF("PK"), pwd);
- if (waitResponse() != 1) {
- goto fail;
- }
-
- writeChanges();
- exitCommand();
-
- return true;
-
- fail:
- exitCommand();
- return false;
- }
-
- bool networkDisconnect()
- {
- return false; // Doesn't support disconnecting
- }
-
- String getLocalIP()
- {
- commandMode();
- sendAT(GF("MY"));
- String IPaddr;
- IPaddr.reserve(16);
- // wait for the response
- unsigned long startMillis = millis();
- while (stream.available() < 8 && millis() - startMillis < 30000) {};
- IPaddr = streamReadUntil('\r'); // read result
- return IPaddr;
- }
-
- IPAddress localIP()
- {
- return TinyGsmIpFromString(getLocalIP());
- }
-
- /*
- * GPRS functions
- */
- bool gprsConnect(const char* apn, const char* user = NULL, const char* pwd = NULL)
- {
- commandMode();
- sendAT(GF("AN"), apn); // Set the APN
- waitResponse();
- writeChanges();
- exitCommand();
- return true;
- }
-
- bool gprsDisconnect() // TODO
- {
- return false;
- }
-
- /*
- * Messaging functions
- */
-
- String sendUSSD(const String& code) TINY_GSM_ATTR_NOT_IMPLEMENTED;
-
- bool sendSMS(const String& number, const String& text)
- {
- commandMode();
- sendAT(GF("IP"), 2); // Put in text messaging mode
- waitResponse();
- sendAT(GF("PH"), number); // Set the phone number
- waitResponse();
- sendAT(GF("TDD")); // Set the text delimiter to the standard 0x0D (carriabe return)
- waitResponse();
- writeChanges();
- exitCommand();
- stream.print(text);
- stream.write((char)0x0D); // close off with the carriage return
- return true;
- }
-
-
- private:
-
- int modemConnect(const char* host, uint16_t port, uint8_t mux = 0, bool ssl = false)
- {
- sendAT(GF("LA"), host);
- String strIP;
- strIP.reserve(16);
- // wait for the response
- unsigned long startMillis = millis();
- while (stream.available() < 8 && millis() - startMillis < 30000) {};
- strIP = streamReadUntil('\r'); // read result
- IPAddress ip = TinyGsmIpFromString(strIP);
- return modemConnect(ip, port, mux, ssl);
- }
-
- int modemConnect(IPAddress ip, uint16_t port, uint8_t mux = 0, bool ssl = false)
- {
- String host;
- host.reserve(16);
- host += ip[0];
- host += ".";
- host += ip[1];
- host += ".";
- host += ip[2];
- host += ".";
- host += ip[3];
- if (ssl) {
- sendAT(GF("IP"), 4); // Put in TCP mode
- waitResponse();
- } else {
- sendAT(GF("IP"), 1); // Put in TCP mode
- waitResponse();
- }
- sendAT(GF("DL"), host); // Set the "Destination Address Low"
- waitResponse();
- sendAT(GF("DE"), String(port, HEX)); // Set the destination port
- int rsp = waitResponse();
- return rsp;
- }
-
- int modemSend(const void* buff, size_t len, uint8_t mux = 0)
- {
- stream.write((uint8_t*)buff, len);
- stream.flush();
- return len;
- }
-
- bool modemGetConnected(uint8_t mux = 0)
- {
- commandMode();
- sendAT(GF("AI"));
- int res = waitResponse(GF("0"));
- exitCommand();
- return 1 == res;
- }
-
- public:
-
- /* Utilities */
-
- template<typename T>
- void streamWrite(T last)
- {
- stream.print(last);
- }
-
- template<typename T, typename... Args>
- void streamWrite(T head, Args... tail)
- {
- stream.print(head);
- streamWrite(tail...);
- }
-
- int streamRead()
- {
- return stream.read();
- }
-
- String streamReadUntil(char c)
- {
- TINY_GSM_YIELD();
- String return_string = stream.readStringUntil(c);
- return_string.trim();
- // DBG(return_string, c);
- return return_string;
- }
-
- void streamClear(void)
- {
- while (stream.available()) {
- streamRead();
- }
- }
-
- bool commandMode(void)
- {
- delay(guardTime); // cannot send anything for 1 second before entering command mode
- streamWrite(GF("+++")); // enter command mode
- // DBG("\r\n+++\r\n");
- return 1 == waitResponse(guardTime*2);
- }
-
- void writeChanges(void)
- {
- sendAT(GF("WR")); // Write changes to flash
- waitResponse();
- sendAT(GF("AC")); // Apply changes
- waitResponse();
- }
-
- void exitCommand(void)
- {
- sendAT(GF("CN")); // Exit command mode
- waitResponse();
- }
-
- template<typename... Args>
- void sendAT(Args... cmd)
- {
- streamWrite("AT", cmd..., GSM_NL);
- stream.flush();
- TINY_GSM_YIELD();
- //DBG("### AT:", cmd...);
- }
-
- // TODO: Optimize this!
- uint8_t waitResponse(uint32_t timeout, String& data,
- GsmConstStr r1=GFP(GSM_OK), GsmConstStr r2=GFP(GSM_ERROR),
- GsmConstStr r3=NULL, GsmConstStr r4=NULL, GsmConstStr r5=NULL)
- {
- /*String r1s(r1); r1s.trim();
- String r2s(r2); r2s.trim();
- String r3s(r3); r3s.trim();
- String r4s(r4); r4s.trim();
- String r5s(r5); r5s.trim();
- DBG("### ..:", r1s, ",", r2s, ",", r3s, ",", r4s, ",", r5s);*/
- data.reserve(64);
- int index = 0;
- unsigned long startMillis = millis();
- do {
- TINY_GSM_YIELD();
- while (stream.available() > 0) {
- int a = streamRead();
- if (a <= 0) {
- continue; // Skip 0x00 bytes, just in case
- }
- data += (char)a;
- if (r1 && data.endsWith(r1)) {
- index = 1;
- goto finish;
- } else if (r2 && data.endsWith(r2)) {
- index = 2;
- goto finish;
- } else if (r3 && data.endsWith(r3)) {
- index = 3;
- goto finish;
- } else if (r4 && data.endsWith(r4)) {
- index = 4;
- goto finish;
- } else if (r5 && data.endsWith(r5)) {
- index = 5;
- goto finish;
- }
- }
- } while (millis() - startMillis < timeout);
- finish:
- if (!index) {
- data.trim();
- data.replace(GSM_NL GSM_NL, GSM_NL);
- data.replace(GSM_NL, "\r\n" " ");
- if (data.length()) {
- DBG("### Unhandled:", data, "\r\n");
- } else {
- DBG("### NO RESPONSE!\r\n");
- }
- } else {
- data.trim();
- data.replace(GSM_NL GSM_NL, GSM_NL);
- data.replace(GSM_NL, "\r\n ");
- if (data.length()) {
- // DBG("<<< ", data);
- }
- }
- return index;
- }
-
- uint8_t waitResponse(uint32_t timeout,
- GsmConstStr r1=GFP(GSM_OK), GsmConstStr r2=GFP(GSM_ERROR),
- GsmConstStr r3=NULL, GsmConstStr r4=NULL, GsmConstStr r5=NULL)
- {
- String data;
- return waitResponse(timeout, data, r1, r2, r3, r4, r5);
- }
-
- uint8_t waitResponse(GsmConstStr r1=GFP(GSM_OK), GsmConstStr r2=GFP(GSM_ERROR),
- GsmConstStr r3=NULL, GsmConstStr r4=NULL, GsmConstStr r5=NULL)
- {
- return waitResponse(1000, r1, r2, r3, r4, r5);
- }
-
- public:
- Stream& stream;
-
- protected:
- int guardTime;
- XBeeType beeType;
- GsmClient* sockets[TINY_GSM_MUX_COUNT];
- };
-
- #endif
|