如何通过Python hidapi向HID输入设备写入数据？写入返回-1

1. 先理清HID报告类型与报告ID #

很多输入类HID设备（比如键盘、手写板这类）默认只允许主机读取数据，要下发指令得用输出报告或者特征报告。你写入失败大概率是这两个原因：

• 未携带正确的报告ID：HID数据包的第一个字节通常是报告ID，官方APP的抓包数据里肯定包含，要确保你的data数组开头和它完全一致
• 用错了报告类型：hidapi的write()默认发送输出报告，但有些设备只认特征报告，得改用send_feature_report()方法

2. 核对数据包格式细节 #

把你抓取的官方APP数据包和自己的data仔细对比：

• 数据包长度必须完全匹配：HID报告有固定长度，差一个字节都可能失败
• 校验位、命令标识要完全一致：比如你data里的0xB7、0x4B这类数值，可能是设备要求的校验码或命令标记，必须和抓包数据丝毫不差

3. 优先尝试特征报告发送 #

很多输入设备的控制指令都是通过特征报告传输的，直接把代码里的h.write(data)换成h.send_feature_report(data)，这是解决这类问题最常见的办法。

4. 检查设备权限与接口 #

• Windows下部分HID设备需要管理员权限才能写入，右键Python脚本选择「以管理员身份运行」试试
• 有些设备有多个HID接口，你用VID/PID打开的可能只是输入接口，得找到支持写入的接口。用hid.enumerate()列出所有接口，查看每个接口的usage_page和usage，筛选出对应控制功能的接口，再用h.open_path()打开它，代码示例里已包含这部分逻辑

官方APP的写入实现逻辑 #

官方APP不会依赖第三方库，而是直接调用Windows原生HID API（比如HidD_SetFeature、HidD_GetFeature这类）。它们会先读取设备的HID描述符，明确设备支持的报告类型、所需报告ID，然后严格按照设备的通信协议发送数据包，包括握手、校验这类细节都处理得很严谨。

修改后的测试代码 #

import hid

data = [0x80,0x07,0x05,0x05,0x00,0xb7,0x02,0x00,0x01,0x07,0x4b,0x09,0x64,0x00,0x00,0x00,0x5b,0x2f,0x58,0x77,0x10,0x00,0x00,0x00,0x50,0xf0,0x26,0x0f,0x00,0x90,0x2f,0x03,0x50,0x03,0x03,0x0f,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x4b,0x09,0x02,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x02,0x00,0x00,0x00,0x00,0x00,0x4b,0x09]

try:
    print("打开设备")
    h = hid.device()
    
    # 枚举所有设备接口，筛选正确的控制接口
    devices = hid.enumerate(0x047A, 0x1004)
    if not devices:
        print("未找到设备接口")
        exit()
    # 可根据usage_page/usage进一步筛选，这里先取第一个尝试
    target_path = devices[0]['path']
    h.open_path(target_path)
    
    print(f"厂商: {h.get_manufacturer_string()}")
    print(f"产品: {h.get_product_string()}")
    
    # 先尝试发送特征报告
    print("发送特征报告")
    result = h.send_feature_report(data)
    print(f"发送结果: {result}")
    
    # 如果特征报告失败，再尝试输出报告
    print("发送输出报告")
    result = h.write(data)
    print(f"发送结果: {result}")

except IOError as ex:
    print(f"错误: {ex}")
finally:
    h.close()

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