Add files via upload

Added GSM Coordinates

Author: vittorioexp

README.md

@@ -23,29 +23,35 @@ Arduino Uno  |   Sim800L   |    Notes
 GND | GND | 
 
 
+* If it returns true there is an error
+
 ## Methods and functions
 
 Name|Return|Notes
 :-------|:-------:|:-----------------------------------------------:|
 begin()|None|Initialize the library
 begin(number)|None|Initialize the library with user's baud rate
 reset()|None|Reset the module, and wait to Sms Ready.
-setSleepMode(bool)|true or false|enable or disable sleep mode
-getSleepMode()|true or false|return sleep mode status
-setFunctionalityMode(number)|true or false|set functionality mode
-getFunctionalityMode()|true or false|return functionality mode status
-setPIN(String)|true or false|enable user to set a pin code
+setSleepMode(bool)|true or false|enable or disable sleep mode *
+getSleepMode()|true or false|return sleep mode status *
+setFunctionalityMode(number)|true or false|set functionality mode *
+getFunctionalityMode()|true or false|return functionality mode status *
+setPIN(String)|true or false|enable user to set a pin code *
 getProductInfo()|String|return product identification information
 getOperatorsList()|String|return the list of operators
 getOperator()|String|return the currently selected operator
-sendSms(number,text)|true or false|both parameters must be Strings.
+calculateLocation()|true or false|calculate gsm position *
+getLocationCode()|String|return the location code
+getLongitude()|String|return longitude
+getLatitude()|String|return latitude
+sendSms(number,text)|true or false|both parameters must be Strings. *
 readSms(index)|String|index is the position of the sms in the prefered memory storage
 getNumberSms(index)|String|returns the number of the sms.
-delAllSms()|true or false|Delete all sms
+delAllSms()|true or false|Delete all sms *
 signalQuality()|String|return info about signal quality
-answerCall()|true or false|
+answerCall()|true or false| *
 callNumber(number)|None|
-hangoffCall()|true or false|
+hangoffCall()|true or false| *
 getCallStatus()|uint8_t|Return the call status, 0=ready,2=Unknown(),3=Ringing,4=Call in progress
 setPhoneFunctionality()|None|Set at to full functionality 
 activateBearerProfile()|None|

Sim800L.cpp

@@ -251,6 +251,73 @@ String Sim800L::getOperator()
 }
 
 
+bool Sim800L::calculateLocation() 
+{
+	/*
+		Type: 1  To get longitude and latitude
+		Cid = 1  Bearer profile identifier refer to AT+SAPBR
+	*/
+		
+	uint8_t type = 1;
+	uint8_t cid = 1;
+	
+
+	this->print("AT+CIPGSMLOC=");
+	this->print(type);
+	this->print(",");
+	this->print(cid);
+	this->print("\r");
+	
+	
+	String data = _readSerial();
+	
+	if (data.indexOf("ER")!=(-1)) return false;
+	
+	uint8_t indexOne;
+	uint8_t indexTwo;
+	
+	indexOne = data.indexOf(":") + 1;
+	indexTwo = data.indexOf(",");
+
+	_locationCode = data.substring(indexOne , indexTwo);
+
+	indexOne = data.indexOf(",") + 1;
+	indexTwo = data.indexOf("," , indexOne);
+
+	_longitude = data.substring(indexOne , indexTwo);
+
+	indexOne = data.indexOf(",", indexTwo) + 1;
+	indexTwo = data.indexOf("," , indexOne);
+
+	_latitude = data.substring(indexOne , indexTwo);
+	
+	return true;
+		
+}
+
+String Sim800L::getLocationCode() {
+	return _locationCode;
+	/*
+     Location Code:
+     0      Success
+     404    Not Found
+     408    Request Time-out
+     601    Network Error
+     602    No Memory
+     603    DNS Error
+     604    Stack Busy
+     65535  Other Error
+  */
+}
+
+String Sim800L::getLongitude() {
+	return _longitude;
+}
+
+String Sim800L::getLatitude() {
+	return _latitude;
+}
+
 
 //
 //PUBLIC METHODS

Sim800L.h

@@ -84,6 +84,9 @@ class Sim800L : public SoftwareSerial
     String _buffer;
     bool _sleepMode;
     uint8_t _functionalityMode;
+	String _locationCode;
+	String _longitude;
+	String _latitude;
 
     String _readSerial();
     String _readSerial(uint32_t timeout);
@@ -116,6 +119,11 @@ class Sim800L : public SoftwareSerial
 
     String getOperatorsList();
     String getOperator();
