触控笔（Pen Digitizer）HID报告描述符

2025-10-10 本文链接为:http://www.usbzh.com/article/detail-1593.html ,欢迎转载，转载请附上本文链接。

0x05, 0x0D,        // Usage Page (Digitizer)
0x09, 0x01,        // Usage (Digitizer)
0xA1, 0x01,        // Collection (Application)
0x85, 0x01,        //   Report ID (1)
0x09, 0x02,        //   Usage (Pen)
0xA1, 0x00,        //   Collection (Physical)
0x15, 0x00,        //     Logical Minimum (0)
0x25, 0x01,        //     Logical Maximum (1)
0x75, 0x01,        //     Report Size (1)
0x09, 0x42,        //     Usage (Tip Switch)
0x09, 0x44,        //     Usage (Barrel Switch)
0x09, 0x45,        //     Usage (Eraser)
0x09, 0x3C,        //     Usage (Invert)
0x95, 0x04,        //     Report Count (4)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x95, 0x01,        //     Report Count (1)
0x81, 0x03,        //     Input (Const,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x09, 0x32,        //     Usage (In Range)
0x95, 0x01,        //     Report Count (1)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x95, 0x02,        //     Report Count (2)
0x81, 0x03,        //     Input (Const,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x05, 0x01,        //     Usage Page (Generic Desktop Ctrls)
0x15, 0x00,        //     Logical Minimum (0)
0x35, 0x00,        //     Physical Minimum (0)
0x65, 0x11,        //     Unit (System: SI Linear, Length: Centimeter)
0x55, 0x0F,        //     Unit Exponent (-1)
0x75, 0x10,        //     Report Size (16)
0x95, 0x01,        //     Report Count (1)
0x09, 0x30,        //     Usage (X)
0x26, 0x38, 0x63,  //     Logical Maximum (25400)
0x45, 0x73,        //     Physical Maximum (115)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x09, 0x31,        //     Usage (Y)
0x26, 0x03, 0x3E,  //     Logical Maximum (15875)
0x45, 0x48,        //     Physical Maximum (72)
0x95, 0x01,        //     Report Count (1)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x65, 0x00,        //     Unit (None)
0x55, 0x00,        //     Unit Exponent (0)
0x05, 0x0D,        //     Usage Page (Digitizer)
0x09, 0x30,        //     Usage (Tip Pressure)
0x15, 0x00,        //     Logical Minimum (0)
0x26, 0xFF, 0x1F,  //     Logical Maximum (8191)
0x75, 0x10,        //     Report Size (16)
0x95, 0x01,        //     Report Count (1)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x09, 0x3D,        //     Usage (X Tilt)
0x16, 0xD8, 0xDC,  //     Logical Minimum (-9000)
0x26, 0x28, 0x23,  //     Logical Maximum (9000)
0x75, 0x10,        //     Report Size (16)
0x95, 0x01,        //     Report Count (1)
0x55, 0x0E,        //     Unit Exponent (-2)
0x65, 0x14,        //     Unit (System: English Rotation, Length: Centimeter)
0x36, 0xD8, 0xDC,  //     Physical Minimum (-9000)
0x46, 0x28, 0x23,  //     Physical Maximum (9000)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0x09, 0x3E,        //     Usage (Y Tilt)
0x16, 0xD8, 0xDC,  //     Logical Minimum (-9000)
0x26, 0x28, 0x23,  //     Logical Maximum (9000)
0x75, 0x10,        //     Report Size (16)
0x95, 0x01,        //     Report Count (1)
0x55, 0x0E,        //     Unit Exponent (-2)
0x65, 0x14,        //     Unit (System: English Rotation, Length: Centimeter)
0x36, 0xD8, 0xDC,  //     Physical Minimum (-9000)
0x46, 0x28, 0x23,  //     Physical Maximum (9000)
0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)
0xC0,              //   End Collection
0xC0,              // End Collection

触控笔描述符（Report ID 1）

从 0x05, 0x0D 到 0xC0, 0xC0 是描述触控笔功能的部分，使用的是报告 ID 1。

1.1. 基本描述

0x05, 0x0D        // Usage Page (Digitizer): 使用 Digitizer（数位板/触控笔）功能页
0x09, 0x01        // Usage (Digitizer): 使用 Digitizer 功能
0xA1, 0x01        // Collection (Application): 开始一个应用集合

