HIT TRACKER
Plataforma completa de entrenamiento de boxeo. Planes de ejercicio, sesiones con análisis en tiempo real y sensor ESP32 vía Bluetooth BLE.
¿Qué es?
HIT TRACKER es una app móvil Android para boxeadores que quieren entrenar con estructura y medir su rendimiento. Combina dos módulos:
Módulo Entrenamiento — Crea planes con calentamiento, trabajo de core y boxeo. Ejecuta el plan completo: el WorkoutPlayer te guía por los ejercicios físicos y, al terminar, arranca directamente la sesión de boxeo con los rounds y combos que hayas definido.
Módulo Sesión — Sesión de boxeo directa conectada al sensor ESP32. Registra cada golpe con su potencia y cadencia, ronda a ronda. Al terminar, tienes el historial completo con gráficos de progreso.
No requiere cámara, ni suscripción, ni cuenta. El sensor vale ~15€ y los datos son tuyos.
Funcionalidades
Entrenamiento completo
- Crea planes de entrenamiento con tres fases: calentamiento → core → boxeo
- Catálogo de ejercicios integrado con tabs por categoría (Calentamiento / Core / Boxing), adaptado del dataset público exercises-dataset (MIT License)
- Busca e importa ejercicios adicionales desde wger — base de datos pública de entrenamiento
- Añade ejercicios personalizados a tu catálogo
- Define combos por ronda: la notación aparece en pantalla durante la cuenta atrás antes de cada round
- El plan se ejecuta en secuencia: el WorkoutPlayer te guía por los ejercicios físicos y arranca el boxeo automáticamente al terminar
Sesión de boxeo
- Detección de golpes en tiempo real via BLE (sensor ESP32) o firmware V3/V4 (detección en hardware)
- Configura rondas, descansos y número de rounds
- Modo libre: sin límite de tiempo, el usuario termina la ronda manualmente
- Métricas en directo: potencia máxima, HPM actual y promedio, gráfico de golpes
- Audio: campana distinta para inicio de ronda, fin de ronda y fin de sesión; cuenta atrás con beeps
- Resultados al terminar con gráfico de evolución por ronda
- Compartir sesión como imagen
Dashboard y progreso
- Tu power: media de potencia de las últimas 5 sesiones con el perfil activo
- Gráfico de progreso: HPM y potencia de las últimas 8 sesiones
- Historial de sesiones (más reciente primero) con detalle completo (scatter por ronda, stats)
Perfiles de calibración
- Múltiples perfiles (uno por tipo de saco, por persona, etc.)
- Wizard de calibración guiado: golpea ligero y fuerte, la app sugiere umbral y sensibilidad automáticamente
- Ajuste manual de threshold, sensitivity y rebound
- Eliminar un perfil pide confirmación y borra también sus sesiones guardadas
Copia de seguridad en Google Drive
- Conecta una cuenta de Google desde Perfiles para respaldar sesiones y perfiles automáticamente
- Subida en silencio al terminar cada sesión o al editar un perfil; cola offline con reintento automático
- Al conectar en un móvil nuevo, descarga el historial existente en Drive
- Resolución de conflictos si los perfiles locales difieren de los de Drive (usar Drive, mantener locales, o combinar)
- Los datos se guardan en
drive.appdata, una carpeta oculta accesible solo por la app
Hardware
⚠️ Hardware de prototipado, no un producto terminado. En particular, la batería 18650 y su circuito de carga (TP4056 + LM2596) no llevan protección de sobrecarga/sobredescarga más allá de la que trae el módulo TP4056 — usa celdas con protección (18650 "protected") y supervisa la carga. Móntalo bajo tu responsabilidad.
Precisamente por dar cabida a la 18650 y su circuito de carga, el tamaño final queda más abultado de lo deseable. Esta versión con ESP32 DevKit V1 está validada y funciona de forma estable en uso real — el siguiente paso en desarrollo es una versión MINI con ESP32-C3 Mini, mucho más compacta:
La versión MINI aún no incorpora los LEDs indicadores ni la monitorización de batería de la V4 — está pendiente portarlos al nuevo formato (ver docs/ROADMAP.md).
Posición del sensor: punto de anclaje del saco (menor oscilación pendular).
| Tipo de saco | Posición |
|---|
| Saco colgado | Cerca del enganche superior |
| Saco de pie | Base inferior, periférico al mástil |
Versiones de firmware
| Versión | Protocolo | LEDs | Batería |
|---|
| V2 | Stream continuo 16 bytes/10ms | — | — |
| V3 | Hit events 6 bytes/golpe; config BLE | — | — |
| V4 | Hit events 6 bytes/golpe; config + batería BLE | 4 LEDs | ADC GPIO 34 |
El firmware V4 incluye 4 LEDs indicadores (encendido, BLE, golpe, reserva) y monitorización de la batería 18650 via divisor de voltaje.
Ver docs/GUIA-CONEXION-V1.md para el esquema de conexión completo.
Inicio Rápido
1. Firmware ESP32
Arduino IDE 2 → Board: ESP32 Dev Module → Upload Speed: 921600
Abre FIRMWARE/HitTracker_V4/HitTracker_V4.ino, sube al ESP32 y verifica en el Serial Monitor (115200 baud) que imprime lecturas.
2. App
npm install
npm run android
Requisito: Android 8+ con Bluetooth activado.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
