FFBChecker

Description

This tool of a very unimaginative name is mainly intended to test implementation of Force Feedback on Linux systems. It has a Qt5-based GUI that allows the user to set up parameters of the effects and play them back on their devices. Only Linux Force Feedback API and SDL2 is supported at the moment. Support for other interfaces such as DirectInput might be added in the future.

Usage

Choose the device on which you want to play the effects from the Devices combobox. If the desired device does not appear in the menu, try clicking Refresh to update the list of detected devices. Devices that you do not have access to due to insufficient privileges will not appear in the list. Once the device has been selected and successfully opened by FFBChecker you can set up effect parameters using the entry fields below.

Remarks

Effects of finite duration will still be listed as Playing by the GUI. Most Linux Force Feedback drivers do not report back when a finite effect has finished playing and FFBChecker does not currently check for respective event anyway.
Clicking the Start button will upload the effect automatically if the effect has not been uploded before. Similar thing applies for the Remove button which stops the effect before it tries to remove it from the device.
Clicking Upload/Update button on a playing effect will issue "live" update of the effect's parameters.
Clicking Start when the selected effect is listed as Playing has no effect even if the parameters of the effect have changed or if the effect has finished playing. Use the Stop button to stop the effect and then Start again to restart it.
Clicking Start when the selected effect is already listed as Uploaded does not update the parameters of the effect. If you adjusted the parameters after the effect had been uploaded, use the Upload/Update to pass the new parameters to your device.

Build/Installation

cd into the source directory and run:

mkdir build
cd build
cmake ../ -DCMAKE_BUILD_TYPE=Release
make

Note that at least CMake 3.1 is required.

SDL2 is an optional dependency on Linux. On distributions that ship CMake-enabled SDL2 builds, SDL2 gets configured automatically. In other cases the SDL2_XDIR variable must be set to point to a valid SDL2 library installation. Such a directory must contain include and lib directories with appropriate content.

To launch FFBChecker, run:

./FFBChecker

Name		Name	Last commit message	Last commit date
Latest commit History 87 Commits
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
conditioneffectsettings.cpp		conditioneffectsettings.cpp
conditioneffectsettings.h		conditioneffectsettings.h
conditioneffectsettings.ui		conditioneffectsettings.ui
constanteffectsettings.cpp		constanteffectsettings.cpp
constanteffectsettings.h		constanteffectsettings.h
constanteffectsettings.ui		constanteffectsettings.ui
deviceprober.h		deviceprober.h
effectsettings.cpp		effectsettings.cpp
effectsettings.h		effectsettings.h
envelopesettings.cpp		envelopesettings.cpp
envelopesettings.h		envelopesettings.h
envelopesettings.ui		envelopesettings.ui
ffbconditioneffectparameters.cpp		ffbconditioneffectparameters.cpp
ffbconditioneffectparameters.h		ffbconditioneffectparameters.h
ffbconstanteffectparameters.cpp		ffbconstanteffectparameters.cpp
ffbconstanteffectparameters.h		ffbconstanteffectparameters.h
ffbdevice.cpp		ffbdevice.cpp
ffbdevice.h		ffbdevice.h
ffbeffect.cpp		ffbeffect.cpp
ffbeffect.h		ffbeffect.h
ffbeffectparameters.cpp		ffbeffectparameters.cpp
ffbeffectparameters.h		ffbeffectparameters.h
ffbenvelopeparameters.cpp		ffbenvelopeparameters.cpp
ffbenvelopeparameters.h		ffbenvelopeparameters.h
ffbnulleffect.cpp		ffbnulleffect.cpp
ffbnulleffect.h		ffbnulleffect.h
ffbperiodiceffectparameters.cpp		ffbperiodiceffectparameters.cpp
ffbperiodiceffectparameters.h		ffbperiodiceffectparameters.h
ffbrampeffectparameters.cpp		ffbrampeffectparameters.cpp
ffbrampeffectparameters.h		ffbrampeffectparameters.h
ffbrumbleeffectparameters.cpp		ffbrumbleeffectparameters.cpp
ffbrumbleeffectparameters.h		ffbrumbleeffectparameters.h
globals.h		globals.h
globalsettings.cpp		globalsettings.cpp
globalsettings.h		globalsettings.h
helpers.h		helpers.h
linuxdeviceprober.cpp		linuxdeviceprober.cpp
linuxdeviceprober.h		linuxdeviceprober.h
linuxffbconditioneffect.cpp		linuxffbconditioneffect.cpp
linuxffbconditioneffect.h		linuxffbconditioneffect.h
linuxffbconstanteffect.cpp		linuxffbconstanteffect.cpp
linuxffbconstanteffect.h		linuxffbconstanteffect.h
linuxffbdevice.cpp		linuxffbdevice.cpp
linuxffbdevice.h		linuxffbdevice.h
linuxffbeffect.cpp		linuxffbeffect.cpp
linuxffbeffect.h		linuxffbeffect.h
linuxffbeffectfactory.cpp		linuxffbeffectfactory.cpp
linuxffbeffectfactory.h		linuxffbeffectfactory.h
linuxffbperiodiceffect.cpp		linuxffbperiodiceffect.cpp
linuxffbperiodiceffect.h		linuxffbperiodiceffect.h
linuxffbrampeffect.cpp		linuxffbrampeffect.cpp
linuxffbrampeffect.h		linuxffbrampeffect.h
linuxffbrumbleeffect.cpp		linuxffbrumbleeffect.cpp
linuxffbrumbleeffect.h		linuxffbrumbleeffect.h
main.cpp		main.cpp
mainwindow.cpp		mainwindow.cpp
mainwindow.h		mainwindow.h
mainwindow.ui		mainwindow.ui
periodiceffectsettings.cpp		periodiceffectsettings.cpp
periodiceffectsettings.h		periodiceffectsettings.h
periodiceffectsettings.ui		periodiceffectsettings.ui
rampeffectsettings.cpp		rampeffectsettings.cpp
rampeffectsettings.h		rampeffectsettings.h
rampeffectsettings.ui		rampeffectsettings.ui
rumbleeffectsettings.cpp		rumbleeffectsettings.cpp
rumbleeffectsettings.h		rumbleeffectsettings.h
rumbleeffectsettings.ui		rumbleeffectsettings.ui
sdl2deviceprober.cpp		sdl2deviceprober.cpp
sdl2deviceprober.h		sdl2deviceprober.h
sdl2ffbconditioneffect.cpp		sdl2ffbconditioneffect.cpp
sdl2ffbconditioneffect.h		sdl2ffbconditioneffect.h
sdl2ffbconstanteffect.cpp		sdl2ffbconstanteffect.cpp
sdl2ffbconstanteffect.h		sdl2ffbconstanteffect.h
sdl2ffbdevice.cpp		sdl2ffbdevice.cpp
sdl2ffbdevice.h		sdl2ffbdevice.h
sdl2ffbeffect.cpp		sdl2ffbeffect.cpp
sdl2ffbeffect.h		sdl2ffbeffect.h
sdl2ffbeffectfactory.cpp		sdl2ffbeffectfactory.cpp
sdl2ffbeffectfactory.h		sdl2ffbeffectfactory.h
sdl2ffbperiodiceffect.cpp		sdl2ffbperiodiceffect.cpp
sdl2ffbperiodiceffect.h		sdl2ffbperiodiceffect.h
sdl2ffbrampeffect.cpp		sdl2ffbrampeffect.cpp
sdl2ffbrampeffect.h		sdl2ffbrampeffect.h

License

MadCatX/FFBChecker

Folders and files

Latest commit

History