Software for the LagBox, our input latency measuring device.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gui initial commit Apr 18, 2018
src
LICENSE
README.md

README.md

LagBox WIP

Usage

LagBox can be used with different modes. While stepper mode and auto mode are used for latency measurements, the other modes serve debugging and testing purposes. You can set several parameters of the program via the command line.

Command Line Parameters

Command Function
-m Mode (0 = stepper mode, 1 = stepper latency test mode, 2 = stepper reset mode, 3 = auto mode, 4 = pressure sensor test mode)
-tmin minimum delay time in microseconds for auto mode
-tmax maximum delay time in microseconds for auto mode
-n number of test iterations
-b button code from input event (find out with evtest)
-d device type (1 = gamepad, 2 = mouse, 3 = keyboard)
-steps number of steps to test in stepper latency test mode
-delay delay between tests in stepper mode and stepper latency test mode
-dir direction to drive in stepper reset mode (1 (default) = up, -1 = down)
-event manually set the input event (find out with evtest)
-name manually set the device name that will appear in the log file
Auto Mode

The most mature and reliable testing mode of the LagBox, known from our CHI paper. A button of a USB-connected input device is electrically triggered and the time until the input event arrives in the Linux kernel of the LagBox is measured. This approach requires a bit of a setup as you have to connect (solder or clamp) wires to the two sides of the button you want to test. Connect those wires to the optocoupler that is controlled by the LagBox and connect the device to the LagBox via USB. To specify the input device and -button, it is recommended to set them manually via the command line parameters -d and -b. If this does not work for some reason you might want to try the -event parameter to pass the input event of the device you want to test to the program. The test results will be saved in '../log/' as a .csv file with semicolons as separators. If you want to use a simple GUI you can pipe the std output of auto mode into the python program latency_gui.py.

Stepper Mode

This mode is still work in progress will documented as soon as it works reliably.

Code

inputLatencyMeasureTool.c

Contains the main functionality for all modes of the LagBox as well as some utility functions. Will be split up into multiple files at some point in the future.

fileLog.c

Handles building up and saving the log file for sensor data.

joystickControl.c

Handles the detection of input devices as well as setting up a connection to the kernel.

stepper.c

Small API for the DRV8834 stepper motor controller that drives the stepper motor used in stepper mode.