Absortio

Email → Summary → Bookmark → Email

GitHub - benb0jangles/EzTrak: satellite hand tracking made easy

Extracto

satellite hand tracking made easy. Contribute to benb0jangles/EzTrak development by creating an account on GitHub.

Resumen

Resumen Principal

EZ-TRAK es una suite integral de seguimiento satelital diseñada específicamente para operadores de radioaficionados, entusiastas de satélites meteorológicos y fines educativos. Su propuesta de valor central reside en la capacidad de rastrear satélites manualmente en tiempo real mediante la interacción con un dispositivo BLE EZ-TRAK que se acopla a una antena parabólica portátil y ligera. La suite proporciona datos precisos de acimut y elevación, permitiendo un posicionamiento óptimo de la antena para la recepción de señales. Sus características distintivas incluyen el seguimiento dinámico con visualización en tiempo real, la predicción de pasos satelitales según la ubicación del usuario y la capacidad de grabar datos de posicionamiento de la antena para análisis futuros. Además, soporta la descarga de datos TLE (Elementos Keplerianos) desde múltiples fuentes como Celestrak y SatNOGS, todo ello gestionado a través de una interfaz de usuario intuitiva que facilita tanto la configuración como el lanzamiento de las aplicaciones principales.

Elementos Clave

  • Seguimiento Satelital en Tiempo Real y Predicción de Pasos: La funcionalidad principal de EZ-TRAK es su capacidad para mostrar en tiempo real la posición (acimut y elevación) de los satélites, permitiendo a los usuarios ajustar manualmente sus antenas. Complementa esto con una función de predicción de pasos que calcula los futuros tránsitos de satélites visibles desde una ubicación geográfica definida, optimizando las oportunidades de recepción.
  • Integración con Dispositivo BLE EZ-TRAK y Hardware Específico: La suite depende de un dispositivo de hardware compacto EZ-TRAK BLE que se monta directamente en una antena (como la Farabrella), adquiriendo datos de posición. Este dispositivo se comunica inalámbricamente vía Bluetooth Low Energy (BLE), es alimentado por batería para operación en campo y cuenta con una interfaz de botón simple para grabar y reiniciar, lo que facilita la recolección de datos de la antena.
  • Arquitectura de Software Modular: EZ-TRAK se compone de tres aplicaciones principales: el EZ-TRAK Launcher (eztrak_welcome.py) para la configuración inicial y el ajuste de la ubicación geográfica, los satélites a rastrear y la elevación mínima; el Satellite Tracker (eztrack.py), que es la aplicación principal de seguimiento con visualización polar y registro de datos; y Rotator Control (eztrackrotator.py), una aplicación opcional para el control de rotores de antena Wi-Fi e IMU compatibles.
  • Gestión de Datos TLE y Usabilidad: La suite simplifica la obtención de los datos TLE (Two-Line Element), esenciales para el cálculo de las órbitas satelitales, permitiendo su descarga desde Celestrak o SatNOGS DB. Además, su diseño con un lanzador gráfico y una interfaz de seguimiento circular facilita enormemente la configuración, el monitoreo y el uso general para los operadores, incluyendo actualizaciones automáticas de datos satelitales.

Análisis e Implicaciones

EZ-TRAK representa una solución altamente accesible y práctica para la comunidad de radioaficionados y entusiastas de satélites, democratizando el seguimiento preciso de objetos orbitales. Su enfoque en el seguimiento manual con retroalimentación en tiempo real y la portabilidad del hardware BLE abre nuevas oportunidades para expediciones de campo y educación científica. Esto implica una mejora significativa en la eficiencia y precisión de la adquisición de datos satelitales para proyectos personales y educativos.

Contexto Adicional

El software está desarrollado en Python 3.8+ y utiliza la biblioteca Skyfield para los cálculos satelitales, mostrando la solidez de su base tecnológica. Es un proyecto de software propietario, destinado para uso personal y educativo, con un reconocimiento explícito a la comunidad de radioaficionados por su contribución.

Contenido

EZ-TRAK Satellite Hand Tracking Suite

EZ-TRAK Logo

Overview

EZ-TRAK v1

