Skip to main content

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.

ZeroKeyUSB se conecta a través de un receptáculo USB-C pero se comporta como un dispositivo USB 2.0 full-speed clásico. La placa mantiene el cableado simple para que cualquier host USB-A o USB-C pueda alimentarse y comunicarse con la llave.

​
Cableado del conector

PinFunciónNotas
A1/B12GNDUnidos para cables simétricos
A4/B9VBUSEntrada 5 V (hasta 500 mA)
A5CC1Pull-down 5,1 kΩ (Rd) anuncia modo dispositivo
B5CC2Pull-down 5,1 kΩ (Rd) para cables reversibles
A6/B6D+Conectado a los pines USB del SAMD21
A7/B7D−Conectado a los pines USB del SAMD21
No se usan pares de alta velocidad ni pines USB 3.x. La pantalla está conectada a tierra a través de una resistencia de 1 MΩ y un condensador de 10 nF para supresión de ESD.

​
Ruta de alimentación

  • VBUS alimenta un regulador LDO de 3,3 V (TPS73533) que alimenta el SAMD21, el OLED, el controlador táctil y la EEPROM.
  • La corriente total se mantiene por debajo de 120 mA durante las animaciones del OLED, dentro de los límites USB 2.0.
  • La protección contra corriente inversa evita alimentar el host cuando el dispositivo está apagado.
  • Un fusible PTC resetable (250 mA) añade protección contra cortocircuitos.
Como ZeroKeyUSB no tiene batería, desenchufar el cable corta inmediatamente la alimentación y limpia la RAM volátil.

​
Descriptores USB

InterfazClasePropósito
Interfaz 0Teclado HID (0x03)Teclea automáticamente usuarios y contraseñas
Interfaz 1CDC ACM (0x02)Consola serie para backups, diagnósticos y sincronización horaria
Cada interfaz tiene su propio par de endpoints, permitiendo comunicación simultánea de teclado y serie sin re-enumeración.

​
Consideraciones de seguridad

  • El firmware ignora peticiones de control específicas de fabricante y solo responde a descriptores USB estándar.
  • Los informes HID se generan solamente a partir de acciones confirmadas por el usuario; no hay tecleo disparado por host.
  • Los comandos CDC requieren que el dispositivo esté desbloqueado y, para acciones destructivas, una confirmación de pulsación larga.
  • El suspend USB dispara un bloqueo inmediato tras 30 segundos de inactividad.
Estas salvaguardas garantizan que enchufar la llave en un host desconocido no exponga los secretos almacenados.

​
Resolución de problemas de enumeración

SíntomaCausaSolución
El dispositivo se alimenta pero no se detectaResistencias CC ausentes o incorrectasVerifica los pull-downs de 5,1 kΩ en CC1/CC2.
Se enumera como “Dispositivo desconocido”Firmware no en ejecución o modo bootloaderReflashear vía UF2 o comprobar reset por doble pulsación.
Puerto serie no apareceDriver CDC bloqueadoEn Windows instala el .inf provisto en el repo del firmware.
Si las líneas de datos USB están dañadas, el dispositivo aún puede encenderse, pero no se tecleará ninguna credencial. Inspecciona el conector por residuos o estrés mecánico.