1.2. 开关功能（Tip Switch, Barrel Switch, Eraser, Invert）

0x85, 0x01        // Report ID (1): 报告 ID 为 1
0x09, 0x02        // Usage (Pen): 使用 Pen（触控笔）
0xA1, 0x00        // Collection (Physical): 开始一个物理集合
0x09, 0x42        // Usage (Tip Switch): 笔尖开关（即触摸状态）
0x09, 0x44        // Usage (Barrel Switch): 侧键开关
0x09, 0x45        // Usage (Eraser): 橡皮擦开关
0x09, 0x3C        // Usage (Invert): 翻转检测

这部分定义了触控笔的各种开关，如笔尖、侧键、橡皮擦和翻转状态

1.3. 位置输入（X, Y 坐标）

0x05, 0x01        // Usage Page (Generic Desktop Ctrls): 通用桌面控制
0x09, 0x30        // Usage (X): X 轴坐标
0x09, 0x31        // Usage (Y): Y 轴坐标
0x26, 0x38, 0x63  // Logical Maximum (25400): X 坐标最大值为 25400
0x26, 0x03, 0x3E  // Logical Maximum (15875): Y 坐标最大值为 15875

1.4. 压力与倾斜输入（Tip Pressure, X Tilt, Y Tilt）

0x09, 0x30        // Usage (Tip Pressure): 笔尖压力
0x26, 0xFF, 0x1F  // Logical Maximum (8191): 压力最大值为 8191
0x09, 0x3D        // Usage (X Tilt): X 轴倾斜
0x09, 0x3E        // Usage (Y Tilt): Y 轴倾斜
0x16, 0xD8, 0xDC  // Logical Minimum (-9000): 倾斜最小值 -9000
0x26, 0x28, 0x23  // Logical Maximum (9000): 倾斜最大值 9000

笔尖压力为 16 位输入，逻辑范围是 0-8191。
倾斜输入（X Tilt, Y Tilt）也为 16 位，范围为 -9000 到 9000。

报告 ID 1 是用于触控笔（Digitizer）的输入：

包含按钮状态（笔尖、侧键、橡皮擦）、X 和 Y 坐标、笔尖压力、X 和 Y 倾斜。

本文链接为:http://www.usbzh.com/article/detail-1593.html ,欢迎转载，转载请附上本文链接。

原文转自：https://blog.csdn.net/lonelyxxyo/article/details/143719273

HID人机交互QQ群：564808376 UAC音频QQ群：218581009 UVC相机QQ群：331552032 BOT&UASP大容量存储QQ群：258159197 STC-USB单片机QQ群：315457461 USB技术交流QQ群2:580684376 USB技术交流QQ群：952873936

头戴式耳机控制报告描述符示例

0 篇笔记写笔记

USB复合HID设备报告描述符的区分

在USB规范中，设备的功能是通过接口来承载的，在USB规格书中就是接口描述符。对于一般的设备，一般一个接口就是一个功能，这个功能可以是鼠标，键盘或其它设备类型。当然这个只是对USB简易设备而言的，对于一些USB复杂设备如UVC摄像头，UAC音频等是多接口相互配合来实现其功能的，为了整合这么多接口使......

HID报告描述符详解

HID的报告描述符和其它描述符不一样，不是具有固定的数据结构，而是由固件开发商根据上报的数据自行组装的。这个组装的原材料是HID规范定义的ITEM。所以说HID报告描述符就像搭积木一样，其最终的数据结构和设计图纸是什么，都是由固件开发商决定的，但是其最终的产品又是由HID规范提供的各个标准积木模块搭......

USB键盘报告描述符数据格式分析

USB键盘的HID报表描述符的内容参见下表。数据的输入端点为中断方式，当有键盘敲击事件时，会上报数据长度为8字节的数据报告。0x05,0x01,// Global Generic Desktop0x09,0x06,// Local KeyBoard 0xA1,0x01,// Main app col......

USB鼠标HID报告描述符数据格式分析

注意：这里的鼠标为普通鼠标报告描述符的信息解释，其并不适用于全鼠标报表描述符。一个示例如下：0x05,0x01, // Global Generic Desktop0x09,0x02, // Local Mouse0xa1,0x01, // Main app collection0x09,......

