基于Wave Panel的HID设备通讯接口设计
摘 要：hid 设备研发和使用中所面临的重要问题之一是设备与主机应用程序的通讯。文中以视频编辑专用hid 设备wave panel 为基础，首先简要介绍了hid 设备的性能特点和windows 环境下的hid 通讯机制，在此基础上设计出一个实用的hid 设备通讯接口，该通讯接口利用相关windows api 函数实现对hid 设备的识别。打开和关闭，并以异步模式完成设备与主机应用程序的双向通讯过程，最后在wave panel 对该接口进行了编程实验。实验结果证明该接口的通用性较好，能够较好地实现hid 设备与主机应用程序的通讯功能。
引 言
hid（human interface device，人机接口设备）是一类低速usb 设备，典型的hid 设备有键盘。鼠标。游戏杆等。相对于u 盘。打印机等高速usb 设备，hid 设备具有使用方便。响应迅速。研发成本低廉等优点，其应用领域十分广泛。当前hid 设备正在向专用化方向快速发展 。
wave panel 是苹果公司研发的视频色彩编辑软件color 支持一型专用的数据输入和显示hid 设备，该设备面板上设置有按键。解码器和二维跟踪球三种控制器，能够快捷。精确地对各类视频色彩参数进行设置，并将控制和状态信息同步显示在设备微型显示屏上，从而改变了传统“鼠标+键盘”的视频编辑软件控制方式.wave panel 没有提供windows 环境下与应用程序通讯的功能，因此可基于wave panel 设计一个功能完备。通用性强的通讯接口，并加以验证。这对企业和科研机构根据实际需求灵活地配备和控制专用hid 设备有很大帮助。
1 wave panel 的性能特征
hid 设备除满足usb 标准外，还具备一些与人机交互密切相关的特点，主要包括：
1）通常使用控制方式或中断方式通讯。两种传输方式的区别在于控制方式适用于对延迟没有特别限制的数据，而中断方式适用于低延迟。周期性的数据 .wave panel 的数据传输方式为中断方式。
2）单次传输的数据量小，且这些数据以状态变化信息或控制信息为主。其中低速hid 设备单次传输数据最大为8 字节，全速设备为64 字节，高速设备为1024 字节。主机与hid 设备交换的数据存储在报表（report）结构内 。
wave panel 的输入报表长度为27 字节，其中0 字节用于记录报表id，1 ~ 6 字节的前41 比特分别记录41 个按键的按下或抬起状态，另有7 比特未用，置为0;7 ~19 字节分别记录13 个解码器的状态；20 ~25 字节每2 字节分别记录一个二维跟踪球x 轴和y 轴的状态；26 字节留作固件升级使用.wave panel 的输出报表长度为41 字节，其中0 ~ 5 字节为控制命令，6 ~ 40字节为显示信息的字符。
3）使用轮询方式检测设备状态变化情况.hid 设备可能在任何时刻向主机发送数据，例如鼠标发生移动或键盘有按键按下。所以hid 设备会在一个固定的时间间隔内轮询各控制口一次，当发现设备状态有变化时生成输入报表发送给主机 。但轮询的间隔时间要由用户对hid 设备的操作速度决定。如果间隔时间过小，则用户来不及在两次轮询间隔内完成一次操作；反之，又会使hid 设备的响应速度无法与用户的操作速度匹配，造成延迟 。
wave panel 规定，每40 毫秒对所有控制器端口轮询一次，若其中任何一个控制器的状态在两次轮询间隔内发生改变，就会在下次轮询前生成输入报表发送给主机.40 毫秒是基于视频每帧显示时间而确定的。
2 hid 设备的通讯过程
hid 设备是windows 操作系统最早支持的usb设备。在windows 98 及以后的各版本中都已内置了hid 设备的驱动程序，主机与hid 设备通讯时无须再编写专门的驱动程序。这就简化了hid 设备与主机应用程序通讯接口的设计和研发。
通过分析，可以将hid 设备与主机应用程序的通讯划分为设备识别和打开。读报表。写报表和设备关闭四个模块。
2. 1 wave panel 的识别和打开
hid 设备连接到主机后，以厂商id（vid）。产品id（pid）和产品版本号（pvn）三项属性值的组合作为设备唯一标识.wave panel 的三项属性值可以从产品说明书直接获取。由于一台主机可能同时连接有多台hid 设备，所以在通讯前应用程序必须要识别并打开wave panel，这一过程需要调用多个windows api函数实现。基本方法是首先获取当前与主机连接的所有hid 设备信息的集合，然后逐一枚举集合中的各设备，并比较vid.pid 和pvn 值。当三项属性值都与wave panel 相等时表示已经找到，调用createfile（）将该wave panel 打开，并保存wave panel 设备句柄。该模块的流程如图1 所示。
流程中调用的windows api 函数和结构体变量类型分别在hidpi. h.hidsdi. h.hidusage. h.setupapi. h 和hid. lib.setupapi. lib 几个文件中定义并实现 。主要包括：
1）hidd_gethidguid（ ）：获取hid 设备的guid值，并保存在一个guid 结构体变量中；
2）setupdigetclassdevs（）：根据hid 设备的guid值获取hid 设备信息的集合，并保存在一个hdevinfo结构体类型的变量中；
3）setupdienumdeviceinterfaces（）：在设备信息集合中依次获取编号为i（i = 0，1，…） 的设备接口信息，保存在一个sp_device_interface_data 结构体类型变量中；
4）setupdigetdeviceinterfacedetail（）：当获取设备接口信息成功时进一步获取该设备的详细信息，并保存设备路径；
5）hidd_getattributes（）：获取设备属性值并保存在一个hidd_attributes 结构体类型变量中.vid.pid 和pvn 值即为该结构体变量的三项成员；
6）setupdidestroydeviceinfolist（ ）：销毁设备信息集合。
2. 2 读报表
读报表是指hid 设备向主机输入数据。当wavepanel 面板上任意控制器状态发生变化时，都会在下一次轮询时将这些数据生成输入报表，并发送给主机。
主机上的应用程序接收输入报表并对数据进行解析，然后做出相应的处理。
由于wave panel 可能在任何时候与主机以中断方式进行通讯，因此应用程序需要维护一个异步调用的读报表线程。该线程在wave panel 没有向主机输入数据时阻塞，以减轻系统负载。当有数据输入时，线程恢复运行，调用readfile（）将输入数据保存在缓冲区中，并对数据进行解析。这之后线程将再次被阻塞，直到有新的输入数据到来。应用程序在wave panel成功打开后就创建读报表线程，应用程序运行结束前该线程将一直存在。读报表流程如图2 所示。
2. 3 写报表
与读报表相反，写报表是指主机向hid 设备输出数据。写报表对延迟的要求较高，但这一功能不是必需的，根据hid 设备的实际用途而定 。鼠标。键盘。游戏杆等较简单的设备只向主机发送数据，这些数据通常是一些控制信息和状态信息 ，例如改变hid 设备液晶屏上的显示信息。控制设备上发光元件的亮灭等。
应用程序的写报表线程流程与读报表线程类似，首先将要输出的数据按wave panel 规定的数据格式进行封装，复制到一个缓冲区内，再调用writefile（）将缓冲区数据输出到wave panel 即可，这些信息主要是与视频帧状态变化相关的信息。
2. 4 设备关闭
设备关闭模块功能比较简单。当主机与wavepanel 的通讯结束时，调用closehandle（ ） 将打开的wave panel 关闭即可。
3 wave panel 通讯接口的设计
以上述通讯过程为基础，设计一个名为chid-comm 的通讯接口，其总体框架为：
其中，成员函数opendevice（）和closedevice（）分别用于识别。打开和关闭wave panel.readreport-thread（）用于创建读报表线程。由于线程为异步方式执行，因此readreportthread（ ） 在调用readfile（ ） 时要使用一个overlapped 结构变量，该变量含有一个i/ o 完成后触发事件的句柄。当hid 设备没有向主机输入数据时，事件处于无信号状态，线程被阻塞；当有数据输入时，事件被触发，线程恢复运行，接收并将数据保存在读报表缓冲区，供数据解析函数使用.writereportthread（）与readreportthread（ ） 的功能类似，用于创建写报表线程。
成员变量vid.pid 和pvn 用于保存三项属性值，readbuffer 和writebuffer 分别定义读报表缓冲区和写报表缓冲区，其大小由hid 设备的输入报表和输出报表长度决定.s 实际上，该接口不仅可以用于wavepanel，同样也适用于其它hid 设备。只需要重新设置vid.pid 和pvn 值以及readbuffer.writebuffer 缓冲区的大小，而无须对识别。打开。读写报表等功能进行修改。
图3 是主机应用程序调用chidcomm 接口实现与wave panel 通讯的情况。以十六进制形式输出读报表缓冲区的值，并显示控制器状态变化情况。需要注意的一个重要问题是wave panel 输入报表并不使用报表id，在这种情况下应将读报表缓冲区readbuffer 的第0 字节设置为0×00，否则读报表线程将无法接收到输入报表。
4 结束语
wave panel 是一类较复杂的视频编辑hid 设备，没有提供windows 环境下的通讯功能。基于wavepanel 对windows 环境下的hid 设备通讯进行研究，能够解决许多unix.linux.mac 等操作系统支持的专用hid 设备无法在windows 环境下使用的问题。较之现有的一些解决方案，设计的chidcomm 接口具有较强的通用性，并可以方便地对功能进行扩展。今后的工作主要是扩展该接口在64 位windows 环境下的功能.
NZXT发布2款全新HUE2LED灯带产品 新增了微控制器
MEC应用环境真的成熟了吗
一种为倾角计子系统设计定制板支架的方法
中值滤波去除图像上存在孤立的噪声点
什么是GOPHER
基于Wave Panel的HID设备通讯接口设计
中国联通与5G网络共建共享顺利推进
C语言零基础项目：对对碰（消除类）游戏！详细思路+源码分享
分享几个大众的AGM、EFB蓄电池检测方法
研华推出专为批次控制设计的功能块
隔离变压器作用及应用
华为会不会像三星电子一样在多个领域取得成功？
比特大陆未来的发展规划探讨
聊聊芯片超净间的颗粒
谷歌等科技公司或与银行金融公司分享数据
USB双机通讯的原理
中国成为智能家居市场的主战场，跑马圈地竞争激烈
区块链里面的主角是谁
基于RC网络分相滤波器的镜频抑制混频器
vivoNEX3 5G曝光 屏占比高达99.6%？
引 言
hid（human interface device，人机接口设备）是一类低速usb 设备，典型的hid 设备有键盘。鼠标。游戏杆等。相对于u 盘。打印机等高速usb 设备，hid 设备具有使用方便。响应迅速。研发成本低廉等优点，其应用领域十分广泛。当前hid 设备正在向专用化方向快速发展 。
wave panel 是苹果公司研发的视频色彩编辑软件color 支持一型专用的数据输入和显示hid 设备，该设备面板上设置有按键。解码器和二维跟踪球三种控制器，能够快捷。精确地对各类视频色彩参数进行设置，并将控制和状态信息同步显示在设备微型显示屏上，从而改变了传统“鼠标+键盘”的视频编辑软件控制方式.wave panel 没有提供windows 环境下与应用程序通讯的功能，因此可基于wave panel 设计一个功能完备。通用性强的通讯接口，并加以验证。这对企业和科研机构根据实际需求灵活地配备和控制专用hid 设备有很大帮助。
1 wave panel 的性能特征
hid 设备除满足usb 标准外，还具备一些与人机交互密切相关的特点，主要包括：
1）通常使用控制方式或中断方式通讯。两种传输方式的区别在于控制方式适用于对延迟没有特别限制的数据，而中断方式适用于低延迟。周期性的数据 .wave panel 的数据传输方式为中断方式。
2）单次传输的数据量小，且这些数据以状态变化信息或控制信息为主。其中低速hid 设备单次传输数据最大为8 字节，全速设备为64 字节，高速设备为1024 字节。主机与hid 设备交换的数据存储在报表（report）结构内 。
wave panel 的输入报表长度为27 字节，其中0 字节用于记录报表id，1 ~ 6 字节的前41 比特分别记录41 个按键的按下或抬起状态，另有7 比特未用，置为0;7 ~19 字节分别记录13 个解码器的状态；20 ~25 字节每2 字节分别记录一个二维跟踪球x 轴和y 轴的状态；26 字节留作固件升级使用.wave panel 的输出报表长度为41 字节，其中0 ~ 5 字节为控制命令，6 ~ 40字节为显示信息的字符。
3）使用轮询方式检测设备状态变化情况.hid 设备可能在任何时刻向主机发送数据，例如鼠标发生移动或键盘有按键按下。所以hid 设备会在一个固定的时间间隔内轮询各控制口一次，当发现设备状态有变化时生成输入报表发送给主机 。但轮询的间隔时间要由用户对hid 设备的操作速度决定。如果间隔时间过小，则用户来不及在两次轮询间隔内完成一次操作；反之，又会使hid 设备的响应速度无法与用户的操作速度匹配，造成延迟 。
wave panel 规定，每40 毫秒对所有控制器端口轮询一次，若其中任何一个控制器的状态在两次轮询间隔内发生改变，就会在下次轮询前生成输入报表发送给主机.40 毫秒是基于视频每帧显示时间而确定的。
2 hid 设备的通讯过程
hid 设备是windows 操作系统最早支持的usb设备。在windows 98 及以后的各版本中都已内置了hid 设备的驱动程序，主机与hid 设备通讯时无须再编写专门的驱动程序。这就简化了hid 设备与主机应用程序通讯接口的设计和研发。
通过分析，可以将hid 设备与主机应用程序的通讯划分为设备识别和打开。读报表。写报表和设备关闭四个模块。
2. 1 wave panel 的识别和打开
hid 设备连接到主机后，以厂商id（vid）。产品id（pid）和产品版本号（pvn）三项属性值的组合作为设备唯一标识.wave panel 的三项属性值可以从产品说明书直接获取。由于一台主机可能同时连接有多台hid 设备，所以在通讯前应用程序必须要识别并打开wave panel，这一过程需要调用多个windows api函数实现。基本方法是首先获取当前与主机连接的所有hid 设备信息的集合，然后逐一枚举集合中的各设备，并比较vid.pid 和pvn 值。当三项属性值都与wave panel 相等时表示已经找到，调用createfile（）将该wave panel 打开，并保存wave panel 设备句柄。该模块的流程如图1 所示。
流程中调用的windows api 函数和结构体变量类型分别在hidpi. h.hidsdi. h.hidusage. h.setupapi. h 和hid. lib.setupapi. lib 几个文件中定义并实现 。主要包括：
1）hidd_gethidguid（ ）：获取hid 设备的guid值，并保存在一个guid 结构体变量中；
2）setupdigetclassdevs（）：根据hid 设备的guid值获取hid 设备信息的集合，并保存在一个hdevinfo结构体类型的变量中；
3）setupdienumdeviceinterfaces（）：在设备信息集合中依次获取编号为i（i = 0，1，…） 的设备接口信息，保存在一个sp_device_interface_data 结构体类型变量中；
4）setupdigetdeviceinterfacedetail（）：当获取设备接口信息成功时进一步获取该设备的详细信息，并保存设备路径；
5）hidd_getattributes（）：获取设备属性值并保存在一个hidd_attributes 结构体类型变量中.vid.pid 和pvn 值即为该结构体变量的三项成员；
6）setupdidestroydeviceinfolist（ ）：销毁设备信息集合。
2. 2 读报表
读报表是指hid 设备向主机输入数据。当wavepanel 面板上任意控制器状态发生变化时，都会在下一次轮询时将这些数据生成输入报表，并发送给主机。
主机上的应用程序接收输入报表并对数据进行解析，然后做出相应的处理。
由于wave panel 可能在任何时候与主机以中断方式进行通讯，因此应用程序需要维护一个异步调用的读报表线程。该线程在wave panel 没有向主机输入数据时阻塞，以减轻系统负载。当有数据输入时，线程恢复运行，调用readfile（）将输入数据保存在缓冲区中，并对数据进行解析。这之后线程将再次被阻塞，直到有新的输入数据到来。应用程序在wave panel成功打开后就创建读报表线程，应用程序运行结束前该线程将一直存在。读报表流程如图2 所示。
2. 3 写报表
与读报表相反，写报表是指主机向hid 设备输出数据。写报表对延迟的要求较高，但这一功能不是必需的，根据hid 设备的实际用途而定 。鼠标。键盘。游戏杆等较简单的设备只向主机发送数据，这些数据通常是一些控制信息和状态信息 ，例如改变hid 设备液晶屏上的显示信息。控制设备上发光元件的亮灭等。
应用程序的写报表线程流程与读报表线程类似，首先将要输出的数据按wave panel 规定的数据格式进行封装，复制到一个缓冲区内，再调用writefile（）将缓冲区数据输出到wave panel 即可，这些信息主要是与视频帧状态变化相关的信息。
2. 4 设备关闭
设备关闭模块功能比较简单。当主机与wavepanel 的通讯结束时，调用closehandle（ ） 将打开的wave panel 关闭即可。
3 wave panel 通讯接口的设计
以上述通讯过程为基础，设计一个名为chid-comm 的通讯接口，其总体框架为：
其中，成员函数opendevice（）和closedevice（）分别用于识别。打开和关闭wave panel.readreport-thread（）用于创建读报表线程。由于线程为异步方式执行，因此readreportthread（ ） 在调用readfile（ ） 时要使用一个overlapped 结构变量，该变量含有一个i/ o 完成后触发事件的句柄。当hid 设备没有向主机输入数据时，事件处于无信号状态，线程被阻塞；当有数据输入时，事件被触发，线程恢复运行，接收并将数据保存在读报表缓冲区，供数据解析函数使用.writereportthread（）与readreportthread（ ） 的功能类似，用于创建写报表线程。
成员变量vid.pid 和pvn 用于保存三项属性值，readbuffer 和writebuffer 分别定义读报表缓冲区和写报表缓冲区，其大小由hid 设备的输入报表和输出报表长度决定.s 实际上，该接口不仅可以用于wavepanel，同样也适用于其它hid 设备。只需要重新设置vid.pid 和pvn 值以及readbuffer.writebuffer 缓冲区的大小，而无须对识别。打开。读写报表等功能进行修改。
图3 是主机应用程序调用chidcomm 接口实现与wave panel 通讯的情况。以十六进制形式输出读报表缓冲区的值，并显示控制器状态变化情况。需要注意的一个重要问题是wave panel 输入报表并不使用报表id，在这种情况下应将读报表缓冲区readbuffer 的第0 字节设置为0×00，否则读报表线程将无法接收到输入报表。
4 结束语
wave panel 是一类较复杂的视频编辑hid 设备，没有提供windows 环境下的通讯功能。基于wavepanel 对windows 环境下的hid 设备通讯进行研究，能够解决许多unix.linux.mac 等操作系统支持的专用hid 设备无法在windows 环境下使用的问题。较之现有的一些解决方案，设计的chidcomm 接口具有较强的通用性，并可以方便地对功能进行扩展。今后的工作主要是扩展该接口在64 位windows 环境下的功能.
NZXT发布2款全新HUE2LED灯带产品 新增了微控制器
MEC应用环境真的成熟了吗
一种为倾角计子系统设计定制板支架的方法
中值滤波去除图像上存在孤立的噪声点
什么是GOPHER
基于Wave Panel的HID设备通讯接口设计
中国联通与5G网络共建共享顺利推进
C语言零基础项目：对对碰（消除类）游戏！详细思路+源码分享
分享几个大众的AGM、EFB蓄电池检测方法
研华推出专为批次控制设计的功能块
隔离变压器作用及应用
华为会不会像三星电子一样在多个领域取得成功？
比特大陆未来的发展规划探讨
聊聊芯片超净间的颗粒
谷歌等科技公司或与银行金融公司分享数据
USB双机通讯的原理
中国成为智能家居市场的主战场，跑马圈地竞争激烈
区块链里面的主角是谁
基于RC网络分相滤波器的镜频抑制混频器
vivoNEX3 5G曝光 屏占比高达99.6%？