BikeLightFinal

Smart Bike Light 🚲💡

This project is a smart, battery-powered bike light system developed as part of the DTU course 34346 – Networking Technologies and Application Development for IoT. It enhances bike safety and theft deterrence through live GPS tracking, narrowband NB-IoT communication, and LEDs that activate based on motion and ambient light. The system integrates with mobile and web apps for remote control and monitoring.

🚀 Getting Started

Follow these steps to set up and run the project:

1. Clone this repo.
2. Install required tools: ESP32 toolchain, KiCad, Xcode, Azure CLI, SolidWorks (for 3D parts).
3. Flash the firmware from the firmware folder to the ESP32.
4. Assemble the hardware using the schematic in the KiCad folder, or generate Gerber files and order the PCB.
5. 3D print the bikelight using the files inside the Solidworkds folder.
6. Clone the backend repo and deploy all the functions to Azure.
7. Clone either the iOS app or the web app.
8. Hold the bike light button for 5 seconds to pair it VIA Ble.
9. Your bike light should now be working.

📦 Main Repo (This)

This repo contains:

• Firmware for the ESP32 (firmware folder)
• Custom PCB design files and schematic (Kicad_Schematic_PCB)
• Communication code for NB IoT click and GPS module only (for testing purposes)
• Code for testing the different electronic components (Electronics)
• Documentation and reports
• 3D-printed enclosure files

📱 iOS App Repo

The iOS app allows users to:

• Pair their bike light via BLE
• Check battery and location status
• Switch modes remotely

The iOS Application can be found in the following repository: 👉 iOS App Github Repo

🌐 Web App

The web app provides:

• Authentication and device association
• Dashboard to view status, GPS, and change modes

☁️ Azure Backend Repo

• Handles MQTT data via NB-IoT
• Stores info in CosmosDB
• Provides API endpoints to mobile/web apps

Both the web app and backend code are in the same repository: 👉 Web App and Azure GitLab Repo

For documentation on how to use the different azure functions look in 📎 Azure_API_Documentation.pdf

🔧 Features

• Automatic light control based on motion
• BLE for user pairing
• NB-IoT for real-time narrowband IoT communication
• GPS tracking
• Multi-mode power states: Active, Parked, Storage
• 3D-printed, splash-resistant enclosure

⚙️ Hardware

• ESP32
• NB-IoT 2 Click module
• NEO-7N GPS
• Battery monitor
• Accelerometer + LDR
• Rechargeable Li-ion battery
• Custom PCB and 3D case

📄 Project Report

See full technical details in the report:
📎 BikeLight_project_report_2.pdf

---

This is a student project and not intended for production deployment.

🤝 Contributors

• Thomas Møller Pedersen s224442
• Tomas Ruiz Aybar s242887
• Albert Saez Nunez s250445
• Isabella Martınez Lopez s241889
• Eric Santiso Robledo s250444
• Matteo Italia s232440