USB中文网出品-HID报告描述符分析工具

HidReportParser.exe工具已经网页化，可访问http://www.usbzh.com/tool/usb.html 在线分析USB-HID报告描述符USB HID规范中有一个很重要的概念，就是HID的报告描述符。本人搞了这么久的HID设备开发，其中一项最头疼的是HID报告描述符的......

HID 报表描述符/报告描述符

报表描述符用于描述USB HID设备与主机之间数据交互的格式。根据数据的传输方向，分为输入报告和输出报告。输入报告是USB设备发送数据给主机的。大部分的USB HID设备主要实现的是输入报告。如我们平常使用的USB鼠标，就是通过我们点击鼠标按键或滑动鼠标流轮实现给主机上报鼠标的报告信息。输出报告......

HID报告描述符协议

HID报告描述符通过报告描述符的条目定义了HID报告数据的格式。对于大部分的HID设备来说，数据的传输方向都是输入的，即使用输入端点数据从设备端到主机端，并且使用的是中断的方式。当然HID设备不仅仅为数据的输入，有时也需要数据的输出。这时就需要一个输出中断端点来实现。报告描述符包含了属于特定Rep......

USB官网HID报告描述符生成工具

USB规范官网提供了一个HID报告描述符生成工具，https://www.usb.org/document-library/hid-descriptor-tool 使用我们此工具，我们可以：创建、编辑和验证HID报告描述符。输出多种输出（.txt、.inc、.h等）查看一些标准的设备报告描述符......

VS2019分析HID报告描述符解析源代码

常有人问，有没有HID解析的工具，好像除了usb官网提供的dt.exe,没有其它的好的东东了。Linux下有相关的工具，在本站的社区里：http://www.usbzh.com/zone/detail-12.html 可以查看做HID开发，其实最麻烦的就是HID报表描述符了。这里本人移植了Reac......

HID报告描述符Report Descriptor解析分析

HID独有的报告描述符也叫报表描述符对于初学者来说比较复杂，但是如果真正理解了它，我们又不得不惊吧于设计者的巧妙设计。HID报告描述符是由一系列的条目(item)组成的，一个item一般是又包括头部信息（bTag,bType,bSize)和数据内容。所以说item在HID的报告描述符中是最小的信息单......

HID报告描述符Usage

Usage是HID报告描述符的一部分，用于应用开发人员提供有关控制测量内容的信息。Usage标签指示了设备供应商对其设备的控制或者设备控制组的特定用途建议。例如虽然报告描述符中定义了数据格式（例如，三个 8 位字段），但使用Usages定义了应对数据执行的操作含义，例如 x、y 和 z 输入。此功......

HID报告描述符分类大全

下表列出的是全部的项目的前缀字和简要功能说明。项目类型项目标志（Tag）项目前缀，nn为数据长度功能说明MainInput8x1000 00 nn定义输入报表，主机利用该信息解析设备提供的数据。主机向控制端口发送Get_Report实现输入MainOutpu......

HID音量控制报告描述符

音量控制HID规范提供了两种报告描述符，分别对应按钮式和旋钮式。Up/Down 按钮音量控制下面的示例定义了一对按钮，用于渐变变量，例如音量增大和音量向下按钮。输入设备必须定义为相对设备。–1将减小音量+1将增大音量。0对音量没有影响。UsagePage(Consumer)Usage(Vol......

HID磁带滚轮按钮报告描述符

磁带滚轮按钮是一个弹簧式旋钮，可旋转 ±90°，用户食指有一个小凹痕。当用户向右或向左扭转旋钮时，磁带与从弹簧加载的中心位置的旋转成正比的速率前进或后退。UsagePage(Consumer)Usage(Tape Jog)Logical Minimum(-127),Logical Maxi......

HID 单元按钮报告描述符

单选按钮是一组相互排斥的按钮。在下面的示例中，音频接收器使用三个单选按钮在计算机、DVD 设备或万维网之间进行选择作为显示源。机械连接式单选接钮 Mechanically Linked Radio Buttons一般的，单选按钮实现有一个机械系统，它释放任何未按下的按钮，并将最后按下的按钮保持在活......