Solución de Problemas
Guía de diagnóstico y resolución de fallas comunes en GITAF PRO
Diagnóstico Rápido por LED
El sistema cuenta con un código de colores (LED RGB) para informar su estado sin necesidad de conectar una computadora.
| Color | Comportamiento | Significado | Acción Requerida |
|---|---|---|---|
| 🔵 Azul | Fijo | Bluetooth Conectado. El Maestro tiene enlace con la App. | Sistema listo para operar. |
| 🟢 Verde | Fijo | Standby (Batería OK). Nivel de carga > 50%. | Todo normal. |
| 🟠 Naranja | Fijo | Batería Media. Nivel de carga > 20%. | Planificar recarga al finalizar sesión. |
| 🔴 Rojo | Fijo | Batería Crítica. Nivel de carga < 20%. | Recargar inmediatamente. Riesgo de apagado. |
| 🔴 Rojo | Parpadeo Rápido | Error de Hardware. Fallo en INA219 o DFPlayer. | Revisar conexiones internas. |
| ⚪ Blanco | Flash (1 seg) | Reinicio / Boot. El sistema acaba de encenderse. | Esperar a que cambie de color. |
| ⚫ Apagado | - | Sin Energía o Deep Sleep. | Verificar interruptor y batería. |
Problemas de Audio
Zumbido o "Soplido" constante en el parlante
Causa: Ruido eléctrico de la transmisión WiFi entrando al amplificador. Solución:
- Verificar que el Capacitor de 1000uF esté soldado lo más cerca posible de los pines de alimentación del módulo PAM8403.
- Confirmar que la resistencia de 1kΩ está instalada entre el pin TX del ESP32 y el RX del amplificador.
- Trenzar los cables que van hacia el parlante.
El audio suena distorsionado o "roto"
Causa: Falta de corriente o volumen digital excesivo. Solución:
- La batería puede estar baja (< 7.0V). El amplificador no recibe suficiente potencia.
- En el código, reducir el volumen del DFPlayer:
myDFPlayer.volume(20);(El máximo es 30, pero satura).
El módulo MP3 no reproduce nada
Checklist:
- La tarjeta SD está formateada en FAT32.
- Los archivos están dentro de una carpeta llamada
mp3. - Los archivos se llaman
0001.mp3,0002.mp3(4 dígitos). - El LED azul del propio módulo DFPlayer debería encenderse brevemente al intentar reproducir.
Problemas de Conectividad
La App no encuentra "Gitaf Pro"
Causa: Caché de Bluetooth del celular o falta de permisos. Solución:
- Apagar y encender el Bluetooth del celular.
- En Android, ir a Ajustes > Aplicaciones > GITAF App y conceder permiso de "Ubicación" y "Dispositivos Cercanos".
- Reiniciar el ESP32 Maestro.
El Maestro no activa los Esclavos
Causa: Direcciones MAC incorrectas o canal WiFi distinto. Diagnóstico:
- Conectar el Maestro al PC y abrir el Monitor Serial.
- Al enviar un comando desde la App, ¿aparece
Delivery SuccessoDelivery Fail?- Fail: El esclavo está apagado, lejos, o la MAC en el código
slave1MACno coincide con la real del esclavo. - Success: El mensaje llega, pero el esclavo no suena (revisar sección de Audio).
- Fail: El esclavo está apagado, lejos, o la MAC en el código
Alcance corto (< 20 metros)
Causa: Antena obstruida. Solución:
- Asegurarse de que la antena PCB del ESP32 (el zig-zag dorado en el borde) no esté tapada por cables, baterías o cajas metálicas. Debe "ver" hacia el exterior.
- Elevar los postes al menos a 1 metro del suelo (el suelo absorbe la señal).
Problemas de Energía (Batería 2S)
El sistema se apaga al subir el volumen
Causa: La batería no soporta el pico de corriente (Amperaje). Solución:
- Usar baterías LiPo de alta descarga (20C o más), como las de drones. Baterías de litio genéricas (tipo 18650 recicladas) pueden no tener fuerza suficiente.
El porcentaje de batería no baja del 100% o marca 0%
Causa: Mala calibración del sensor INA219. Solución:
- Si marca 0%: El sensor está mal conectado (SDA/SCL invertidos) o el fusible del sensor se quemó.
- Si marca valores raros: Verificar que en el código el mapeo sea correcto para 2 celdas:
map(voltage, 6400, 8400, 0, 100).
Preguntas Frecuentes
¿Puedo usarlo mientras carga?
NO. El sistema de carga de baterías LiPo 2S requiere desconectar la carga (el circuito) para balancear las celdas correctamente. Usarlo mientras carga puede dañar el cargador o introducir ruido de red (60Hz) en el audio.
¿Qué pasa si pierdo la conexión Bluetooth?
El sistema es autónomo. Si el celular se desconecta o se apaga, los postes dejarán de sonar automáticamente tras terminar su ciclo actual de 3 repeticiones. No se quedarán "pegados" sonando.
¿Necesitas ayuda técnica?
Si el problema persiste, conecta el dispositivo al puerto USB, abre el Monitor Serial de Arduino (115200 baudios) y copia el registro de arranque para enviarlo al equipo de soporte.
Ejemplo de Log Saludable:
[INICIO] Sistema GITAF Master Arrancando...
[OK] Sensor Bateria Listo
[OK] Modulo de Audio Listo
[BLE] Dispositivo Movil CONECTADO
[ESTADO] Bateria: 95%