Skip to content

ishpreet404/aidlink

Repository files navigation

AidLink: Radio Location Beacon with Live Map & APRS Integration

AidLink is a smart, portable communication beacon designed for emergency and disaster scenarios where traditional communication networks are unavailable. It uses LoRa technology and Morse code to transmit GPS coordinates and personal details of individuals in distress. Now integrated with APRS.fi, AidLink offers global tracking capabilities, ensuring maximum visibility during rescue missions.


❗ Problem

In disaster-hit or remote areas, reliable communication infrastructure is often unavailable. This severely hinders search-and-rescue efforts, as conventional tools like mobile phones and radios suffer from limited range, power inefficiency, and dependency on networks. Delayed location tracking increases risk and reduces the survival chances of individuals in distress.


βœ… Solution

AidLink bridges this critical communication gap by offering:

  • Network-independent communication using LoRa and Morse code
  • Real-time GPS data transmission
  • Live map tracking via a web interface
  • Global availability by uploading coordinates to APRS.fi
  • Energy-efficient, compact hardware for extended emergency use

This dual-channel, redundant system ensures that distress signals are receivedβ€”even in the harshest conditionsβ€”dramatically increasing the likelihood of a successful and timely rescue.


🌐 Website Overview

The AidLink web interface displays live GPS data transmitted from the Arduino-based beacon. Data updates every 2 seconds and is visualized on a live map.

Features:

  • Real-time updates from arduino_data.json
  • Full log of incoming data
  • Live map with marker visualization
  • APRS.fi integration for global tracking visibility

πŸ“‘ Device Overview

Hardware Components:

  • Arduino Nano – Core controller
  • NEO-6M GPS Module – Provides GPS data
  • SX1278 LoRa Module – Long-range data transmission
  • Morse Encoder – Sends GPS as Morse code
  • SOS Button – Activates emergency signal
  • Rechargeable Battery – Long-lasting power source
  • Weatherproof Case – Protects hardware in the field

🧠 How It Works

  1. Activation: User presses the SOS button.
  2. Data Collection: GPS coordinates and personal data are retrieved.
  3. LoRa Transmission: Broadcast to local receivers.
  4. Morse Code Signal: Transmitted via handy radio for redundancy.
  5. Live Display: Host computer updates the website every 2 seconds.
  6. APRS Upload: Location is pushed to APRS.fi for worldwide visibility.

🌍 APRS Integration

APRS.fi is an internet-based tracking system used by amateur radio operators to publish location data in real time.

Steps to Integrate:

  1. Register a callsign (e.g., AID123) at https://aprs.fi.
  2. On your host computer, use a Python script or APRS client (e.g., YAAC, Xastir) to upload GPS data:
    • Example APRS packet:
      AID123>APRS,TCPIP*:!4859.30N/12345.00W>Emergency SOS from AidLink
      
  3. The beacon will appear on the APRS map globally with callsign.

πŸ”₯ Advantages

  • No need for cellular networks
  • Long-range, energy-efficient LoRa communication
  • Morse code fallback for enhanced reliability
  • Easy SOS activation
  • Customizable transmitted data (Name, Age, Team, Address)
  • Global availability through APRS

πŸ“ˆ Future Enhancements

  • Two-way response communication
  • Waterproof & rugged design upgrades
  • Integration of environmental sensors
  • Satellite fallback for APRS
  • Mobile app support

πŸ§ͺ How to Run Locally

  1. Place main.py and arduino_data.json in the same folder.
  2. Start a python script and vite server:
    npm i 
    py main.py
    npm run dev
    
    

Screenshots (Dashboard)

Screen.Recording.2025-04-18.083217.mp4

About

🚨 AidLink – A disaster-response beacon using Arduino, LoRa, and Morse code to transmit GPS coordinates and personal info in emergencies. Features a live web dashboard and global location tracking via APRS.fi. Built for remote areas where traditional networks fail.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors