Changes to the emulated device type become active after disconnecting and reconnecting HID Remapper.
Changes to gamepad input normalization are applied after re-plugging the device or HID Remapper.
Custom usages
If both Vendor ID and Product ID are zero, usage applies to all interfaces on all devices.
Set size to zero to remove an existing usage.
Custom usages are only applied after re-plugging the device or HID Remapper.
Onboard sensors
Changes to the onboard sensors enable setting are applied after re-plugging the device or HID Remapper.
Filtering
samples
1 is most reactive, 16 is most stable
Tilt inputs
deg
deg
deg
Deadzone: 0 to 90 degrees; max: 1 to 90 degrees per direction
deg
deg
deg
Deadzone: 0 to 90 degrees; max: 1 to 90 degrees per direction
Yaw and twist inputs
XIAO has no absolute yaw. On 6DoF boards, startup or recenter defines the current position as zero.
Leaky Relative Yaw integrates twist motion from that zero and slowly returns to zero over the return time.
Use a longer return time to hold a direction longer, or 0 to disable the virtual spring. Twist Rate is only twist speed and returns to zero when still.
Standard Yaw remains magnetometer-backed 9DoF only.
deg
deg
deg
Deadzone: 0 to 90 degrees; max: 1 to 90 degrees per direction
s
Return time; 0 disables the virtual spring
deg/s
deg/s
Deadzone: 0 to 255 degrees per second; max: 1 to 255 degrees per second
Expression /* comments */ are not saved to device, but they are preserved in exported JSON files.
Interact with the device connected to HID Remapper to see what usage codes it generates.
Usage
Last value
Min value
Max value
Bluetooth
BLE HID controllers and NUS virtual input are managed separately.
Open a Bluetooth-capable HID Remapper with Open device first.
LED solid ON — scanning for a new device to pair (nRF52840 only)
LED blinking — reconnecting to bonded devices, or idle with no connections (nRF52840 only)
N blinks per cycle — N BLE input devices currently connected (nRF52840 only)
LED brief flash — NUS input received (Pico W / Pico 2 W)
BLE HID controllers
Open device to list paired and connected BLE HID devices.
Label
State
Port
Address
ID
NUS virtual input
NUS is a separate virtual input link over Web Bluetooth. It does not pair or reconnect physical BLE HID controllers.
Open device to read NUS connection state from firmware.
Label
State
Address
NUS tester
Send virtual test gamepad input from this browser over Web Bluetooth (Nordic UART Service). This does not pair physical controllers — use BLE input devices above for that. The first write may trigger a browser pairing prompt so the BLE link can be encrypted.
Disconnected. Use Connect first; the first write may ask to pair so the BLE link can be encrypted.