Voir la source de Virtual Fence - Anti Theft Device

{{Tuto Details
|Description=<translate>Use Geo-Fence to secure anything within your SAFE-HOUSE. Edge-computed fence based on GPS and Cellular IoT</translate>
|Area=Electronics
|Type=Creation
|Difficulty=Easy
|Duration=2
|Duration-type=hour(s)
|Cost=50-100
|Currency=USD ($)
}}
{{Introduction
|Introduction=<translate>In 2022, over 1 million theft cases, which is a 7% rise compared to 2021, have become a great concern in India. With a population of more than 1.4 billion, you never know whom to trust apart from your own self.

Hence, we are left with only one solution - '''Track Your Belongings'''

With the increased availability of devices to access the internet, we all need an automated system, that keeps us updated on our physical product and informs us if it has been moved from its designated location.

But, how do we track them? And how should one get an alert of a theft? We shall see and build a project on that.</translate>
}}
{{Materials}}
{{Tuto Step
|Step_Title=<translate>What is a Virtual Fence?</translate>
|Step_Content=<translate>A Fence is a physical boundary, which is used to restrict kids and dogs from exiting the border Boundaries provide a layer of security, which also restricts entry from outside. But these boundaries need to be maintained heavily. And once an object has moved out or stolen, then the theft cannot be further located.

This brings us to a solution, which is geofencing a physical device attached to our belonging. This belonging would be a mere part of the IoT - Internet of '''<nowiki/>'Things'.'''


The above pictorial is a sample of Geofence in a public area. Best part? Since it is on a virtual map, having a virtual fence would have no effect on whether you own the area. This area could be your Home, Office, favorite Coffee Shop, or even parlor.

But before we get started -</translate>
|Step_Picture_00=Virtual_Fence_-_Anti_Theft_Device_Fence.png
}}
{{Tuto Step
|Step_Title=<translate>Get PCBs for Your Projects Manufactured</translate>
|Step_Content=<translate>You must check out [https://www.pcbway.com/ PCBWAY fo]r ordering PCBs online for cheap!


You get 10 good-quality PCBs manufactured and shipped to your doorstep for  cheap. You will also get a discount on shipping on your first order.  Upload your Gerber files onto [https://www.pcbway.com/ PCBWAY to] get them manufactured with good quality and quick turnaround time.  PCBWay now could provide a complete product solution, from design to  enclosure production. Check out their online Gerber viewer function.  With reward points, you can get free stuff from their gift shop.</translate>
|Step_Picture_00=Qubitro_Device_Data_-_IoT_Platform_Series_image_3JJb6iqRSm.jpeg
}}
{{Tuto Step
|Step_Title=<translate>Cellular + GPS</translate>
|Step_Content=<translate>To be able to have global connectivity and uninterrupted internet, the ideal network protocol is cellular technology. With a GPS Module attached to it, it is just perfect.


This amazing combination can only be carried by an integrated device. And at the cheapest, we considered '''SIM808 Module''' '''+''' '''GPS''' as the primary module to continue with this project. Let us look more into its features and specifications -



'''SIM808 GSM :'''

* Supports Quad-band 850/900/1800/1900MHz, compatible with all 2G networks all around the world.
* Inner MT3337 GPS receiver, -165dBm precision, control on a same serial port.
* Earphone/ microphone outputs on a card or external 32-ohm speaker + supports voice calls with an electret microphone.
* Sending and receiving SMS.
* Sending and receiving GPRS data (TCP/IP, HTTP vb).
* UART communication with automatic baud rate settings.
* GPRS multi-slot class 12/10
* GPRS mobile station class B
* Comply with GSM phase 2/2 + Class 4 (2 W @ 850 / 900MHz) Class 1 (1 W @ 1800 / 1900MHz)
* Support low power consumption mode: 100mA @ 7V-GSM mode
* Support AT command control (3GPP TS 27.007,27.005 and SIMCOM enhanced AT Commands)
* Supports GPS satellite navigation technology
* Support LED status indicator: Power supply status, network status, and operating modes
* Working environment: -40 ℃ ~ 85 ℃


'''SIM808 GPS :'''

* 22 tracking/66 acquisition channel
* GPS L1 C/A code
* Precision: Tracking: -165dBm,
* Cold start: -148dBm
* Finding Location Time(typical): Cold start: 32sn, Hot start: 1sn, Warm start: 5sn
* Accuracy: ~2.5m


With all these features, it is nearly a handheld portable phone. ''Yes, you can make a phone call too :P''


One grieving concern is, whether going ahead with a smaller size module would fit the portability requirements - Even if a SIM800 module was taken into consideration, for a prolonged secure network that requires more uptime it is a much safer option to go ahead with its successor. Hence, the SIM808 module was chosen for this project. Even though based on availability and price we can always go ahead with the SIM800.

Let us first understand the module and how to get started with a SIM module -


'''Prologue:'''


We'll use Arduino UNO to use it as a USB TTL device and send AT commands to SIM808 x module to test the working of the module using PUTTY or Arduino IDE’s Serial Monitor.</translate>
|Step_Picture_00=Virtual_Fence_-_Anti_Theft_Device_SIM808_GPS.png
|Step_Picture_01=Virtual_Fence_-_Anti_Theft_Device_SIM808_pinout.jpg
}}
{{Tuto Step
|Step_Title=<translate>Hardware Side -</translate>
|Step_Content=<translate>1. Make following connections > GND of both modules connected to each other.

2. (For PuTTY) TXD of SIM808 connect with TX1 (PIN 1) of Arduino UNO. Similarly RXD ->RX0.

3. (For Arduino) TXD of SIM808 connect with (PIN 10) of Arduino UNO. Similarly RXD ->11.

4. Connect the Arduino UNO to Arduino IDE and upload a default code that does not interface the serial monitor. Eg: Blink LED sketch.

5. Press Normal button for 2 seconds and leave - the Device will start after that. (Different from power sliding switch)</translate>
}}
{{Tuto Step
|Step_Title=<translate>Software side (PuTTy) -</translate>
|Step_Content=<translate>1. Install PuTTY Application software from https://www.putty.org/

2. Change 'Connection Type' to 'Serial'.

3. Enter Serial port on PuTTY. eg: COM8 > With baudrate as '9600'.

4. Click on 'Open' to open the serial terminal</translate>
}}
{{Tuto Step
|Step_Title=<translate>Software side (Arduino IDE) -</translate>
|Step_Content=<translate>1. Use the below code -

<br />
 <code>#include <SoftwareSerial.h></code>

 <code>SoftwareSerial mySerial(10, 11);</code> 

 <code>void setup() {</code>  

     <code>Serial.begin(9600);</code>  

     <code>mySerial.begin(9600);</code>

 <code>}</code>

 <code>void loop() {</code>  

     <code>Serial.println("AT");</code>  

     <code>if (mySerial.available()) {</code>	

         <code>Serial.write(mySerial.read());</code>  

     <code>}</code>  

     <code>if (Serial.available()) {</code>	

         <code>mySerial.write(Serial.read());</code>  

     <code>}</code>  

     <code>delay(500);</code>

 <code>}</code></translate>
}}
{{Tuto Step
|Step_Title=<translate>Testing Commands -</translate>
|Step_Content=<nowiki><translate>* </nowiki>'''AT''' - Check serial communication with module
}}
{{Tuto Step
|Step_Title=<translate>Code Breakdown</translate>
|Step_Content=<translate>'''1. Communication between Arduino & SIM808'''
 <code>#include <SoftwareSerial.h></code>
 <code>SoftwareSerial mySerial(5, 6); </code>
It sets up a SoftwareSerial instance named <code>mySerial</code> using digital pins 5 (RX) and 6 (TX) on the Arduino, which will be used to communicate with the SIM808 module.


'''2. Function Prototypes and Global Variables'''
 <code>void(* resetFunc) (void) = 0;</code>
 <code>void GPS_data();</code>
 <code>void check_GPS();</code>
 <code>void sendSMS();</code>
 <code>char frame[256];</code>
 <code>byte GNSSrunstatus;  </code>
 <code>byte Fixstatus;           </code>
 <code>char UTCdatetime[15];</code>
 <code>char latitude[10];</code>
 <code>float latitude_val;</code>
 <code>char longitude[11];</code>
 <code>float longitude_val;</code>
 <code>long lat_val;</code>
 <code>long lon_val;</code>
 <code>long lat_high;</code>
 <code>long lat_low;</code>
 <code>long lon_high;</code>
 <code>long lon_low;</code>
 <code>int lat_check;</code>
 <code>int lon_check;</code>
 <code>char altitude[8];</code>
 <code>char speedOTG[6];</code>
 <code>char course[6];</code>
 <code>char fixmode[1];</code>
 <code>char HDOP[4];</code>
 <code>char PDOP[4];</code>
 <code>char VDOP[4];</code>
 <code>char satellitesinview[2];</code>
 <code>char GNSSsatellitesused[2];</code>
 <code>char GLONASSsatellitesused[2];</code>
 <code>char cn0max[2];</code>
 <code>char HPA[6];</code>
 <code>char VPA[6];</code>

* Pre-declaration of Functions without function body, to inform the program about the existence of function, before defining, so as to manipulate the arrangement within the program.
* Global variables like altitude, speedOTG are to be used within the program, and since the device will run indefinitely, the values are most likely to get reset on setting up new locations as Geo-Fencing


'''3. Initialization of Arduino with Cellular Device'''
 <code>void setup() {</code>
   <code>Serial.begin(9600);</code>
   <code>mySerial.begin(9600);</code>
   <code>mySerial.println("AT\r"); </code>
   <code>updateSerial();</code>
   <code>mySerial.println("AT+CSQ"); </code>
   <code>updateSerial();</code>
   <code>mySerial.println("AT+CCID"); </code>
   <code>updateSerial();</code>
   <code>mySerial.println("AT+CPIN?"); </code>
   <code>updateSerial();</code>
   <code>GPS_data(); </code>
   
   <code>lat_high = lat_val + 900;</code>
   <code>lat_low = lat_val - 900;</code>
   <code>lon_high = lon_val + 900;</code>
   <code>lon_low = lon_val - 900;</code>
 <code>}</code>

* '''AT+CSQ''' '''-''' Returns the signal strength of the device.
* '''AT+CCID''' - Read SIM information, which returns the unique Integrated Circuit Card Identifier (ICCID) of the installed SIM card.
* '''AT+CPIN''' - Checks if the SIM is locked with a PUK code, or whether it is ready to use.
* Calling '''GPS_data()''' function to initialize the current location, as the center of the Geo-Fence
* Next, set the fence around the center by selecting coordinates values with  300m-500m towards lat and long.


'''4. Hardware''' '''-''' '''Software Serial Interconnection'''
 <code>void updateSerial()</code>
 <code>{</code>
   <code>delay(500);</code>
   <code>while (Serial.available()) </code>
     <code>mySerial.write(Serial.read());</code>
   <code>}</code>
   <code>while(mySerial.available()) </code>
   <code>{</code>
     <code>Serial.write(mySerial.read());</code>
   <code>}</code>
 <code>}</code>
<br />

* '''mySerial.write(Serial.read())''' : Forwards from Hardware Serial to Software Serial
* '''Serial.write(mySerial.read())''' : Forwards from Software Serial received to Serial Port

'''5. GPS Module Initialization'''
 <code>void GPS_data(){</code>
   <code>mySerial.println("AT+CGNSPWR=1");</code>
   <code>updateSerial();</code>
   <code>mySerial.println("AT+CGNSSEQ=\"RMC\"");</code>
   <code>updateSerial();</code>
   <code>mySerial.println("AT+CGNSINF");</code>
   <code>check_GPS();</code>
 <code>}</code>

* '''AT+CGNSPWR''' '''=''' '''1''' ''':''' Turns ON the SIMCOM module
* '''AT+CGNSSEQ=RMC :''' Configure the GPS module for settings ('''RMC - Time, date, position, course and speed data)'''
* '''AT+CGNSINF :''' GNSS navigation information parsed from NMEA sentences

Next, let us call check_GPS() function to update the current GPS data.


'''6. Update GPS Data'''
 <code>void check_GPS(){</code>
   <code>...</code>
 <code>}</code>
This function includes the main section of the whole project, which requests for the current GPS location, and then checks whether it is within the Geo Fence limits. Let us break down the code even further!


'''7. Initialization of Local Variables for GPS'''
 <code>int8_t counter, answer;</code>
   <code>long previous;</code>
   <code>counter = 0;</code>
   <code>answer = 0;</code>
   <code>memset(frame, '\0', sizeof(frame));    </code>
   <code>previous = millis();</code>

* <code>int8_t counter, answer;</code>: Two variables to keep track of loop iterations and whether the expected response is received.
* <code>long previous;</code>: Holds the previous time value for timeout calculation.
* <code>previous = millis();</code> : Initialize current time in milliseconds.
* <code>char frame[256];</code>: An array to store received characters for constructing the response frame.

 <code>void *memset(void *str, int c, size_t n)</code>

* '''str −''' This is a pointer to the block of memory to fill.
* '''c −''' This is the value to be set. The value is passed as an int, but the function fills the block of memory using the unsigned char conversion of this value.
* '''n −''' This is the number of bytes to be set to the value.
* '''memset''' function returns a pointer to the memory area str.

'''8. Check for Response on UART'''
 <code>do {</code>
     <code>if (mySerial.available() != 0) {</code>
       <code>frame[counter] = mySerial.read();</code>
       <code>counter++;</code>
       <code>if (strstr(frame, "OK") != NULL)</code>
       <code>{</code>
         <code>answer = 1;</code>
       <code>}</code>
     <code>}</code>
     
 <code>}</code>
 <code>while ((answer == 0) && ((millis() - previous) < 2000));</code>
This code repeatedly reads characters from the '''mySerial''' interface to construct a response frame. It checks if the response contains "'''OK'''" to set the answer flag. The loop continues until either "'''OK'''" is found or a '''timeout of 2000 milliseconds''' is reached. This ensures the program waits for the expected response before proceeding.


'''9. Parse the String for GPS data'''
 <code>frame[counter - 3] = '\0';</code>
   <code>strtok(frame, ": ");</code>
   <code>GNSSrunstatus = atoi(strtok(NULL, ","));</code>
   <code>Fixstatus = atoi(strtok(NULL, ",")); </code>
   <code>strcpy(UTCdatetime, strtok(NULL, ".")); </code>
   <code>strtok(NULL,",");  </code>
   <code>strcpy(latitude, strtok(NULL, ","));  </code>
   <code>strcpy(longitude, strtok(NULL, ",")); </code>
   <code>strcpy(altitude, strtok(NULL, ","));</code>

* '''frame[counter - 3] = '\0';''': Terminate the response frame at a specific index.
* '''strtok(frame, ": ");''': Tokenize the frame using colons and spaces as delimiters.
* '''GNSSrunstatus = atoi(strtok(NULL, ","));''': Get GNSS run status as an integer.
* '''Fixstatus = atoi(strtok(NULL, ","));''': Get fix status as an integer.
* '''strcpy(UTCdatetime, strtok(NULL, "."));''': Copy UTC date and time.
* '''strtok(NULL, ",")''';: Skip irrelevant tokens.
* '''strcpy(latitude, strtok(NULL, ","));''': Copy latitude.
* '''strcpy(longitude, strtok(NULL, ","));''': Copy longitude.
* '''strcpy(altitude, strtok(NULL, ","));''': Copy MSL altitude.

This code takes the string data in theframe and then copies it to the variables like GNSSrunstatus, Fixstatus, UTCdatetime, lat, long & altitude.

* <code>'''byte GNSSrunstatus, Fixstatus;'''</code>: Byte variables to store GNSS run status and fix status.
* <code>'''char UTCdatetime[15];'''</code>: A character array to store UTC date and time.
* <code>'''char latitude[10], longitude[11], altitude[8];'''</code>: Character arrays to store latitude, longitude, and altitude data.

'''10. Print & Store the Data in the MESSAGE String'''
 <code>if (Fixstatus != 0){</code>
       <code>Serial.println("GPS Data received");</code>
       
       <code>Serial.print("Runstatus: ");</code>
       <code>Serial.println(GNSSrunstatus);</code>
       <code>Serial.print("Fixstatus: ");</code>
       <code>Serial.println(Fixstatus);</code>
       <code>Serial.print("UTCdatetime: ");</code>
       <code>Serial.println(UTCdatetime);</code>
       <code>Serial.print("latitude: ");</code>
       <code>Serial.println(latitude);</code>
       <code>Serial.print("longitude: ");</code>
       <code>Serial.println(longitude);</code>
       <code>Serial.print("altitude: ");</code>
       <code>Serial.println(altitude);</code>
       <code>latitude_val = atof(latitude);</code>
       <code>lat_val = latitude_val*1000000;  </code>
       <code>Serial.println(lat_val); </code>
       
       <code>longitude_val = atof(longitude);</code>
       <code>lon_val = longitude_val*1000000;</code>
       <code>Serial.println(lat_high);</code>
 <code>.</code>
 <code>.</code>
 <code>.</code>
If Fixstatus does not return '0', it means we have the complete GPS data. And so it can be further used according to our project.



'''11. Setting the SafeHouse and Alert Logic'''
 <code>if (lat_high == 0){</code>
         <code>sprintf(MESSAGE, "Latitude : %s\nLongitude : %s\nAltitude : %s km\n\nInitial Position of the Module\n\nhttp://maps.google.com/maps?q=%s,%s\n", latitude, longitude, altitude, latitude, longitude);</code>
         <code>sendSMS();</code>
         
       <code>}</code>
       <code>else{</code>
         <code>lat_check = inRange(lat_val, lat_high, lat_low);</code>
         <code>lon_check = inRange(lon_val, lon_high, lon_low);</code>
         <code>Serial.print(lat_check);</code>
         <code>Serial.println(lon_check);</code>
         <code>if (!(lat_check)){  </code>
           <code>sprintf(MESSAGE, "Latitude : %s\nLongitude : %s\nAltitude : %s km\n\nALERT!! Module is outside the GeoFence\n\nhttp://maps.google.com/maps?q=%s,%s\n", latitude, longitude, altitude, latitude, longitude);</code>
           <code>sendSMS();</code>
         <code>}</code>
       <code>}</code>
 <code>}</code>
 <code>else if ((Fixstatus == 0) && (lat_high == 0)){</code>
       <code>Serial.println("Resetting Arduino to check GPS data");</code>
       <code>delay(5000);</code>
       <code>resetFunc();</code>
     <code>}</code>
 <code>}</code>

* If lat_high=0, or a value exists in it, using sprintf() function, we are storing it in the global variable MESSAGE.
* This MESSAGE is different for the initial positioning (SafeHouse), & Alerting in case the data is received.
* In case, the Fixstatus is again 0 during execution, reset the Arduino to start fresh the connection

'''12. Send GPS''' '''data to Another SIM''' '''number'''
 <code>void sendSMS()</code>
 <code>{</code>
   <code>Serial.println("Start to send message ...");  </code>
   <code>Serial.println(MESSAGE);</code>
   <code>Serial.println(phone);</code>
   <code>mySerial.println("AT+CSMP=17,167,0,0");</code>
   <code>updateSerial();</code>
   <code>mySerial.println("AT+CMGF=1"); </code>
   <code>updateSerial();</code>
   <code>String sim_sms = "AT+CMGS=\"" + phone + "\"\r";</code>
   <code>mySerial.println(sim_sms); </code>
   <code>updateSerial();</code>
   <code>mySerial.print(MESSAGE);      </code>
   <code>delay(500);</code>
   <code>mySerial.print((char)26);</code>
   <code>Serial.println("Check SMS");</code>
 <code>}</code>

* '''AT+CSMP=17,167,0,0;''': This line sends the AT command "AT+CSMP=17,167,0,0" to the SIM808 module. It's used for setting SMS parameters.
* '''AT+CMGF=1;''': This line sends the AT command "AT+CMGF=1" to the SIM808 module. It sets the SMS mode to text mode.
* String sim_sms = "'''AT+CMGS=\'''"" + phone + "\"\r";: This line creates a string sim_sms that represents the AT command "AT+CMGS=" followed by the recipient's phone number enclosed in double quotes and terminated with a carriage return.
* '''sim_sms''': This line sends the sim_sms command to the SIM808 module. It initiates sending an SMS to the specified phone number.

That's it! Now that we have shared the GPS data using SMS to the specified number, it is in fact a great method to safeguard your belongings!</translate>
}}
{{Tuto Step
|Step_Title=<translate>Working</translate>
|Step_Content=<translate>Let us make the connections between Arduino - SIM808 - GPS Module

'''Initial Position -''' After we flash the code to the Arduino, the code sends the initial location of the GPS while creating a Geo-Fence around the center of the location.


'''''SMS Message'''''
 <code>Latitude : 23.009152</code>
 <code>Longitude : 50.252952</code>
 <code>Altitude : 86.200 km</code>
 <code>Initial Position of the Module</code>
 <code><nowiki>http://maps.google.com/maps?q=23.009152,50.252952</nowiki></code>
The device keeps checking its location on a loop, indefinitely Till the time the device is within half a kilometer (500m) of the above location, the device is considered within the safe house.


'''Geo-Fence Breach''' - The moment, the device moves out of the GeoFence, the device detects it as an alert and sends an SMS immediately.


''SMS Message''
 <code>Latitude : 24.008693</code>
 <code>Longitude : 51.253190</code>
 <code>Altitude : 85.000 km</code>
 <code>ALERT!! Module is outside the GeoFence</code>
 <code><nowiki>http://maps.google.com/maps?q=24.008693,51.253190</nowiki></code>


'''Congratulations! You will''' '''be now able to build your own device to GeoFence. We hope that this tutorial has provided you with the information you need to build''' '''and learn throughout.'''


'''If you have any questions or need further assistance, please let''' '''me know in the comments!'''</translate>
}}
{{Notes
|Notes=<translate></translate>
}}
{{PageLang
|Language=en
|SourceLanguage=none
|IsTranslation=0
}}
{{Tuto Status
|Complete=Draft
}}