logiops，在 Linux下设置罗技鼠标的按键和手势

众所周知，几乎所有的消费级电子产品都不会对 Linux 有太好的支持，罗技当然也不例外。Logitech Options 是罗技办公鼠标的自定义功能驱动，很容易猜到，罗技只提供了Windows和Mac版本。但幸运的是，有人开发出了一个第三方的驱动：logiops 项目地址

logiops专门为罗技办公鼠标开发，目前已经测试和适配了MX Master 3 ,MX Master 2S ,MX Master ,MX Anywhere S2 ,MX Anywhere 3 ,MX Vertical ,MX Ergo ,M720 ,M590 ,T400 ,MX Keys。该驱动是以服务的形式运行，设定好配置文件后，启动logid服务运行于后台，就可以实现自定义手势和按键映射。服务可以设为开机自启动。

安装

依赖

(这篇文章于21年发布，但是该项目一直在更新，现在需要c++20编译器。详细指南请以项目主页为准。项目地址)

项目需要c++ 20 编译器，需要安装 cmake，libevdev，libudev，libconfig等。对于Ubuntu，直接执行sudo apt install build-essential cmake pkg-config libevdev-dev libudev-dev libconfig++-dev libglib2.0-dev

编译安装

克隆仓库到本地

git clone https://github.com/PixlOne/logiops.git

进入目录

cd logiops

编译项目，依次运行以下每行命令。

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

安装

sudo make install

设定为守护进程开机启动

sudo systemctl enable --now logid

平常查看运行状态

sudo service logid status

出现问题时重启，这可以解决大部分问题。

sudo service logid restart

配置文件

配置文件位于/etc/logid.cfg，这个文件我不记得是否需要手动创建，如果没有的话自己创建一个。官方的配置文件语法详解参考 https://github.com/PixlOne/logiops/wiki/Configuration。

配置中，每个鼠标按键通过一个cid表示，鼠标按键的cid值可以参考项目页面知道(CIDs)，或是通过debug模式查看。debug模式启动的方法是，先停止服务sudo service logid stop，然后sudo logid -v，此时以应该能看见下列输出，如果看不见，可以尝试重新连接鼠标到电脑。这样就能知道你鼠标上有什么按键了。

[DEBUG] Ignoring virtual node on /dev/hidraw4
[DEBUG] Ignoring virtual node on /dev/hidraw3
[INFO] Detected receiver at /dev/hidraw0
[DEBUG] Unsupported device /dev/hidraw1 ignored
[DEBUG] Unsupported device /dev/hidraw2 ignored
[DEBUG] Unsupported device /dev/hidraw5 ignored
[INFO] Device found: M720 Triathlon Multi-Device Mouse on /dev/hidraw0:2
[DEBUG] /dev/hidraw0:2 remappable buttons:
[DEBUG] CID  | reprog? | fn key? | mouse key? | gesture support?
[DEBUG] 0x50 |         |         | YES        |
[DEBUG] 0x51 |         |         | YES        |
[DEBUG] 0x52 | YES     |         | YES        | YES
[DEBUG] 0x53 | YES     |         | YES        | YES
[DEBUG] 0x56 | YES     |         | YES        | YES
[DEBUG] 0x5b | YES     |         | YES        | YES
[DEBUG] 0x5d | YES     |         | YES        | YES
[DEBUG] 0xd0 | YES     |         | YES        | YES
[DEBUG] 0xd7 | YES     |         |            | YES

下面这个是我的配置文件。我用的是罗技的M720鼠标。这里说一个冷知识，Windows和Linux上统一的复制和粘贴的快捷键是Ctrl+Insert和Shift+Insert，这个快捷键不区分图形软件和命令行软件

按键的配置是，侧键1：CTRL（按住侧键就代表按住CTRL）；侧键2：SHIFT；往左按滚轮：CTRL+PageUp（网页切换左页面）；往右按滚轮：CTRL+PageDown。
手势按键的配置是，按下：回车；往左：复制（CTRL+INSERT）；往右：粘贴（SHIFT+INSERT）；往上：音量+；往下：音量-。
滚轮配置是：启用高分辨率滚轮hires: true;，不启用反向滚轮invert: false;，如果滚轮不设其他功能，设定target: false;。

注意，如果你使用的屏幕DPI非常高，不是分辨率，是DPI。启用了高分辨率滚轮会导致滚轮速度非常块，可以关闭调整回正常的速度。

devices: (
{
    name: "M720 Triathlon Multi-Device Mouse";
    buttons: (
        {
            cid: 0x56;
            action =
            {
                type: "Keypress";
                keys: ["KEY_LEFTCTRL"];
            };
        },
        {
            cid: 0x53;
            action =
            {
                type: "Keypress";
                keys: ["KEY_LEFTSHIFT"];
            };
        },
        {
            cid: 0x5b;
            action =
            {
                type: "Keypress";
                keys:["KEY_LEFTCTRL","KEY_PAGEUP"];
            };
        },
        {
            cid: 0x5d;
            action =
            {
                type: "Keypress";
                keys:["KEY_LEFTCTRL","KEY_PAGEDOWN"];
            };
        },
        {
            cid: 0xd0;
            action =
            {
                type: "Gestures";
                gestures:(
                {
                    direction:"Up";
                    mode="OnInterval";
                    interval=75;
                    action=
                    {
                        type:"Keypress";
                        keys:["KEY_VOLUMEUP"];
                    }
                },
                {
                    direction:"Down";
                    mode="OnInterval";
                    interval=75;
                    action=
                    {
                        type:"Keypress";
                        keys:["KEY_VOLUMEDOWN"];
                    }
                },
                {
                    direction:"Left";
                    mode="OnRelease";
                    action=
                    {
                        type:"Keypress";
                        keys:["KEY_LEFTCTRL","KEY_C"];
                    }
                },
                {
                    direction:"Right";
                    mode="OnRelease";
                    action=
                    {
                        type:"Keypress";
                        keys:["KEY_LEFTCTRL","KEY_V"];
                    }
                },
                {
                    direction:"None";
                    mode="OnRelease";
                    action=
                    {
                        type:"Keypress";
                        keys:["KEY_ENTER"];
                    }
                }
                )
            };
        }

    );
    hiresscroll:
    {
        hires: true;
        invert: false;
        target: false;
    };
}
);

问题排查

项目官方的 github README.md 和 wiki 我没找到错误排查指南，只看到 issue 区普遍会通过logid -v命令，以 Debug 模式启动，贴上日志。当然，如果要启动 Debug 模式，首先要sudo service logid stop停止服务，再通过logid -v以 Debug 模式启动。

获得 Debug 模式的日志后，如果无法看懂，建议将解决不了的问题连同日志，发上项目 github 页面 issus 区。