hid-replay - HID input device replay through uhid

hid-replay [--verbose] [FILENAME]

Enable debugging output

hid-replay creates a virtual HID device based on the recorded file, usually recorded by hid-recorder(1). This device behaves as if it was physically connected to the system. Any events in the recorded file are replayed in realtime.

hid-replay is a low-level debugging tool. It uses the uhid kernel model to create the device and all data is processed by the respective HID kernel module for the device.

hid-replay needs to be able to write to /dev/uhid; usually this means it must be run as root.

Files supported by hid-replay have the following syntax:

# comment lines are ignored when parsing
D: the device index, only used when recording multiple devices
R: The report descriptor length in bytes, followed by the report descriptor bytes in hexadecimal
N: the name of the device
P: physical path
I: bus vendor_id product_id
E: timestamp size report in hexadecimal

hid-replay is a very low level events injector. To have the virtual device handled by the correct HID kernel module, hid-replay fakes that the device is on the original bus (USB, I2C or BT). Thus, if the kernel module in use has to write back to the device the kernel may oops if the module is trying to directly talk to the physical layer.

Ensure to use this program with friendly HID modules that rely only on the generic hid callbacks.

hid-replay returns 1 on error.


Copyright 2012-2018, Benjamin Tissoires.

Copyright 2018, Red Hat, Inc.

Benjamin Tissoires <benjamin.tissoires@redhat.com>