CAPÍTULO 10

Diagnóstico y recuperación

Árbol de decisión para red, radio, MQTT, ChirpStack, alimentación y microSD.

ResultadoUna causa acotada, evidencia conservada y un cambio reversible cada vez.Tiempo orientativoSegún incidencia

Método de diagnóstico

1
Describe el síntoma
Anota hora, alcance y último cambio; evita reiniciar inmediatamente.
2
Conserva evidencia
Guarda estados y registros en el espacio privado de la sede.
3
Recorre por capas
Alimentación → sistema → red → radio → MQTT → ChirpStack → nodo.
4
Cambia una variable
No actualices, recables y regeneres credenciales a la vez.
5
Valida o revierte
Repite la prueba que fallaba y documenta el resultado.

Recoger evidencia segura

Gateway

date -Is
uptime
ip -br address
ip route
df -h /
free -h
vcgencmd get_throttled 2>/dev/null || true
systemctl --failed
sudo journalctl -b -p warning --no-pager | tail -n 100

Síntomas frecuentes

Síntoma	Comprueba	Siguiente acción
No responde por red	Fuente, LEDs, DHCP, cable y enlace	Consola local o reserva DHCP; no reformatear
Radio no inicia	Antena, SPI, reset, modelo y permisos	Apagar y comparar pinout exacto
No hay estadísticas	Forwarder, broker, prefijo eu868 y credencial	Probar MQTT local y registros
Offline en ChirpStack	EUI, tenant, broker y reloj	Comparar EUI carácter por carácter
Nodo no se une	EU868, DevEUI, JoinEUI, AppKey y perfil	Regenerar solo si hay compromiso confirmado
Reinicios	Fuente, cable, temperatura y undervoltage	Sustituir alimentación antes de tocar software
microSD dañada	Errores I/O y copia disponible	Restaurar en una tarjeta nueva