Solución de problemas

Problemas habituales de MuPiBox y su solución: pantalla negra, sin sonido, cortes de wifi, Spotify, nivel de batería, espera, actualizaciones y cómo pedir ayuda.

Los problemas más habituales y qué ayuda. Para todo lo demás, los registros muestran la causa.

No se puede acceder a la administración #

• ¿Misma red? El móvil o el PC deben estar en la misma red doméstica.
• Dirección con puerto: http://<IP>:8090/admin/. Tu router muestra la IP.
• <nombre-de-la-caja>.local no funciona en todas las redes; usa entonces la IP.

La pantalla sigue negra o el táctil no responde #

• ¿Es correcto el perfil de pantalla? Reinicia tras un cambio.
• ¿Se ha colgado la interfaz? Reiníciala en Interfaz táctil.
• En espera la pantalla está oscura y el táctil desactivado: pulsa brevemente el botón de encendido.

La pantalla no se pone totalmente negra en espera #

Se debe a la retroiluminación de la pantalla, ver Pantalla y táctil. Las pantallas Waveshare de 5″ recientes solo se pueden atenuar.

No hay sonido #

• Comprueba el hardware de audio y reproduce el tono de prueba.
• ¿Hay un dispositivo Bluetooth conectado? El sonido va entonces allí.
• ¿Volumen máximo demasiado bajo?
• Tras activar el MuPiHAT hace falta reiniciar.

Cortes de wifi #

• Desactiva el ahorro de energía del wifi (Red).
• Usa una memoria wifi USB y márcala como preferida.
• Con memorias rtw88, «desactivar el ahorro profundo».
• Revisa la fuente de alimentación: poca potencia provoca cortes.

Spotify no reproduce #

• ¿Se ha elegido la caja una vez como dispositivo en la app de Spotify?
• ¿Clave Soloist caducada o incorrecta? → Spotify
• Si la página indica un bloqueo por demasiadas solicitudes, espera: la caja se modera sola después.
• Por Bluetooth, solo con el backend Soloist.

El nivel de batería salta #

Desconecta y conecta el cable una vez para que la caja mida la resistencia interna. Ver MuPiHAT.

La caja se apaga al pulsar el botón en lugar de entrar en espera #

• ¿Está activado el modo de espera? → Pantalla y energía
• El «Diagnóstico del botón de encendido» muestra si systemd-logind sigue gestionando el botón o si otro programa lo lee.
• Una pulsación larga siempre apaga el MuPiHAT de golpe.

Una actualización falla #

• El registro de actualización en Registros muestra el motivo.
• Si una actualización falla, la caja arranca con la versión anterior: no se pierde nada.

Pedir ayuda #

Abre una incidencia en GitHub con la versión (ver Acerca de), tu hardware, una descripción y el registro descargado. Comprueba antes que no contenga nada personal; la caja oculta contraseñas y tokens por sí misma.