Link Search Menu Expand Document

Location Tagged SOS Application on SAM D21 Curiosity Nano and Nano Base for Click boards

Download

Description:

The application demonstrates the solution based on Microchip products in a personal emergency or to communicate a distress signal by sending out a location-tagged SOS SMS. The Mikroelektronika GSM-GPS click board, used in this application, contains a hardware module that combines the GSM/GPRS and GPS functionality used to track the device and send out the emergency or distress signal. The MCU is interfaced with the GPS module over the UART interface to perform the GPS coordinates’ acquisition and tracking. It registers the event callbacks for location tracking of the GPS receiver.

The application arranges the GSM/GPRS module for sending SMS to a configured mobile phone number. Once the GPS position is available, the application sends the following location-tagged SOS SMS to the configured mobile phone number when the emergency switch is pressed..

SAM D21 Curiosity Nano Location tagged SOS.
Please attend emergency at:
Latitude : xx.xxxxxx
Longitude : xx.xxxxxx
Altitude : xx.xxxxxx

Modules/Technology Used:

  • Peripheral Modules
    • Timer
    • EIC
    • NVM
  • Driver Modules
    • USART Driver
  • STDIO Library

Hardware Used:

Software/Tools Used:

This project has been verified to work with the following versions of software tools:

Refer Project Manifest present in harmony-manifest-success.yml under the project folder firmware/src/config/default

Because Microchip regularly update tools, occasionally issue(s) could be discovered while using the newer versions of the tools. If the project doesn’t seem to work and version incompatibility is suspected, It is recommended to double-check and use the same versions that the project was tested with. To download original version of MPLAB Harmony v3 packages, refer to document How to Use the MPLAB Harmony v3 Project Manifest Feature

Setup 1: Uses Separate power supplies for SAMD21 Curiosity Nano and GSM-GPS Click

  • Mount SAM D21 Curiosity Nano Evaluation Kit on “CNANO56_HOST_CONN”(U3) connector of Curiosity Nano Base board
  • Mount GSM-GPS click board on mikro bus click 1 connector of Curiosity Nano Base and connect the GPS and GSM antennas on GSM-GPS click board connectors
  • Power the SAM D21 Curiosity Nano Evaluation Kit from a Host PC through a Type-A male to Micro-B USB cable connected to Micro-B port (J105)
  • Wait for about 60 seconds
  • Power the GSM-GPS click board from a Host PC through a Type-A male to Micro-B USB cable connected to Micro-B port of GSM-GPS click

Setup 2: Uses Li-ion battery

  • Mount SAM D21 Curiosity Nano Evaluation Kit on “CNANO56_HOST_CONN”(U3) connector of Curiosity Nano Base board.
  • Mount GSM-GPS click board on mikro bus click 1 connector of Curiosity Nano Base and connect the GPS and GSM antennas on GSM-GPS click board connectors.
  • Connect Li-ion or Lipo Battery on J1 connector and make sure SW1 slider switch is moved to Battery on position in Curiosity Nano Base board.
  • Power the SAM D21 Curiosity Nano Evaluation Kit from a Host PC through a Type-A male to Micro-B USB cable connected to Micro-B port (J105).

Programming hex file:

The pre-built hex file can be programmed by following the below steps.

Steps to program the hex file

  • Open MPLAB X IDE
  • Close all existing projects in IDE, if any project is opened.
  • Go to File -> Import -> Hex/ELF File
  • In the “Import Image File” window, Step 1 - Create Prebuilt Project, Click the “Browse” button to select the prebuilt hex file.
  • Select Device has “ATSAMD21G17D”
  • Ensure the proper tool is selected under “Hardware Tool”
  • Click on Next button
  • In the “Import Image File” window, Step 2 - Select Project Name and Folder, select appropriate project name and folder
  • Click on Finish button
  • In MPLAB X IDE, click on “Make and Program Device” Button. The device gets programmed in sometime
  • Follow the steps in “Running the Demo” section below

Configure Mobile Phone Number:

  • Open the project (location_sos\firmware\sam_d21_cnano.X) in MPLAB X IDE

  • Open header file loc_sos_update_task.h

  • Define the macro to your mobile phone number preceded by country code.
    For example, Below is the macro definition to configure an Indian mobile phone number “1234567890”

    Note: “+91” is the country code for India in the above screenshot and “1234567890” is a dummy phone number.

Programming/Debugging Application Project:

  • Open the project (location_sos\firmware\sam_d21_cnano.X) in MPLAB X IDE
  • Ensure “SAM D21 Curiosity Nano” is selected as hardware tool to program/debug the application
  • Build the code and program the device by clicking on the “make and program” button in MPLAB X IDE tool bar
  • Follow the steps in “Running the Demo” section below

Running the Demo:

  • Open Tera Term, connect to serial console. If there is any connection issue on tera terminal, unplug the USB cable connected to Micro-B port and reconnect it back
  • Change the baud rate to 115200
  • Perform a reset by unplugging the power cable of SAM D21 Curiosity Nano
  • After power up, The LEDs on GSM-GPS click boards gives the following indications:
    • LED marked STA is on; this indicates the GSM module is switching on
    • LED marked TXA is blinking, this indicates the GPS acquisition and position data is exchanged by the receiver
    • LED marked PPS is off. The PPS LED indicates pulse-per-second signal for precise timing. It glows on, after successful positioning
  • After one minute, the GPS achieves successful position as indicated by the blinking of LED PPS.

    Note:

  • The GPS on the GSM-GPS click has a one second Time-To-First-Fix (TTFF) from a hot start and 30 seconds from cold start
  • If the position is not achieved after 1 minute, then:
    • It could be because of non-availability of GPS signals. Make sure that you have placed the GPS antenna such that it can receive the signals from the GPS satellites. Try placing it under the open sky to be able to receive signals
    • After using the option above, if the device is still not receiving the position indication, try resetting the board by unplugging the power cable of SAM D21 Curiosity Nano board and turn off and turn on the battery supply by sliding SW1 switch on Curiosity Nano Base or unplug the power cable of GSM-GPS Click board
  • Once the GPS position is achieved, user can press switch SW0 on SAM D21 Curiosity Nano board to send SMS to configured mobile number with GPS location.
  • GSM module sends below message to configured mobile number SAM D21 Curiosity Nano Location tagged SOS
    Please attend emergency at:
    Latitude : xx.xxxxxx
    Longitude : xx.xxxxxx
    Altitude : xx.xxxxxx
    http://maps.google.com/maps?q=loc:xx.xxxxxx(Latitude),xx.xxxxxx(Longitude)
  • User can change the mobile number by long pressing (more than 4 seconds) switch SW0 on SAM D21 Curiosity Nano board. An option will be displayed on serial terminal to update the cell phone number
  • Updated cell phone number is stored in NVM memory, updated number will be used further to send SMS, even after power reset
  • If GPS position is not achieved, short pressing SW0 on SAM D21 Curiosity Nano board sends a blank SMS without GPS location.

Comments:

Revision:

  • v1.6.0 - Regenerated and tested the application
  • v1.5.0 Removed MHC support, Regenerated and tested application.
  • v1.4.0 - Updated demo application to use click routines
  • v1.3.0 - Regenerated and tested application.
  • v1.2.0 - Regenerated and tested application.
  • v1.1.0 regenerated and tested the demo application
  • v1.0.0 released demo application


Copyright © 2020 Microchip Technology.