Skip to content

Latest commit

 

History

History
117 lines (85 loc) · 3 KB

README.md

File metadata and controls

117 lines (85 loc) · 3 KB

📡 APRS Passcode Generator

License: AGPL v3 Website Made with Love

A lightweight, user-friendly web tool for generating APRS passcodes from amateur radio callsigns. Try it live at pass.hamradio.my!

🌟 Features

  • Instant Passcode Generation: Generate APRS passcodes from any valid callsign
  • User-Friendly Interface: Clean, modern design with intuitive controls
  • Mobile Responsive: Works perfectly on all devices
  • Visual Feedback:
    • Callsigns displayed in blue with uppercase formatting
    • Passcodes highlighted in red for clarity
    • Real-time validation and error checking

🚀 Quick Start

  1. Visit pass.hamradio.my
  2. Enter your amateur radio callsign
  3. Click "Generate"
  4. Your APRS passcode will be instantly displayed

📌 Embed on Your Site

Add this responsive iframe to your website:

<iframe 
  src="https://pass.hamradio.my" 
  style="width: 100%; height: 500px; border: none;" 
  allowfullscreen
></iframe>

🔧 Technical Details

What is APRS?

APRS (Automatic Packet Reporting System) is a digital communications protocol for amateur radio. It enables real-time sharing of:

  • Geographic positions
  • Weather station data
  • Short messages
  • Other data

Passcode Algorithm

The APRS passcode is generated through:

  1. SSID removal (e.g., "-1" from callsign)
  2. Uppercase conversion
  3. Bitwise operations:
    • XOR operations
    • Bit shifting of ASCII values
    • Combination with constant 0x73
  4. Generation of 16-bit unique identifier

Use Cases

  • ✅ Beacon Authentication
  • ✅ APRS-IS Network Access
  • ✅ Digipeater Validation
  • ✅ iGate Configuration
  • ✅ Custom APRS Services

💻 Development

Prerequisites

  • Basic knowledge of:
    • HTML5
    • CSS3
    • JavaScript (ES6+)
  • Git for version control
  • GitHub account for contributions

Contributing

We welcome contributions! Here's how:

  1. Fork the repository
  2. Create your feature branch: 
    git checkout -b feature/AmazingFeature
  3. Commit your changes: 
    git commit -m 'Add some AmazingFeature'
  4. Push to the branch: 
    git push origin feature/AmazingFeature
  5. Open a Pull Request

📄 License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.

🙏 Acknowledgments

📬 Contact

Made with ❤️ for the Amateur Radio Community