Skip to content

ZeroTrace BLELogger

BLE Identity & Spoofing

Auto-spoof the plugged keyboard's identity, or override manually

When a USB keyboard is plugged into BLELogger's host port, the firmware reads its USB descriptors (vendor ID, product ID, device name, HID descriptor) and replicates them on the BLE side. The host pairing over Bluetooth sees a device that looks identical to the wired keyboard.

Auto-spoof (default)

Toggle in Settings → BLE Identity → Auto-spoof. With auto-spoof on:

  • BLE device name = USB keyboard's product string (e.g. Logitech K120)
  • BLE manufacturer ID = USB vendor ID
  • HID report descriptor passed through unmodified

This means a Logitech keyboard plugged into BLELogger appears as a Logitech BLE keyboard to the host.

Manual override

Set fixed values regardless of plugged keyboard:

  • Device name — what shows in the host's Bluetooth picker
  • Manufacturer data — raw bytes per BLE 5.0 spec
  • Appearance code — 16-bit appearance value

Useful for testing pairing UX against a known target name, or for routine wireless adapter use where you want one stable identity across keyboard swaps.

Battery service

BLELogger advertises the standard BLE Battery Service. Reported value is the device's own battery (when battery-backed) or 100 % (when USB-powered) — not the plugged keyboard's. Hosts see a "wireless keyboard" battery indicator.

The chosen identity (auto or override) persists across reboots.