罗技 HID++ 设备非官方驱动 LogiOps 安装与使用指南

罗技 HID++ 设备非官方驱动 LogiOps 安装与使用指南

logiopsAn unofficial userspace driver for HID++ Logitech devices项目地址:https://gitcode.com/gh_mirrors/lo/logiops

1. 项目目录结构及介绍

LogiOps 的项目目录结构如下：

.
├── apps         // 包含示例应用，如 logid 示例服务
├── doc          // 文档资料
├── include      // 头文件
├── lib           // 库文件
├── src           // 源代码
│   ├── apps       // 应用程序源码
│   ├── core       // 核心组件源码
│   └── tests      // 单元测试源码
└── tools         // 辅助工具

核心组件包括 libhidpp 和 libhidpp-tools，它们提供了与 HID++ 设备交互的功能。apps/logid 是驱动服务，负责设备的连接和事件处理。

2. 项目的启动文件介绍

启动 LogiOps 驱动服务主要涉及以下两个文件：

• apps/logid: 这是主服务程序，负责监听并处理来自罗技 HID++ 设备的输入。
• /etc/logiops/config.json: 配置文件，用于定制按键行为和手势。

要启动服务，通常需要执行以下命令（假设您已安装 LogiOps）：

sudo logid

为了使其在系统启动时自动运行，可以使用 systemd 设置服务守护进程：

sudo systemctl enable --now logid

3. 项目的配置文件介绍

配置文件位于 /etc/logiops/config.json，这个 JSON 文件定义了各个设备的自定义配置。例如：

{
    "devices": [
        {
            "name": "MX Master 3",
            "model": "mxmaster3",
            "scrollwheel": {
                "mode": "hi-res"
            },
            "gestures": [
                {
                    "button": 8,
                    "direction": "Up",
                    "mode": "Press",
                    "action": [
                        { "type": "Keypress", "keys": ["KEY_LEFTMETA", "KEY_UP"] }
                    ]
                },
                ...
            ],
            "buttons": [
                ...
            ]
        }
    ],
    ...
}

• name: 自定义设备名称。
• model: 设备型号，如 mxmaster3 对应 MX Master 3 鼠标。
• scrollwheel: 滚轮模式，如 hi-res 表示高分辨率滚动。
• gestures: 手势配置，包括按钮、方向、触发方式（按下或释放）以及对应的按键组合。
• buttons: 按钮配置，类似手势配置，定义了每个按钮的自定义动作。

每个设备的配置可以根据具体需求进行调整，以实现个性化的按键映射和手势操作。

请注意，如果您遇到任何问题，可以参考项目 README 或者官方 GitHub 页面上的更新日志，寻求解决方案或报告问题。另外，确保您的系统满足所有依赖项，并保持软件版本是最新的。

logiopsAn unofficial userspace driver for HID++ Logitech devices项目地址:https://gitcode.com/gh_mirrors/lo/logiops