View raw code<\/a><\/p>\n\n\n\nInsert your SIM card pin on the following line:<\/p>\n\n\n\n
#define GSM_PIN \"\"<\/code><\/pre>\n\n\n\nFill your APN details:<\/p>\n\n\n\n
const char apn[] = \"net2.vodafone.pt\"; \/\/SET TO YOUR APN\nconst char gprsUser[] = \"vodafone\";\nconst char gprsPass[] = \"vodafone\";<\/code><\/pre>\n\n\n\nSet a recipient phone number to test sending SMS (it must be in international format including the “+” sign):<\/p>\n\n\n\n
\/\/ Set phone number, if you want to test SMS\n#define SMS_TARGET \"+XXXXXXXXXXXXXXXX\"<\/code><\/pre>\n\n\n\nSet the network mode with the value you got from the previous example.<\/p>\n\n\n\n
\/*\n 2 Automatic\n 13 GSM only\n 38 LTE only\n 51 GSM and LTE only\n* * * *\/\nString res;\n\/\/ CHANGE NETWORK MODE, IF NEEDED\n<\/strong>res = modem.setNetworkMode(2<\/strong>);\nif (res != \"1\") {\n DBG(\"setNetworkMode false \");\n return ;\n}\ndelay(200);<\/code><\/pre>\n\n\n\nChange the preferred mode with the value you got from the previous example.<\/p>\n\n\n\n
\/*\n 1 CAT-M\n 2 NB-Iot\n 3 CAT-M and NB-IoT\n* * *\/\n\/\/ CHANGE PREFERRED MODE, IF NEEDED\n<\/strong>res = modem.setPreferredMode(1<\/strong>);\nif (res != \"1\") {\n DBG(\"setPreferredMode false \");\n return ;\n}\ndelay(200);<\/code><\/pre>\n\n\n\nAfter that, you can upload the code to your board. Don’t forget to select ESP32 Dev Module<\/strong> in Tools <\/strong>> Board<\/strong>. You also need to remove the microSD card every time you want to upload a new sketch<\/strong>.<\/p>\n\n\n\nAfter uploading, you can insert the microSD card. Open the Serial Monitor at a baud rate of 115200, and press the on-board RST button to restart it.<\/p>\n\n\n\n
The board may take some time to get GPS data for the first time. Your board needs to be placed outside to be able to get a satellite signal<\/strong>. I placed mine next to the window and it was able to accurately get the GPS position.<\/p>\n\n\n\nYou should get something similar.<\/p>\n\n\n\n
Wait...\nInitializing modem...\nATE0\nAT+CFUN=0\nFailed to restart modem, attempting to continue without restarting\nInitializing modem...\nAT\nAT\nAT\nOK\nATE0\nATE0\nOK\nAT+CMEE=0\n\nOK\nAT+CLTS=1\n\nOK\nAT+CBATCHK=1\n\nOK\nAT+CPIN?\n\n+CPIN: READY\n\nOK\nAT+GMM\n\nSIMCOM_SIM7000G\n\nOK\nModem Name: SIMCOM SIM7000G\nATI\n\nSIM7000G R1529\n\nOK\nModem Info: SIM7000G R1529\nAT+SGPIO=0,4,1,0\n\nOK\nAT+CPIN?\n\n+CPIN: READY\n\nOK\nAT+CFUN=0 \n\n+CPIN: NOT READY\n\nOK\nAT+CNMP=2\n\nOK\nAT+CMNB=1\n\nOK\nAT+CFUN=1 \n\nOK\nAT+CGDCONT=1,\"IP\",\"net2.vodafone.pt\",\"0.0.0.0\",0,0,0,0\nAT+CGDCONT=13,\"IP\",\"net2.vodafone.pt\",\"0.0.0.0\",0,0,0,0\n\n\n\nWaiting for network...\nAT+CEREG?\n\nOK\nAT+CGREG?\n\n+CGREG: 0,2\n\nOK\nAT+CEREG?\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,2\n\nOK\nAT+CEREG?\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,2\n\nOK\nAT+CEREG?\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,2\n\nOK\nAT+CEREG?\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,2\n\nOK\nAT+CEREG?\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,2\n\nOK\nAT+CEREG?\n\nDST: 1\n\n*PSUTTZ: 22\/08\/07,13:45:17\",\"+04\",1\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,1\n\nOK\nAT+CEREG?\n\n+CEREG: 0,0\n\nOK\nAT+CGREG?\n\n+CGREG: 0,1\n\nOK\nNetwork connected\n\n---Starting GPRS TEST---\n\nConnecting to: net2.vodafone.pt\nAT+CIPSHUT\n\nSHUT OK\nAT+CGATT=0\n\nOK\nAT+SAPBR=3,1,\"Contype\",\"GPRS\"\n\nOK\nAT+SAPBR=3,1,\"APN\",\"net2.vodafone.pt\"\n\nOK\nAT+SAPBR=3,1,\"USER\",\"vodafone\"\n\nOK\nAT+SAPBR=3,1,\"PWD\",\"vodafone\"\n\nOK\nAT+CGDCONT=1,\"IP\",\"net2.vodafone.pt\"\n\nOK\nAT+CGATT=1\n\nOK\nAT+CGACT=1,1\n\nDST: 1\n\n*PSUTTZ: 22\/08\/07,13:45:19\",\"+04\",1\n\nOK\nAT+SAPBR=1,1\n\nOK\nAT+SAPBR=2,1\n\n+SAPBR: 1,1,\"10.196.118.208\"\n\nOK\nAT+CIPMUX=1\n\nOK\nAT+CIPQSEND=1\n\nOK\nAT+CIPRXGET=1\n\nOK\nAT+CSTT=\"net2.vodafone.pt\",\"vodafone\",\"vodafone\"\n\nOK\nAT+CIICR\n\nOK\nAT+CIFSR;E0\n\n10.196.118.208\n\nOK\nGPRS status: AT+CGATT?\n\n+CGATT: 1\n\nOK\nAT+CIFSR;E0\n\n10.196.118.208\n\nOK\nconnected\nAT+CCID\n\n8935101211825295132f\n\nOK\nCCID: 8935101211825295132f\nAT+GSN\n\n869951031125929\n\nOK\nIMEI: 869951031125929\nAT+COPS?\n\n+COPS: 0,0,\"vodafone P\",3\n\nOK\nOperator: vodafone P\nAT+CIFSR;E0\n\n10.196.118.208\n\nOK\nLocal IP: 3497444362\nAT+CSQ\n\n+CSQ: 22,0\n\nOK\nSignal quality: 22\n\n+CPSI: GSM,Online,268-01,0x000e,63308,15 EGSM 900,-73,0,38-38\n\nOK\n\n\n---End of GPRS TEST---\n\nAT+CIPSHUT\n\nSHUT OK\nAT+CGATT=0\n\n+SAPBR 1: DEACT\n\nOK\nAT+CGATT?\n\n+CGATT: 0\n\nOK\nGPRS disconnected\n\n---Starting GPS TEST---\n\nAT+SGPIO=0,4,1,1\n\nOK\nAT+CGNSPWR=1\n\nOK\nAT+CGNSINF\n\n+CGNSINF: 0,,,,,,,,,,,,,,,,,,,,\n\nOK\ngetGPS 26839\nAT+CGNSINF\n\n+CGNSINF: 1,0,,,,,,,0,,,,,,12,,,,50,,\n\nOK\ngetGPS 28844\nAT+CGNSINF\n\n+CGNSINF: 1,0,,,,,,,0,,,,,,12,,,,51,,\n\nOK\ngetGPS 30850\nAT+CGNSINF\n\n+CGNSINF: 1,0,,,,,,,0,,,,,,13,,,,51,,\n\nOK\ngetGPS 32856\nAT+CGNSINF\n\n+CGNSINF: 1,0,,,,,,,0,,,,,,12,,,,51,,\n\nOK\ngetGPS 34862\nAT+CGNSINF\n\n+CGNSINF: 1,0,,,,,,,0,,,,,,12,,,,51,,\n\nOK\ngetGPS 36868\nAT+CGNSINF\n\n+CGNSINF: 1,1,20220807134533.000,41.12XXXX,-8.530XXXX,116.200,0.00,0.0,1,,4.2,,,,13,4,,,51,,\n\nOK\nlat:41.12XXXX lon:-8.530XXXX\nAT+CGNSPWR=0\n\nOK\nAT+SGPIO=0,4,1,0\n\nOK\n\n---End of GPRS TEST---\n\nAT+CMGF=1\n\nOK\nAT+CSCS=\"GSM\"\n\nOK\nAT+CMGS=\"+351916XXXXXXXX\"\n\n>Hello from 86995103XXXXXXXXX \n+CMGS: 228\n\nOK\nAT+CPOWD=1\n\nNORMAL POWER DOWN\nAT+CPOWD=1\nPoweroff.<\/code><\/pre>\n\n\n\nHow the Code Works<\/h2>\n\n\n\n
Let’s take a quick look at the relevant parts of code.<\/p>\n\n\n\n
First, you need to define the module you’re using. The library is compatible with many different modules. To use the SIM7000G, include the following line:<\/p>\n\n\n\n
#define TINY_GSM_MODEM_SIM7000<\/code><\/pre>\n\n\n\nInsert the SIM card pin, APN details, and SMS recipient:<\/p>\n\n\n\n
\/\/ set GSM PIN, if any\n#define GSM_PIN \"\"\n\n\/\/ Your GPRS credentials, if any\nconst char apn[] = \"net2.vodafone.pt\"; \/\/SET TO YOUR APN\nconst char gprsUser[] = \"vodafone\";\nconst char gprsPass[] = \"vodafone\";\n\n\/\/ Set phone numbers, if you want to test SMS\n#define SMS_TARGET \"+351------------\"<\/code><\/pre>\n\n\n\nInclude the TinyGSM<\/span> and SPI<\/span> libraries. You also need to include the SD<\/span> library if you want to use the microSD card.<\/p>\n\n\n\n#include <TinyGsmClient.h>\n#include <SPI.h>\n#include <SD.h>\n#include <Ticker.h><\/code><\/pre>\n\n\n\nCreate a TinyGsmClient<\/span> instance:<\/p>\n\n\n\n#ifdef DUMP_AT_COMMANDS \/\/ if enabled it requires the streamDebugger lib\n #include <StreamDebugger.h>\n StreamDebugger debugger(SerialAT, Serial);\n TinyGsm modem(debugger);\n#else\n TinyGsm modem(SerialAT);\n#endif<\/code><\/pre>\n\n\n\nSIM7000G pinout<\/h3>\n\n\n\n
The following lines set the module baud rate and pinout:<\/p>\n\n\n\n
#define UART_BAUD 115200\n#define PIN_DTR 25\n#define PIN_TX 27\n#define PIN_RX 26\n#define PWR_PIN 4\n\n#define SD_MISO 2\n#define SD_MOSI 15\n#define SD_SCLK 14\n#define SD_CS 13\n#define LED_PIN 12<\/code><\/pre>\n\n\n\nPower the modem<\/h3>\n\n\n\n
In the setup()<\/span>, you always need to include the following instructions to turn on the modem:<\/p>\n\n\n\npinMode(PWR_PIN, OUTPUT);\ndigitalWrite(PWR_PIN, HIGH);\ndelay(300);\ndigitalWrite(PWR_PIN, LOW);<\/code><\/pre>\n\n\n\nInitialize microSD Card<\/h3>\n\n\n\n
The following lines initialize the microSD card on the pins we defined earlier.<\/p>\n\n\n\n
SPI.begin(SD_SCLK, SD_MISO, SD_MOSI, SD_CS);\nif (!SD.begin(SD_CS)) {\n Serial.println(\"SDCard MOUNT FAIL\");\n} else {\n uint32_t cardSize = SD.cardSize() \/ (1024 * 1024);\n String str = \"SDCard Size: \" + String(cardSize) + \"MB\";\n Serial.println(str);\n}<\/code><\/pre>\n\n\n\nTo learn more about using the microSD card with the ESP32, you can read the following guide: ESP32: Guide for MicroSD Card Module using Arduino IDE<\/a>.<\/p>\n\n\n\nStart Serial Communication<\/h3>\n\n\n\n
Start a serial communication with the modem:<\/p>\n\n\n\n
SerialAT.begin(UART_BAUD, SERIAL_8N1, PIN_RX, PIN_TX);<\/code><\/pre>\n\n\n\nRestart and Initialize the Modem<\/h3>\n\n\n\n
Call the following lines to restart the modem:<\/p>\n\n\n\n
\/\/ Restart takes quite some time\n\/\/ To skip it, call init() instead of restart()\nSerial.println(\"Initializing modem...\");\nif (!modem.restart()) {\n Serial.println(\"Failed to restart modem, attempting to continue without restarting\");\n}<\/code><\/pre>\n\n\n\nOr the following lines to initialize:<\/p>\n\n\n\n
\/\/ To skip it, call init() instead of restart()\nSerial.println(\"Initializing modem...\");\nif (!modem.init()) {\n Serial.println(\"Failed to restart modem, attempting to continue without restarting\");\n}<\/code><\/pre>\n\n\n\nDifference between restart()<\/span> and init()<\/span> according to documentation: ” restart()<\/span> generally takes longer than init()<\/span> but ensures the module doesn’t have lingering connections”.<\/p>\n\n\n\nGet Modem Name and Info<\/h3>\n\n\n\n
You can use the getModemName()<\/span> and getModemInfo()<\/span> to get information about the modem.<\/p>\n\n\n\nString name = modem.getModemName();\ndelay(500);\nSerial.println(\"Modem Name: \" + name);\n\nString modemInfo = modem.getModemInfo();\ndelay(500);\nSerial.println(\"Modem Info: \" + modemInfo);<\/code><\/pre>\n\n\n\nConnect GPRS<\/h3>\n\n\n\n
To connect GPRS using the APN details:<\/p>\n\n\n\n
if (!modem.gprsConnect(apn, gprsUser, gprsPass)) {\n delay(10000);\n return;\n}<\/code><\/pre>\n\n\n\nTo check if it is connected, you can use the isGprsConnected()<\/span> method:<\/p>\n\n\n\nif (modem.isGprsConnected()) {\n Serial.println(\"connected\");\n} else {\n Serial.println(\"not connected\");\n}<\/code><\/pre>\n\n\n\nStart GPS and Get Location<\/h3>\n\n\n\n
As mentioned previously, there are two versions of the LILYGO SIM7000G ESP32 board. The latest comes with active GPS antenna power control\u2014when the module GPIO 4 is not turned on the antenna consumes only the static current of the LDO. This means we need to turn GPIO 4 on before getting GPS data to power the antenna. That’s what the next lines do:<\/p>\n\n\n\n
\/\/ Set SIM7000G GPIO4 HIGH ,turn on GPS power\n\/\/ CMD:AT+SGPIO=0,4,1,1\n\/\/ Only in version 20200415 is there a function to control GPS power\nmodem.sendAT(\"+SGPIO=0,4,1,1\");\nif (modem.waitResponse(10000L) != 1) {\n DBG(\" SGPIO=0,4,1,1 false \");\n}<\/code><\/pre>\n\n\n\nIf you have the oldest version, you don’t need those lines of code.<\/p>\n\n\n\n
You can start GPS using the enableGPS()<\/span> method.<\/p>\n\n\n\nmodem.enableGPS();<\/code><\/pre>\n\n\n\nGet latitude and longitude using the getGPS()<\/span> method.<\/p>\n\n\n\n
![\"Getting](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/Getting-Started-LILYGO-T-SIM7000G-ESP32.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"LILYGO](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-TSIM7000G.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-SIM7000G-GPS-antenna-SIM-antenna.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"LILYGO](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-SIM700G-LILYGO-OLD-VS-NEW.jpg?resize=750%2C512&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2017\/10\/header-200.png?w=1200&quality=100&strip=all&ssl=1\")
<\/a><\/p>\n\n\n\n![\"LILYGO](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/LILYGO-SIM7000G-ESP32-V1_0_pinout.jpg?resize=1200%2C848&quality=100&strip=all&ssl=1\")
<\/a>![\"LILYGO](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/LILYGO-SIM7000G-V1_1-ESP32-pinout.jpg?resize=1000%2C707&quality=100&strip=all&ssl=1\")
![\"LILYGO](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/LILYGO-T-SIM7000G-ESP32-nano-SIM-card.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Arduino](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Arduino-IDE-2-Install-TinyGSM-Library-using-Libraries-Manager-1.png?resize=278%2C307&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Arduino](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Arduino-IDE-2-Install-StreamDebugger-Library-using-Libraries-Manager.png?resize=275%2C305&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Nano](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/nano-SIM-card-vodafone.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-T-SIM7000G-antennas.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"Arduino](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/05\/arduino-2-0-upload-button.png?resize=30%2C30&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-T-SIM7000G-microSD-card.jpg?resize=750%2C422&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/SIM7000-network-test-ESP32-Serial-Monitor.png?resize=602%2C980&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n