Resolución de problemas
Resolución de problemas
Web Serial no aparece
Use Chrome o Edge de escritorio y HTTPS. Cierre otras aplicaciones que usen el puerto. Compruebe cable de datos y autorización del sistema operativo.
No entra en bootloader
Mantenga BOOT al iniciar la conexión o controle EN/IO0 según la placa. Los adaptadores USB-TTL no siempre automatizan las líneas.
Falla a velocidad alta
Vuelva a 115200. La validación física mostró conexiones estables a esa velocidad y fallos de flujo tras cambiar a 921600 en cierto hardware.
El archivo no cabe
Compruebe tamaño detectado, offset final y parámetro flash size. Para imágenes completas merged use 0x0. No cargue binarios como texto o Base64 en esptool-js.
Restore no se habilita
Debe existir paquete validado, ESP32 conectado, compatibilidad no incompatible y texto RESTORE exacto. Seleccionar todas las regiones no deshabilita por sí mismo la acción, aunque muestra advertencias sensibles.
Servicio web no responde
Revise systemd, journal, PostgreSQL, permisos de /srv, Nginx y espacio. No exponga contraseñas del entorno al recopilar logs.
Resolución de problemas Web Serial no aparece Use Chrome o Edge de escritorio y HTTPS. Cierre otras aplicaciones que usen el puerto. Compruebe cable de datos y autorización del sistema operativo. No entra en bootloader Mantenga BOOT al iniciar la conexión o controle EN/IO0 según la placa. Los adaptadores USB-TTL no siempre automatizan las líneas. Falla a velocidad alta Vuelva a 115200. La validación física mostró conexiones estables a esa velocidad y fallos de flujo tras cambiar a 921600 en cierto hardware. El archivo no cabe Compruebe tamaño detectado, offset final y parámetro flash size. Para imágenes completas merged use 0x0. No cargue binarios como texto o Base64 en esptool-js. Restore no se habilita Debe existir paquete validado, ESP32 conectado, compatibilidad no incompatible y texto RESTORE exacto. Seleccionar todas las regiones no deshabilita por sí mismo la acción, aunque muestra advertencias sensibles. Servicio web no responde Revise systemd, journal, PostgreSQL, permisos de /srv, Nginx y espacio. No exponga contraseñas del entorno al recopilar logs.
Información técnica del documento
- Ruta lógica
- reference/troubleshooting.md
- Commit Git
a83cef9e1ee0c5b0b22662fe3493139d77c23570- SHA-256
dd31a2cd4012d234cc94d8e4d4238cb1a9b22969e093bd55508b836648a1a0d5- Regeneración
scripts/build-documentation.sh