evdev 项目技术文档

evdev 项目技术文档

python-evdev Python bindings for the Linux input subsystem 项目地址: https://gitcode.com/gh_mirrors/py/python-evdev

1. 安装指南

1.1 系统要求

• 操作系统：Linux
• Python 版本：>= 3.6

1.2 安装步骤

1.2.1 使用 pip 安装

pip install evdev

1.2.2 从源码安装

1. 克隆项目仓库：

   git clone https://github.com/gvalkov/python-evdev.git
   

2. 进入项目目录：

   cd python-evdev
   

3. 安装依赖并构建项目：

   python setup.py install
   

2. 项目使用说明

2.1 概述

evdev 是一个 Python 包，提供了对 Linux 内核中通用输入事件接口的绑定。通过 evdev，用户可以直接从 /dev/input/ 目录下的字符设备读取和写入输入事件。此外，evdev 还提供了对 uinput 的绑定，允许用户在用户空间创建和管理输入设备。

2.2 快速开始

以下是一个简单的示例，展示如何列出系统中可访问的输入设备：

import evdev

devices = [evdev.InputDevice(path) for path in evdev.list_devices()]
for device in devices:
    print(device.path, device.name, device.phys)

2.3 读取事件

以下示例展示如何从设备读取事件：

from evdev import InputDevice, categorize, ecodes

device = InputDevice('/dev/input/event0')

for event in device.read_loop():
    if event.type == ecodes.EV_KEY:
        print(categorize(event))

3. 项目 API 使用文档

3.1 主要类和方法

3.1.1 InputDevice

• __init__(path): 初始化输入设备对象。
• path: 设备路径。
• name: 设备名称。
• phys: 设备的物理路径。
• read_loop(): 读取设备事件的循环。

3.1.2 InputEvent

• timestamp(): 事件的时间戳。
• type: 事件类型。
• code: 事件代码。
• value: 事件值。

3.1.3 uinput

• UInput(): 创建一个 uinput 设备。
• write_event(event): 向 uinput 设备写入事件。

3.2 示例

以下示例展示如何创建一个 uinput 设备并注入事件：

from evdev import UInput, ecodes as e

ui = UInput()

# 模拟按键事件
ui.write(e.EV_KEY, e.KEY_A, 1)  # 按下 'A' 键
ui.write(e.EV_KEY, e.KEY_A, 0)  # 释放 'A' 键
ui.syn()

4. 项目安装方式

4.1 使用 pip 安装

pip install evdev

4.2 从源码安装

1. 克隆项目仓库：

   git clone https://github.com/gvalkov/python-evdev.git
   

2. 进入项目目录：

   cd python-evdev
   

3. 安装依赖并构建项目：

   python setup.py install
   

通过以上步骤，您可以成功安装并使用 evdev 项目，进行输入事件的读取和处理。

python-evdev Python bindings for the Linux input subsystem 项目地址: https://gitcode.com/gh_mirrors/py/python-evdev