ZeroTrace Companion
HID Dashboard
Real-time view of any connected ZeroTrace HID or BLE Logger — device info, storage, connection state, and quick actions.
When you connect a ZeroTrace HID or BLE Logger device, Companion opens the HID dashboard as the main view. It is the at-a-glance status board for everything Companion knows about the connected device.
What the dashboard shows
The dashboard is organised into four sections.
Device information
The top of the dashboard shows the device's self-reported metadata:
| Field | What it tells you |
|---|---|
| Device name | The name set in the device's settings (visible over Wi-Fi / BLE) |
| Product name | Hardware product family (e.g. "ZeroTrace HID") |
| Serial number | The unique hardware identifier |
| Firmware version | Currently flashed firmware |
| Default layout | Keyboard layout the device uses for HID injection |
| Power mode | Performance profile currently active |
| Storage | Total internal storage |
| Space left | Available storage for scripts, payloads, captures |
This block updates whenever the device reports a change.
Wireless state
A second block summarises wireless interfaces:
- BLE name — what name the device advertises over Bluetooth.
- Wi-Fi STA — whether the device is connected to a Wi-Fi network as a station.
- Wi-Fi password — the password for the device's own access point (when applicable).
- SSID randomisation — whether the device randomises its access-point SSID per boot.
Behaviour flags
A toggle / status block for the device's behaviour:
- Disable Caps Lock — prevents accidental Caps Lock state from breaking scripts.
- Disable BLE on startup — boots without BLE enabled.
- Disable HID on startup — boots without HID enabled (waits for explicit activation).
- Always recon — the device boots into reconnaissance mode by default.
- Wipe-on-execute — the device wipes payload after running it (operational-security feature).
Each flag shows the current state and a way to toggle it (when supported by your firmware).
Quick actions
Top-right of the dashboard:
| Action | What it does |
|---|---|
| Refresh | Re-pull device info from the connected device |
| Restart | Soft-reboot the device |
| Stop | Gracefully shut down the device |
| Reset | Restore the device to factory settings (destructive — confirms first) |
| Update | Open the firmware-update workflow |
| Export | Save the current device info to a file |
Quick actions are sent over the serial connection as ordinary commands — you can see them in the terminal if you have it open.
Reset restores factory defaults. It removes scripts, payloads, captures, and saved Wi-Fi networks. Use it only when you intend to start over.
Auto-refresh
The dashboard polls the device for updated info on a regular interval. Default is 1 second; configure in Settings → Dashboard.
For long-running sessions where polling isn't needed, you can disable auto-refresh and use the manual Refresh button instead.
Export device info
The export action saves the current device-info snapshot as:
- JSON — the raw structured data, perfect for scripting.
- CSV — flat one-row format for spreadsheet review.
- Markdown — human-readable format suitable for tickets, reports, or wiki pages.
Useful for support tickets, change logs, or simply keeping a record of "what state was the device in on date X."
When the dashboard shows nothing
If the dashboard appears empty after connecting:
- The device may not respond to the standard
information systemcommand — see custom firmware. - The connection may have dropped — check the connection indicator in the top-left.
- The firmware may be older than expected — fields the firmware doesn't support stay blank.
The terminal is your fallback whenever the dashboard cannot present the data.