The GPS Distance Tracking System is an embedded system developed using the TM4C123G LaunchPad. It allows users to track the distance they travel between two points using GPS coordinates. The system provides visual feedback to the user through built-in LEDs, indicating when they are close to their destination or have reached it.
- Description
- Features
- Installation
- Usage
- Requirements
- Contributing
- License
- Credits
- Team Members
- Baseline Path
The GPS Distance Tracking System is a project developed as part of the CSE 211 course at the Computer and Systems Engineering Department, Faculty of Engineering, during the Fall 2023 semester. The main objective of the project is to create an embedded system that accurately tracks the distance a user travels between two points using GPS coordinates. The system is implemented on the TM4C123G LaunchPad and provides real-time visual feedback to the user through LEDs.
The GPS subsystem performs the following tasks:
- Stores the coordinates of the starting point.
- Stores the coordinates of the end point and calculates the total distance traveled by the user.
- Provides visual feedback to the user using built-in LEDs:
- Stage 1: Green LED turns on when the target destination is reached.
- Stage 2: Yellow LED turns on when the target destination is about to be reached (less than 5 meters away).
- Stage 3: Red LED turns on when the target destination is far away (more than 5 meters).
The trajectory of the distance traveled satisfies the following criteria:
- The total distance between the start and end points should be greater than 100 meters.
- The path from the start point to the end point should form a non-straight line similar to the provided baseline path.
The system calculates the distance between the starting point and the end point and compares it with the distance obtained from Google Maps. The error margin should be less than or equal to 5%.
To use the GPS Distance Tracking System, follow these steps:
-
Clone the repository to your local machine:
https://github.com/OrcaLinux/GPS-Distance-Tracking-System.git
-
Connect the TM4C123G LaunchPad to a GPS module and configure it to receive GPS coordinates.
-
Open the project in Code Composer Studio (CMake is also required for building).
To use the GPS Distance Tracking System, follow these steps:
-
Power on the GPS Distance Tracking System.
-
Select any starting point on Google Maps and mark it as the starting location.
-
Walk or travel to the destination point.
-
The system will provide visual feedback through the built-in LEDs as follows:
- Green LED: Target destination reached.
- Yellow LED: Target destination about to be reached (less than 5 meters away).
- Red LED: Target destination is far away (more than 5 meters).
-
Ensure that the calculated distance is within an error margin of 5% compared to Google Maps.
To successfully run the GPS Distance Tracking System, you will need the following:
- TM4C123G LaunchPad
- GPS Module
- Code Composer Studio (CCS) or CMake for building
- UART configuration for GPS module communication
Contributions to the GPS Distance Tracking System project are welcome. To contribute, follow these steps:
-
Fork the repository.
-
Create a new branch for your feature or bug fix.
-
Make your changes and commit them with a detailed description.
-
Push to the branch and create a pull request on GitHub.
This project is licensed under the GPL-3.0 LICENSE.
This project was developed by Team Work as part of Introduction to Embedded Systems/GPS Tracking System. Special thanks to the faculty and staff at the Computer and Systems Engineering Department, Faculty of Engineering, for their support and guidance throughout the project.
Our project is proudly developed and maintained by the following team members:
- Mahmoud Abdelraouf
- Mahmoud Hamdy
- Mennatallah Abdel-Motaleb
- Mohamed Adham
- Mohamed Khaled
- Muhammad AbdelKhaleq
- Nada Mohamed
- Sara Ashraf
- Somay Ayman
- Maya Sharaf
The baseline path that should be followed for the GPS Distance Tracking System is shown below:
