Skip to main content
Follow the sections in order — many issues are resolved after completing the previous steps.

​
Before You Begin

  1. Ensure the device is receiving stable power through the USB-C connection.
  2. Confirm that you are using the original factory firmware (updates are rarely needed).
  3. Note any on-screen error messages and recent configuration changes.
  4. If possible, back up your credentials via the local web manager before making changes.

​
Quick Symptom & Solution Table

​
Step-by-Step Procedures

​
1. Safe Restart

  • Unplug ZeroKeyUSB.
  • Wait about 5 seconds.
  • Reconnect to a USB power source (PC or phone).
    The splash screen should appear within 3–5 seconds.

​
2. Reset Touch Controller

  1. Disconnect and reconnect the device.
  2. Wait until the ZeroKeyUSB logo appears.
  3. Tap each golden pad to confirm all five respond.
    If touch remains unresponsive, perform a factory reset to recalibrate automatically.

​
3. Firmware Flash (development units only)

⚠️ Production devices are resin-encapsulated and cannot be reflashed by the user.
This section applies only to pre-production boards.
  1. Quickly reconnect the USB cable twice within one second to enter bootloader mode.
  2. Copy the firmware .uf2 file to the drive named ZEROBOOT.
  3. Wait for the file transfer to complete, then reconnect normally.
  4. Verify the firmware version under Menu → Settings → About.

​
4. Factory Reset and Reconfiguration

  • Export credentials via the web manager (Backup → Export).
  • Hold the center touch pad for about 10 seconds until the confirmation countdown appears.
  • The process erases all memory, including credentials, PIN signature, and IV.
  • After restart, re-import your backup or run the first-time setup again.

​
Collecting Data for Support

  • Connect the device and open the Serial Monitor at 115200 bps to capture log output.
  • Take photos of any on-screen errors.
  • Note the serial number (SN ZK-XXXXXXXX) and firmware version from Menu → Settings → About.

​
Contacting Support

If problems persist:
  • Submit a support ticket at zerokeyusb.com/support including:
    • Device serial number
    • Firmware version
    • Screenshots or photos of the issue
    • Steps you’ve already tried
  • Our team will reply within 24 business hours with further guidance.
⚠️ Do not attempt to open or reflash a sealed device.
Doing so will destroy the waterproof encapsulation and void warranty.
This guide covers user-level diagnostics.
For factory calibration or advanced debugging, contact authorized service partners directly.