mirror of
https://github.com/NixOS/nixpkgs.git
synced 2024-12-26 07:34:11 +00:00
ef176dcf7e
conversions were done using https://github.com/pennae/nix-doc-munge using (probably) rev f34e145 running nix-doc-munge nixos/**/*.nix nix-doc-munge --import nixos/**/*.nix the tool ensures that only changes that could affect the generated manual *but don't* are committed, other changes require manual review and are discarded.
292 lines
10 KiB
Nix
292 lines
10 KiB
Nix
{ config, lib, pkgs, ... }:
|
||
|
||
with lib;
|
||
|
||
let cfg = config.services.xserver.libinput;
|
||
|
||
xorgBool = v: if v then "on" else "off";
|
||
|
||
mkConfigForDevice = deviceType: {
|
||
dev = mkOption {
|
||
type = types.nullOr types.str;
|
||
default = null;
|
||
example = "/dev/input/event0";
|
||
description =
|
||
lib.mdDoc ''
|
||
Path for ${deviceType} device. Set to `null` to apply to any
|
||
auto-detected ${deviceType}.
|
||
'';
|
||
};
|
||
|
||
accelProfile = mkOption {
|
||
type = types.enum [ "flat" "adaptive" ];
|
||
default = "adaptive";
|
||
example = "flat";
|
||
description =
|
||
lib.mdDoc ''
|
||
Sets the pointer acceleration profile to the given profile.
|
||
Permitted values are `adaptive`, `flat`.
|
||
Not all devices support this option or all profiles.
|
||
If a profile is unsupported, the default profile for this is used.
|
||
`flat`: Pointer motion is accelerated by a constant
|
||
(device-specific) factor, depending on the current speed.
|
||
`adaptive`: Pointer acceleration depends on the input speed.
|
||
This is the default profile for most devices.
|
||
'';
|
||
};
|
||
|
||
accelSpeed = mkOption {
|
||
type = types.nullOr types.str;
|
||
default = null;
|
||
example = "-0.5";
|
||
description = lib.mdDoc "Cursor acceleration (how fast speed increases from minSpeed to maxSpeed).";
|
||
};
|
||
|
||
buttonMapping = mkOption {
|
||
type = types.nullOr types.str;
|
||
default = null;
|
||
example = "1 6 3 4 5 0 7";
|
||
description =
|
||
lib.mdDoc ''
|
||
Sets the logical button mapping for this device, see XSetPointerMapping(3). The string must
|
||
be a space-separated list of button mappings in the order of the logical buttons on the
|
||
device, starting with button 1. The default mapping is "1 2 3 ... 32". A mapping of 0 deac‐
|
||
tivates the button. Multiple buttons can have the same mapping. Invalid mapping strings are
|
||
discarded and the default mapping is used for all buttons. Buttons not specified in the
|
||
user's mapping use the default mapping. See section BUTTON MAPPING for more details.
|
||
'';
|
||
};
|
||
|
||
calibrationMatrix = mkOption {
|
||
type = types.nullOr types.str;
|
||
default = null;
|
||
example = "0.5 0 0 0 0.8 0.1 0 0 1";
|
||
description =
|
||
lib.mdDoc ''
|
||
A string of 9 space-separated floating point numbers. Sets the calibration matrix to the
|
||
3x3 matrix where the first row is (abc), the second row is (def) and the third row is (ghi).
|
||
'';
|
||
};
|
||
|
||
clickMethod = mkOption {
|
||
type = types.nullOr (types.enum [ "none" "buttonareas" "clickfinger" ]);
|
||
default = null;
|
||
example = "buttonareas";
|
||
description =
|
||
lib.mdDoc ''
|
||
Enables a click method. Permitted values are `none`,
|
||
`buttonareas`, `clickfinger`.
|
||
Not all devices support all methods, if an option is unsupported,
|
||
the default click method for this device is used.
|
||
'';
|
||
};
|
||
|
||
leftHanded = mkOption {
|
||
type = types.bool;
|
||
default = false;
|
||
description = lib.mdDoc "Enables left-handed button orientation, i.e. swapping left and right buttons.";
|
||
};
|
||
|
||
middleEmulation = mkOption {
|
||
type = types.bool;
|
||
default = true;
|
||
description =
|
||
lib.mdDoc ''
|
||
Enables middle button emulation. When enabled, pressing the left and right buttons
|
||
simultaneously produces a middle mouse button click.
|
||
'';
|
||
};
|
||
|
||
naturalScrolling = mkOption {
|
||
type = types.bool;
|
||
default = false;
|
||
description = lib.mdDoc "Enables or disables natural scrolling behavior.";
|
||
};
|
||
|
||
scrollButton = mkOption {
|
||
type = types.nullOr types.int;
|
||
default = null;
|
||
example = 1;
|
||
description =
|
||
lib.mdDoc ''
|
||
Designates a button as scroll button. If the ScrollMethod is button and the button is logically
|
||
held down, x/y axis movement is converted into scroll events.
|
||
'';
|
||
};
|
||
|
||
scrollMethod = mkOption {
|
||
type = types.enum [ "twofinger" "edge" "button" "none" ];
|
||
default = "twofinger";
|
||
example = "edge";
|
||
description =
|
||
lib.mdDoc ''
|
||
Specify the scrolling method: `twofinger`, `edge`,
|
||
`button`, or `none`
|
||
'';
|
||
};
|
||
|
||
horizontalScrolling = mkOption {
|
||
type = types.bool;
|
||
default = true;
|
||
description =
|
||
lib.mdDoc ''
|
||
Disables horizontal scrolling. When disabled, this driver will discard any horizontal scroll
|
||
events from libinput. Note that this does not disable horizontal scrolling, it merely
|
||
discards the horizontal axis from any scroll events.
|
||
'';
|
||
};
|
||
|
||
sendEventsMode = mkOption {
|
||
type = types.enum [ "disabled" "enabled" "disabled-on-external-mouse" ];
|
||
default = "enabled";
|
||
example = "disabled";
|
||
description =
|
||
lib.mdDoc ''
|
||
Sets the send events mode to `disabled`, `enabled`,
|
||
or `disabled-on-external-mouse`
|
||
'';
|
||
};
|
||
|
||
tapping = mkOption {
|
||
type = types.bool;
|
||
default = true;
|
||
description =
|
||
lib.mdDoc ''
|
||
Enables or disables tap-to-click behavior.
|
||
'';
|
||
};
|
||
|
||
tappingDragLock = mkOption {
|
||
type = types.bool;
|
||
default = true;
|
||
description =
|
||
lib.mdDoc ''
|
||
Enables or disables drag lock during tapping behavior. When enabled, a finger up during tap-
|
||
and-drag will not immediately release the button. If the finger is set down again within the
|
||
timeout, the draging process continues.
|
||
'';
|
||
};
|
||
|
||
transformationMatrix = mkOption {
|
||
type = types.nullOr types.str;
|
||
default = null;
|
||
example = "0.5 0 0 0 0.8 0.1 0 0 1";
|
||
description = lib.mdDoc ''
|
||
A string of 9 space-separated floating point numbers. Sets the transformation matrix to
|
||
the 3x3 matrix where the first row is (abc), the second row is (def) and the third row is (ghi).
|
||
'';
|
||
};
|
||
|
||
disableWhileTyping = mkOption {
|
||
type = types.bool;
|
||
default = false;
|
||
description =
|
||
lib.mdDoc ''
|
||
Disable input method while typing.
|
||
'';
|
||
};
|
||
|
||
additionalOptions = mkOption {
|
||
type = types.lines;
|
||
default = "";
|
||
example =
|
||
''
|
||
Option "DragLockButtons" "L1 B1 L2 B2"
|
||
'';
|
||
description = lib.mdDoc ''
|
||
Additional options for libinput ${deviceType} driver. See
|
||
{manpage}`libinput(4)`
|
||
for available options.";
|
||
'';
|
||
};
|
||
};
|
||
|
||
mkX11ConfigForDevice = deviceType: matchIs: ''
|
||
Identifier "libinput ${deviceType} configuration"
|
||
MatchDriver "libinput"
|
||
MatchIs${matchIs} "${xorgBool true}"
|
||
${optionalString (cfg.${deviceType}.dev != null) ''MatchDevicePath "${cfg.${deviceType}.dev}"''}
|
||
Option "AccelProfile" "${cfg.${deviceType}.accelProfile}"
|
||
${optionalString (cfg.${deviceType}.accelSpeed != null) ''Option "AccelSpeed" "${cfg.${deviceType}.accelSpeed}"''}
|
||
${optionalString (cfg.${deviceType}.buttonMapping != null) ''Option "ButtonMapping" "${cfg.${deviceType}.buttonMapping}"''}
|
||
${optionalString (cfg.${deviceType}.calibrationMatrix != null) ''Option "CalibrationMatrix" "${cfg.${deviceType}.calibrationMatrix}"''}
|
||
${optionalString (cfg.${deviceType}.transformationMatrix != null) ''Option "TransformationMatrix" "${cfg.${deviceType}.transformationMatrix}"''}
|
||
${optionalString (cfg.${deviceType}.clickMethod != null) ''Option "ClickMethod" "${cfg.${deviceType}.clickMethod}"''}
|
||
Option "LeftHanded" "${xorgBool cfg.${deviceType}.leftHanded}"
|
||
Option "MiddleEmulation" "${xorgBool cfg.${deviceType}.middleEmulation}"
|
||
Option "NaturalScrolling" "${xorgBool cfg.${deviceType}.naturalScrolling}"
|
||
${optionalString (cfg.${deviceType}.scrollButton != null) ''Option "ScrollButton" "${toString cfg.${deviceType}.scrollButton}"''}
|
||
Option "ScrollMethod" "${cfg.${deviceType}.scrollMethod}"
|
||
Option "HorizontalScrolling" "${xorgBool cfg.${deviceType}.horizontalScrolling}"
|
||
Option "SendEventsMode" "${cfg.${deviceType}.sendEventsMode}"
|
||
Option "Tapping" "${xorgBool cfg.${deviceType}.tapping}"
|
||
Option "TappingDragLock" "${xorgBool cfg.${deviceType}.tappingDragLock}"
|
||
Option "DisableWhileTyping" "${xorgBool cfg.${deviceType}.disableWhileTyping}"
|
||
${cfg.${deviceType}.additionalOptions}
|
||
'';
|
||
in {
|
||
|
||
imports =
|
||
(map (option: mkRenamedOptionModule ([ "services" "xserver" "libinput" option ]) [ "services" "xserver" "libinput" "touchpad" option ]) [
|
||
"accelProfile"
|
||
"accelSpeed"
|
||
"buttonMapping"
|
||
"calibrationMatrix"
|
||
"clickMethod"
|
||
"leftHanded"
|
||
"middleEmulation"
|
||
"naturalScrolling"
|
||
"scrollButton"
|
||
"scrollMethod"
|
||
"horizontalScrolling"
|
||
"sendEventsMode"
|
||
"tapping"
|
||
"tappingDragLock"
|
||
"transformationMatrix"
|
||
"disableWhileTyping"
|
||
"additionalOptions"
|
||
]);
|
||
|
||
options = {
|
||
|
||
services.xserver.libinput = {
|
||
enable = mkEnableOption (lib.mdDoc "libinput");
|
||
mouse = mkConfigForDevice "mouse";
|
||
touchpad = mkConfigForDevice "touchpad";
|
||
};
|
||
};
|
||
|
||
|
||
config = mkIf cfg.enable {
|
||
|
||
services.xserver.modules = [ pkgs.xorg.xf86inputlibinput ];
|
||
|
||
environment.systemPackages = [ pkgs.xorg.xf86inputlibinput ];
|
||
|
||
environment.etc =
|
||
let cfgPath = "X11/xorg.conf.d/40-libinput.conf";
|
||
in {
|
||
${cfgPath} = {
|
||
source = pkgs.xorg.xf86inputlibinput.out + "/share/" + cfgPath;
|
||
};
|
||
};
|
||
|
||
services.udev.packages = [ pkgs.libinput.out ];
|
||
|
||
services.xserver.inputClassSections = [
|
||
(mkX11ConfigForDevice "mouse" "Pointer")
|
||
(mkX11ConfigForDevice "touchpad" "Touchpad")
|
||
];
|
||
|
||
assertions = [
|
||
# already present in synaptics.nix
|
||
/* {
|
||
assertion = !config.services.xserver.synaptics.enable;
|
||
message = "Synaptics and libinput are incompatible, you cannot enable both (in services.xserver).";
|
||
} */
|
||
];
|
||
|
||
};
|
||
|
||
}
|