Windows 上 rusb write_interrupt 中的输入/输出错误

Question

我正在使用 rust、STM32 芯片、usb-device 和 < 构建一个小型“宏”风格键盘a href="https://docs.rs/usbd-hid" rel="nofollow noreferrer">usbd-hid。我的电脑正确检测到该设备，并且制造商字符串等在设备管理器中可见。我可以将该设备用作键盘。

但是，当我尝试使用 rusb 或 hidapi，它因 IO 错误而失败。当我调试 C 代码时，当它尝试 WriteFile 到 USB 设备时，会出现“访问被拒绝”错误。经过进一步研究，这似乎是一个 限制Windows，因为我无法访问 HID 鼠标和键盘，因为它们是系统保留的：

libusb 支持原生 Windows HID 驱动，但有一些限制，例如无法访问 HID 鼠标和键盘，因为它们是系统保留的

但是我找不到任何文档或示例来说明如何解决此问题 - 它似乎我应该能够在我的 USB 描述符中添加不完全由 Windows 持有的另一个配置、接口或端点。有人对从哪里开始有任何提示吗？

我当前的 USB 设备配置（使用 usbd-hid 的宏，如果需要的话我很乐意放弃）如下所示：

#[gen_hid_descriptor(
    (collection = APPLICATION, usage_page = GENERIC_DESKTOP, usage = KEYBOARD) = {
        (usage_page = KEYBOARD, usage_min = 0xE0, usage_max = 0xE7) = {
            #[packed_bits 8] #[item_settings data,variable,absolute] modifier=input;
        };
        (usage_min = 0x00, usage_max = 0xFF) = {
            #[item_settings constant,variable,absolute] reserved=input;
        };
        (usage_page = LEDS, usage_min = 0x01, usage_max = 0x05) = {
            #[packed_bits 5] #[item_settings data,variable,absolute] leds=output;
        };
        (usage_page = KEYBOARD, usage_min = 0x00, usage_max = 0xDD) = {
            #[item_settings data,array,absolute] keycodes=input;
        };
        (usage_page = 0xFF17, usage_min = 0x01, usage_max = 0xFF) = {
            #[item_settings data,variable,absolute] command=output;
        };
        (usage_page = 0xFF17, usage_min = 0x01, usage_max = 0xFF) = {
            #[item_settings data,variable,absolute] data=output;
        };
    }
)]
#[allow(dead_code)]
pub struct CustomKeyboardReport {
    pub modifier: u8,
    pub reserved: u8,
    pub leds: u8,
    pub keycodes: [u8; 6],
    pub command: u8,
    pub data: u8,
}

生成的描述符如下所示

0x05 0x01 0x09 0x06 0xA1 0x01 0x05 0x07
0x19 0xE0 0x29 0xE7 0x15 0x00 0x25 0x01
0x75 0x01 0x95 0x08 0x81 0x02 0x19 0x00
0x29 0xFF 0x26 0xFF 0x00 0x75 0x08 0x95
0x01 0x81 0x03 0x05 0x08 0x19 0x01 0x29
0x05 0x25 0x01 0x75 0x01 0x95 0x05 0x91
0x02 0x95 0x03 0x91 0x03 0x05 0x07 0x19
0x00 0x29 0xDD 0x26 0xFF 0x00 0x75 0x08
0x95 0x06 0x81 0x00 0x06 0x17 0xFF 0x19
0x01 0x29 0xFF 0x95 0x01 0x91 0x02 0x06
0x17 0xFF 0x19 0x01 0x29 0xFF 0x91 0x02
0xC0

相关： 1

Answer 1

我通过创建一个单独的报告解决了这个问题：

#[gen_hid_descriptor(
    (collection = LOGICAL, usage_page = VENDOR_DEFINED_START, usage = 0x00) = {
        (usage_page = 0xFF17, usage_min = 0x01, usage_max = 0xFF) = {
            #[item_settings data,array,absolute] command=output;
        };
    }
)]
pub struct CommandReport {
    pub command: [u8; 2],
}

然后我创建了一个单独的 HID 接口，只有一个 OUT 端点：

// for the keyboard
let hid = HIDClass::new(&alloc, CustomKeyboardReport::desc(), 10);

// for comms from the host -> device
let command = HIDClass::new_ep_out(&alloc, CommandReport::desc(), 10); 

在我的 poll 函数中，我检查了两个：

bus.poll(&mut [&mut hid, &mut command])

然后我可以读取通过提取原始输出来获取数据：

let mut buffer: [u8; 64] = [0; 64];
match command.pull_raw_output(&mut buffer) {
     Ok(size) => handleCommand(buffer, size),
     Err(UsbError::WouldBlock) => {
         // no pending data
     }
     Err(err) => panic!("Error receiving data {:?}", err),
}

由于只有 1 个报告 ID，因此我不必在使用 libusb 从主机发送的数据中添加 reportId。