EZ-TRAK is a comprehensive satellite tracking suite designed for amateur radio operators, weather satellite enthusiasts, and educational purposes. The software interfaces with an EZ-TRAK BLE device which is mounted to a lightweight foldable portable satellite dish antenna to hand track satellites in real-time, providing azimuth and elevation data for optimal antenna positioning.

Features

EZ-TRAK DEMO: https://youtu.be/2A2lW0ONNiE

  • Dynamic Satellite Tracking: Track satellites in real-time with azimuth/elevation display
  • Pass Prediction: Calculate upcoming satellite passes for your location
  • BLE Device Integration: Seamlessly connects to EZ-TRAK BLE device
  • Position Recording: Record antenna pointing data for later analysis
  • Multi-Source TLE Data: Download satellite data from Celestrak or SatNOGS DB
  • User-friendly Interface: Easy-to-use application launcher and configuration tool

Components

1. EZ-TRAK Launcher (eztrak_welcome.py)

EZ-TRAK Welcome

A graphical interface to configure and launch the main applications:

  • Set your geographic location (latitude, longitude, altitude)
  • Configure tracked satellites
  • Set minimum elevation for valid passes
  • Download and verify TLE data
  • Launch main tracking applications

2. Satellite Tracker (eztrack.py)

EZ-TRAK1

The main satellite tracking application:

  • Visual polar plot showing real-time azimuth/elevation of your hand tracking antenna
  • Real-time position display
  • Pass prediction information
  • Track recording functionality
  • Automatic satellite data updates

3. Rotator Control (eztrackrotator.py)

EZ-TRAK Rotator

Optional application for controlling wifi + imu antenna rotator (if available).

Installation

Prerequisites

  • Python 3.8 or higher
  • Bluetooth-enabled computer (Windows, macOS, or Linux)
  • EZ-TRAK BLE hardware device

Required Python Packages

pip install bleak matplotlib skyfield numpy requests

Installation Steps

  1. Clone this repository:
git clone https://github.com/benb0jangles/EZ-TRAK.git
cd EZ-TRAK
  1. Run the launcher application (nuked demo version):

Usage

  1. Configure Your Setup:

    • Enter your latitude, longitude, and altitude
    • Select satellites to track (e.g., "NOAA 19", "METOP-C")
    • Set minimum elevation (typically 20° for good reception)
    • Download current TLE data
  2. Launch Tracking Application:

    • Click "Launch EZ-TRAK" to start the main tracking application
    • Make sure your EZ-TRAK BLE device is powered on and nearby
  3. Using the Tracker:

    • The circular display shows azimuth (compass direction) and elevation
    • The red dot shows the current position
    • Blue lines show predicted satellite passes
    • Yellow dot shows satellite position along blue line track
    • Use recording functionality to track your antenna movement

EZ-TRAK2

EZ-TRAK3.

For those wondering what antenna I am using:

Farabrella1.

Troubleshooting

Common Issues

  • Device Not Found: Ensure the EZ-TRAK device is powered on and within range
  • TLE Download Errors: If Celestrak access is limited, try the SatNOGS data source
  • No Satellite Passes: Verify your location settings and satellite selection

Debug Information

The application logs information to the serial console which can be helpful for troubleshooting. Look for messages related to:

  • BLE device connection
  • Satellite TLE parsing
  • Pass prediction calculations

Hardware

The EZ-TRAK BLE device is available from Ez-Trak sales page. This compact device:

  • Interfaces with Farabrella satellite antenna Buy a Farabrella here to provide positional data
  • Connects via Bluetooth Low Energy
  • Battery-powered for field operation
  • Simple button interface for recording and resetting

Legal Notice

All Rights Reserved © 2025 Benb0jangles

This software is proprietary. No permission is granted to copy, distribute, or modify this software without explicit written permission from the author.

This project is provided as-is without any warranty. The software can be used for personal and educational purposes, but redistribution is prohibited.

Acknowledgments

  • Satellite TLE data provided by Celestrak and SatNOGS
  • Built using Skyfield for satellite calculations
  • Special thanks to the amateur radio and satellite tracking community

Fuente: GitHub