Linux下Qt/C++实现虚拟键盘控制Capslock硬件LED亮灭

要实现虚拟Capslock按键同步控制硬件键盘的Capslock指示灯，核心是利用Linux输入子系统的设备节点发送LED控制事件，结合Qt的按键模拟实现系统状态同步，具体方案如下：

1. 定位目标输入设备节点 #

Linux下键盘LED状态由/dev/input/eventX设备节点控制，需先找到对应键盘的设备路径：

• 执行命令cat /proc/bus/input/devices，查找包含LEDs字段的键盘设备（通常名称类似"AT Translated Set 2 keyboard"）。
• 查看该设备的Handlers行，例如Handlers=sysrq kbd event3 leds，对应的设备路径即为/dev/input/event3。

2. 编写LED控制函数 #

通过系统调用向设备节点写入input_event结构体，直接控制Capslock指示灯：

#include <fcntl.h>
#include <linux/input.h>
#include <unistd.h>
#include <sys/time.h>
#include <iostream>
#include <cstring>

void setCapslockLed(bool enable) {
    // 替换为你找到的设备路径
    const char* devPath = "/dev/input/event3";
    int fd = open(devPath, O_WRONLY);
    if (fd == -1) {
        std::cerr << "打开输入设备失败: " << strerror(errno) << std::endl;
        return;
    }

    struct input_event ev{};
    ev.type = EV_LED;
    ev.code = LED_CAPSL; // Capslock LED对应的事件代码
    ev.value = enable ? 1 : 0; // 1=点亮，0=熄灭
    gettimeofday(&ev.time, nullptr); // 设置事件时间戳

    if (write(fd, &ev, sizeof(ev)) != sizeof(ev)) {
        std::cerr << "写入LED事件失败: " << strerror(errno) << std::endl;
    }

    close(fd);
}

3. 同步虚拟按键与系统Capslock状态 #

按下虚拟Capslock按键时，需同时触发系统状态切换和LED同步：

3.1 获取与切换系统Capslock状态 #

利用X11API获取当前Capslock状态，通过Qt模拟按键事件切换系统状态：

#include <QGuiApplication>
#include <QKeyEvent>
#include <X11/Xlib.h>
#include <X11/XKBlib.h>

// 获取当前Capslock激活状态
bool getCapslockState() {
    Display* dpy = XOpenDisplay(nullptr);
    if (!dpy) return false;
    bool state = XkbGetIndicatorState(dpy, XkbUseCoreKbd) & 0x01;
    XCloseDisplay(dpy);
    return state;
}

// 模拟Capslock按键按下/释放事件
void toggleSystemCapslock() {
    QKeyEvent press(QEvent::KeyPress, Qt::Key_CapsLock, Qt::NoModifier);
    QGuiApplication::sendEvent(QGuiApplication::focusWidget(), &press);
    
    QKeyEvent release(QEvent::KeyRelease, Qt::Key_CapsLock, Qt::NoModifier);
    QGuiApplication::sendEvent(QGuiApplication::focusWidget(), &release);
}

3.2 绑定虚拟按键信号 #

将虚拟Capslock按钮的clicked信号绑定到处理逻辑：

// 假设virtualCapslockBtn是你的虚拟按键对象
connect(virtualCapslockBtn, &QPushButton::clicked, this, [this]() {
    bool currentState = getCapslockState();
    bool newState = !currentState;
    
    // 切换系统Capslock状态
    toggleSystemCapslock();
    // 同步硬件LED指示灯
    setCapslockLed(newState);
});

4. 权限处理 #

普通用户默认无/dev/input/eventX的写入权限，可通过以下方式解决：

• 将当前用户加入input组：sudo usermod -aG input $USER，重新登录后生效。
• 临时以root权限运行程序（不推荐日常使用）。

5. 项目配置 #

若使用X11API获取Capslock状态，需在Qt项目的.pro文件中添加链接库：

LIBS += -lX11

内容的提问来源于stack exchange，提问作者James S