Documentation Index
Fetch the complete documentation index at: https://docs.zerokeyusb.com/llms.txt
Use this file to discover all available pages before exploring further.
WebTool: un cargador seguro
La WebTool (el flasher basado en navegador) ya no calcula características de seguridad; solo actúa como una interfaz de transferencia.📥 Ficheros de entrada
La WebTool solo debe recibir ficheros binarios (*.bin) que ya hayan sido pre-firmados por la herramienta de firma offline.
- El fichero contiene el código de aplicación MÁS el footer de seguridad de 28 bytes.
🔄 Protocolo de transferencia
El proceso de flasheo sigue el protocolo USB CDC tradicional, tratando el fichero firmado como un único payload completo:- Inicio: La WebTool envía
HELLOy luegoERASE APPpara limpiar el espacio de la aplicación. - Escritura: La WebTool envía el fichero firmado entero en chunks usando el comando
WRITE addr len crc32y el payload binario. - Finalización: Se envía el comando
DONE. - Activación: El bootloader recibe los datos, los escribe en Flash (incluyendo el footer en su ubicación final) y se reinicia.
⏱️ Gestión de timeouts
Para garantizar que el proceso de flasheo no falle prematuramente si se carga firmware no autorizado, la WebTool espera durante un periodo extendido:- Retraso incrementado: El tiempo de espera final tras enviar
DONEse ha extendido a 20 segundos. - Propósito: Este tiempo cubre el retraso de 15 segundos impuesto por el bootloader si la comprobación de autenticidad falla, garantizando que la conexión USB no se corta antes de que el dispositivo pueda reiniciarse o entrar en modo de espera.