+	
+	bool calculateLocation();
+	String getLocationCode();
+	String getLongitude();
+	String getLatitude();
 
     bool answerCall();
     void callNumber(char* number);

examples/GSM_Coordinates/GSM_Coordinates.ino

@@ -0,0 +1,108 @@
+/*
+    This library was written by Vittorio Esposito
+      https://github.com/VittorioEsposito
+
+    Designed to work with the GSM Sim800L.
+
+    ENG
+      This library uses SoftwareSerial, you can define RX and TX pins
+      in the header "Sim800L.h", by default pins are RX=10 and TX=11.
+      Be sure that GND is connected to arduino too.
+      You can also change the RESET_PIN as you prefer.
+
+    ESP
+      Esta libreria usa SoftwareSerial, se pueden cambiar los pines de RX y TX
+      en el archivo header, "Sim800L.h", por defecto los pines vienen configurado en
+      RX=10 TX=11.
+      Tambien se puede cambiar el RESET_PIN por otro que prefiera
+
+    ITA
+      Questa libreria utilizza la SoftwareSerial, si possono cambiare i pin di RX e TX
+      dall' intestazione "Sim800L.h", di default essi sono impostati come RX=10 RX=11
+      Assicurarsi di aver collegato il dispositivo al pin GND di Arduino.
+      E' anche possibile cambiare il RESET_PIN.
+
+
+     DEFAULT PINOUT:
+          _____________________________
+         |  ARDUINO UNO >>>   Sim800L  |
+          -----------------------------
+              GND      >>>   GND
+          RX  10       >>>   TX
+          TX  11       >>>   RX
+         RESET 2       >>>   RST
+
+     POWER SOURCE 4.2V >>> VCC
+
+
+    SOFTWARE SERIAL NOTES:
+
+      PINOUT
+      The library has the following known limitations:
+      1. If using multiple software serial ports, only one can receive data at a time.
+      2. Not all pins on the Mega and Mega 2560 support change interrupts, so only the following can be used for RX: 10, 11, 12, 13, 14, 15, 50, 51, 52, 53, A8 (62), A9 (63), A10 (64), A11 (65), A12 (66), A13 (67), A14 (68), A15 (69).
+      3. Not all pins on the Leonardo and Micro support change interrupts, so only the following can be used for RX: 8, 9, 10, 11, 14 (MISO), 15 (SCK), 16 (MOSI).
+      4. On Arduino or Genuino 101 the current maximum RX speed is 57600bps
+      5. On Arduino or Genuino 101 RX doesn't work on Pin 13
+
+      BAUD RATE
+      Supported baud rates are 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 31250, 38400, 57600, and 115200.
+
+
+    Edited on:  December 24, 2016
+      Editor:   Vittorio Esposito
+
+    Original version by:   Cristian Steib
+
+
+*/
+
+#include <Sim800L.h>
+#include <SoftwareSerial.h>
+
+#define RX  10
+#define TX  11
+
+Sim800L GSM(RX, TX);
+
+/*
+   In alternative:
+   Sim800L GSM;                       // Use default pinout
+   Sim800L GSM(RX, TX, RESET);
+   Sim800L GSM(RX, TX, RESET, LED);
+*/
+
+void setup() {
+  Serial.begin(9600);
+  GSM.begin(4800);
+
+  if (GSM.calculateLocation()) Serial.println("Location Calculated");
+  else Serial.println("Error in calculating location");
+
+  Serial.print("Location Code: ");
+  Serial.println(GSM.getLocationCode());
+
+  Serial.print("Longitude: ");
+  Serial.println(GSM.getLongitude());
+
+  Serial.print("Longitude: ");
+  Serial.println(GSM.getLatitude());
+
+  /*
+     Location Code:
+     0      Success
+     404    Not Found
+     408    Request Time-out
+     601    Network Error
+     602    No Memory
+     603    DNS Error
+     604    Stack Busy
+     65535  Other Error
+  */
+
+}
+
+void loop() {
+
+}
+

keywords.txt

@@ -45,6 +45,11 @@ getProductInfo	KEYWORD2
 getOperatorsList	KEYWORD2
 getOperator	KEYWORD2
 
+calculateLocation	KEYWORD2
+getLocationCode	KEYWORD2
+getLongitude	KEYWORD2
+getLatitude	KEYWORD2
+
 answerCall	KEYWORD2
 callNumber	KEYWORD2
 hangoffCall	KEYWORD2

library.properties

@@ -1,5 +1,5 @@
 name=Sim800L Library Revised
-version=1.0.0
+version=1.0.1
 author=Vittorio Esposito
 maintainer=Vittorio Esposito
 sentence=Arduino library for Sim800L