This project is licensed under the MIT License - see the LICENSE file for details.
-
Tonnes of e-waste being generated in the form of phones: The rapid advancement of technology and consumer demand for new devices contribute to the massive generation of electronic waste (e-waste). E-waste poses environmental challenges due to hazardous materials contained in electronic devices. By repurposing old phones as anti-theft devices, we can give them a second life and reduce the amount of e-waste sent to landfills. This approach aligns with the principles of sustainability and responsible consumption, promoting the reuse of existing resources.
-
UCSD's bike theft problem: Bike theft has become a significant issue on the UC San Diego (UCSD) campus, with a noticeable increase in recent years. Bike theft not only leads to financial loss for individuals but also disrupts campus life and affects the overall safety and security of the campus community. By utilizing old phones as anti-theft devices, we can develop a cost-effective solution to address this problem. These devices can serve as effective deterrents and help track stolen bikes, increasing the chances of recovery and discouraging potential thieves. Implementing such a solution demonstrates a commitment to improving campus security and enhancing the overall experience for students, faculty, and staff at UCSD.
Our research is focused on creating a highly effective anti-theft system for bicycles that leverages the advanced capabilities of old smartphones. The system operates in two modes: locked and unlocked. In unlocked mode, the user has complete freedom to use their bike without any limitations or notifications. However, when the user engages the lock mode, the smartphone device, equipped with sensors such as GPS and accelerometers, will begin monitoring the bike's location and movements. If the system detects any unauthorized movement, such as a thief attempting to steal the bike, a loud alarm will sound to alert nearby people. Simultaneously, the system will send a notification to the user's phone indicating the theft attempt and providing GPS coordinates of the bike's location. This will enable the user to contact the authorities and recover their stolen bike.
- Gagan Gopalaiah
- Akshay Prabhu
- Grishma Gurbani
Wiki Page on Milestone Progress
Slides of Final Oral Presentation
The repository is organized as follows:
./js : Contains the code for the main bike application.
./aws: Includes the AWS Lambdas (serverless functions) responsible for sending emails and registering email identity.
./backend: Contains the backend Node.js server used as a middleware.
./sounds: Hosts the audio files that are played when motion is detected.
./out: Stores the files generated by JSDocs.
./index.html: Serves as the entry point for the bike application.
The frontend is currently hosted on GitHub Pages. To replicate the deployment process:
- Fork this repository.
- Navigate to the repository's settings.
- Under the "Pages" section, select the option to deploy from a specific branch.
- Choose the branch you want to deploy and save the settings.
-
Lambda Deployment -
- Go to the AWS Lambda dashboard and select "Create function".
- Choose the "Author from scratch" option and specify the necessary specifications.
- Copy and paste the code from the
lambda_email.pyfile (located inside the ./aws folder) into the code source window and save it. - Repeat the above steps for the
lambda_email_identity.pycode.
-
Middleware Deployment -
- The middleware code can be found in the
server.jsfile located in the ./backend folder. - Clone the repository and follow these steps to run the Node.js server:
- Run
npm installto install the necessary dependencies. - Run
node server.jsto start the server. - For improved security and best practices, consider setting up an Nginx or Apache reverse proxy server in front of the Node.js server and configure an SSL certificate for HTTPS support.
- The middleware code can be found in the
By following these steps, you can successfully deploy the frontend and backend components of the application.
- Prequisite -
-
- Make a curl request to the AWS Lambda function
lambda_email_identity.pyto register the email address you want to use to receive notifications. The request should be of the form:
- Make a curl request to the AWS Lambda function
curl --location --request POST 'https://igqz8n9d94.execute-api.us-west-1.amazonaws.com/dev/identity' \ --header 'Content-Type: application/json' \ --data-raw '{ "email_identity": "<email>" }'- This will send an email to the specified email address. Click on the link in the email to verify your email address.
-
- Open the client application on your phone. (repo found here)
- Enter your email address and click on the "Register" button.
- Open the bike application on your phone.
- You can control the state of the application from the client application by toggling between lock and unlock modes.
- Set the application to lock mode and place/strap the phone to the bike. On detecting motion, the application will play a loud alarm sound and send an email notification to the user's email address.
We have used JSDoc comments to document our project. We used these comments to provide clear explanations and descriptions for variables, functions, and middleware. These comments serve as a useful reference for the team members to understand the purpose and functionality of different sections of the code, making it easier for us to maintain and collaborate on the project.
TBA: To be added by 6/12/2023
- Conversion to a native application
- Upgrading the location coordinates with Google Maps integration
- Multiple bike tracking through a single application
- Integration with Bike Accessories
- Analytics and Reporting