# Solución de problemas

Lista de problemas comunes y cómo resolverlos. Si tu caso no aparece aquí, contáctanos desde el formulario de la web.

## El dongle no enciende

- Comprueba que la batería está correctamente colocada (polaridad).
- Confirma que la batería es **Li-ion 3.7V recargable** en formato **16340** o **18350** (no la CR123A primaria de 3V).
- Conecta el cable USB-C: si carga, deberías ver el icono de rayo en la OLED.
- Si el dongle se ha apagado por inactividad, pulsa brevemente el botón para encenderlo de nuevo en Multiboot.

## La OLED no se ve / parpadea

- Si parpadea **al conectar el USB**, comprueba el cable y la alimentación. Fuera de una grabación o actualización, puedes apagar el dongle manteniendo el botón 3 segundos, soltarlo y pulsarlo brevemente para encenderlo de nuevo.
- Si no se ve nunca, comprueba que la pantalla no esté dañada físicamente.

## La GBA no recibe el menú

- Asegúrate de que el cable Link está bien conectado a ambos lados.
- Arranca la GBA manteniendo **Select + Start** hasta que el logo de Game Boy quede fijo.
- Deja el dongle en **Multiboot**. Las pulsaciones cortas recorren **Multiboot → GBA → Online → Multiboot**; el envío del menú comienza automáticamente al detectar la GBA preparada.
- No necesitas un cartucho para recibir el menú. Consulta [Primeros pasos](doc:getting-started) para ver el procedimiento completo.

## El Wi-Fi no conecta o se cae

- Verifica desde la propia GBA (**Configuración → Wi-Fi**) que ves tu red.
- Comprueba la contraseña.
- Si la red es **5 GHz exclusiva**, el dongle no la verá: el ESP32 solo soporta 2.4 GHz.
- Si te conecta pero se cae a mitad de descarga, prueba a acercar el dongle al router.

## El juego no conecta en modo Online

- Comprueba que el juego utiliza el SDK de CanoFlash y que tienes conexión Wi-Fi con acceso a Internet.
- Puedes seleccionar **Online** con el botón antes de pulsar **Conectar** en el juego. El saludo del SDK también se detecta desde **GBA** y **Multiboot**.
- El cambio de modo mantiene el Wi-Fi encendido. Pulsar el botón mientras estás en Online cierra la sesión y vuelve a Multiboot; no lo uses para refrescar una partida en curso.
- Si el dongle está apagado por inactividad, enciéndelo con una pulsación corta y vuelve a conectar desde el juego.
- Para errores de API key, salas o reconexión, consulta la [guía de problemas del SDK](/es/docs/sdk/troubleshooting).

## La verificación del cartucho falla

- Asegúrate de que el cartucho tiene el chip soportado (AMD/Spansion S29GL256).
- Limpia los contactos del cartucho con un bastoncillo y alcohol isopropílico.
- Reintenta la descarga: a veces un mal contacto puntual rompe la verificación.

## El cartucho no es reconocido

- El dongle muestra el ID del chip que lee. Si no coincide con `0x227E`, ese cartucho no es compatible.
- Cartuchos con chip Macronix, Sharp u otros no están soportados actualmente.

## Mi save no aparece en la nube

- Confirma que has subido la partida desde **Gestor Partidas** en la GBA, no solo guardado en el cartucho.
- Refresca la pestaña **Partidas** en la web.
- Comprueba la conexión Wi-Fi y vuelve a intentar la subida desde la GBA. La autenticación se renueva automáticamente; cambiar de modo con el botón no fuerza esa renovación.

## Cómo recuperar un dongle que no autentica

Si la web te dice que el dongle no está autenticado:

1. Comprueba que el número de serie `CFX-XXXXXX` del dispositivo coincide con el vinculado en tu panel.
2. Si has actualizado el firmware, comprueba la conexión Wi-Fi y utiliza la recuperación oficial si el problema persiste.
3. Para reiniciar, mantén el botón al menos 3 segundos hasta apagarlo, suéltalo y pulsa brevemente para encenderlo. Esto conserva la configuración; no es un restablecimiento de fábrica.