Evsieve 项目教程

Evsieve 项目教程

evsieve A utility for mapping events from Linux event devices. 项目地址: https://gitcode.com/gh_mirrors/ev/evsieve

1. 项目介绍

Evsieve 是一个低级别的实用工具，用于从 Linux 事件设备（evdev）读取事件并将其写入虚拟事件设备（uinput），同时可以对事件进行简单的操作。Evsieve 特别适用于与 Qemu 的 evdev-passthrough 功能结合使用，但也可以用于其他目的。

Evsieve 的主要功能包括：

• 重新映射某些键盘按键到其他按键。
• 将某些键盘按键发送到一个虚拟设备，而将其他键盘按键发送到另一个虚拟设备。
• 将操纵杆转换为虚拟键盘。

2. 项目快速启动

2.1 安装依赖

在开始之前，您需要安装 Rust 工具链和 libevdev 库。以下是不同 Linux 发行版的安装命令：

• Ubuntu:

  sudo apt install cargo libevdev2 libevdev-dev
  

• Debian 12 (Bookworm):

  sudo apt install cargo libevdev2 libevdev-dev
  

• Debian 11 (Bullseye):

  sudo apt install rustc-mozilla cargo libevdev2 libevdev-dev
  

• Fedora:

  sudo dnf install cargo libevdev libevdev-devel
  

• Arch Linux:

  sudo pacman -S rust libevdev
  

2.2 编译和安装 Evsieve

获取源代码并编译程序：

wget https://github.com/KarsMulder/evsieve/archive/v1.4.0.tar.gz -O evsieve-1.4.0.tar.gz
tar -xzf evsieve-1.4.0.tar.gz && cd evsieve-1.4.0
cargo build --release

编译完成后，您可以在 target/release/evsieve 找到可执行文件。您可以将其复制到您的 PATH 中以便于使用：

sudo install -m 755 -t /usr/local/bin target/release/evsieve

2.3 基本使用

假设您有一个键盘，其事件设备的符号链接位于 /dev/input/by-id/keyboard，以下是一个基本的 Evsieve 使用示例：

evsieve --input /dev/input/by-id/keyboard grab --output

此命令将打开 /dev/input/by-id/keyboard 进行独占读取，读取事件并将其写入一个未命名的虚拟事件设备。

3. 应用案例和最佳实践

3.1 将 CapsLock 映射为 Backspace

以下脚本将 CapsLock 键映射为 Backspace 键：

evsieve --input /dev/input/by-id/keyboard grab \
        --map key:capslock key:backspace \
        --output

3.2 将操纵杆转换为虚拟键盘

Evsieve 还可以将操纵杆转换为虚拟键盘，以下是一个示例：

evsieve --input /dev/input/by-id/joystick grab \
        --map abs:x@1 key:left key:right \
        --map abs:y@1 key:up key:down \
        --output

4. 典型生态项目

Evsieve 通常与以下项目结合使用：

• Qemu: 用于虚拟化，特别是与 evdev-passthrough 功能结合使用。
• Xorg/Wayland: 用于处理输入事件的显示服务器。
• Python-evdev: 用于更复杂的事件操作和处理。

通过这些工具的结合使用，您可以实现更复杂的输入设备管理和映射。

evsieve A utility for mapping events from Linux event devices. 项目地址: https://gitcode.com/gh_mirrors/ev/evsieve