ZeroTrace HID
Lock & USB Status
Live host-state indicators in the mobile app and in scripts
The device tracks what the host reports back over USB — the keyboard lock LEDs and the enumeration state — and exposes it both in the mobile app and to scripts.
- Caps Lock — on / off
- Num Lock — on / off
- Scroll Lock — on / off
- USB connection — enumerated / not
- Detected OS — from OS detection
These are read from the standard HID lock-state reports the host sends. On Kit hardware they also appear on the OLED display.
Why it matters
- Caps Lock — verify the host before running a case-sensitive payload, or let Disable Caps Lock clear it automatically.
- Num Lock — numpad scancodes need Num Lock on or the output drops.
- USB — confirm the target accepted enumeration before firing a payload.
Script access
The same values are available in scripts as state variables. Their expanded value is lowercase (on / off, or the OS name):
_@capslockState # on / off
_@numlockState # on / off
_@scrolllockState # on / off
_@usbState # on / off
_@detectedOS # detected host OS name
Gate payloads on host state
Use these in IF blocks to branch a payload — for example, only proceed once _@usbState is on, or pick a command set based on _@detectedOS.