Evfilter library documentation
Evfilter library documentation
Profile is name for evfilter configuration. This configuration consit of
rules that are sayning which filter(s) to load for specific device and
parameters for these filters.
In a running system, there is one special, system profile, that should be
used for system wide configuration, this is especially suitable for
touchscreen callibration, persistent button renaming, and so on. This system
profile is located in /etc/evfilter/profile/ directory.
File profilerc is place for rules. There are four types of keywords accordingly to attributes listed in /proc/bus/input/devices and one special keyword used to load filters defined in file.
| Device |
Path to the input device in /dev filesystem. As a matter of fact
minor and major number are compared. Don't use this unless you really know what you are doing. Paths in /dev/ filesystem are dynamically allocated unless you use some udev magic. |
| Name |
Device name as it comes from the hardware. Usually something like
"ImPS/2 Logitech Wheel Mouse" or "AT Translated Set 2
keyboard" |
| Phys | Identifies specific connector in the computer the device is connected to. |
| Bits |
Identifies range of events that this device is able to generate. For
example relative coordinates. TODO: this is not correctly implemented yet. :( |
| File | File with filter(s) to load when rule was fulfilled. |
The generall syntax of file consist of lines, every line begins with one the
keywords followed by whitespace. The rest of the line till the newline
character is value for that keyword.
When any of rules before the first occurence of File keyword is
fulfilled, this file is loaded and filters defined in this file are attached
to the list of filters for this device.
In the following example file mouse.evf will be loaded for mouse connected to the ps2 connector and file set_keys.evf either for AT Translated keyboards or for asus extra buttons.
Phys isa0060/serio1/input0 File mouse.evf Name AT Translated Set 2 keyboard Name Asus EeePC extra buttons File set_keys.evf
Value for the File keyword in the previous paragraph is path to the
file containing list of filters to load and their parameters. This file
consist of blocks and each block defines one filter configuration starting
with FilterName = actual name and ending with EndFilter.
Enclosed betwen these two keywords there is a place for filter parameters.
Each filter has it's own parameters defined.
TODO: page with filters and parameters.
FilterName = SpeedMod
Xmod = 10
Ymod = 10
EndFilter