一、背景： 最近在做的一个项目需要使用USB传递数据，对USB理解不是很深，USB的系统驱动编写则更是天方 夜谭，因此将设备配置成HID类设备成为了首选。其最大的好处在于，LINUX/Windows系统中均自带HID 设备驱动，免除了USB系统驱动的困扰，同时HID配置为高速设备与全速设备时，其每笔事务传输的最大 字节大小分别为64bytes、1024bytes，亦符合当前开发需求。 二、正文： 安装及使用方法在"HIDAPI"文件夹中的"Readme"有了详细说明，在此仅做个大致说明以及记录在使 用该库函数时所碰到的一些问题。 Windows: 在Windows中，其使用"VS"工具来编译，HIDAPI以两种情况存在在项目中：一种是，将“"hid.c"、 "hid.h"和自己的源码一起编译到项目中；另一种则是将其编译成".dll",".lib"，以动态链接库的形式 存在于项目中。推荐第一种，第一种方法你就可以很方便跟"hidapi"源代码。 在Windows中使用 "int hid_write(hid_device *device, const unsigned char *data, size_t length);" 这个函数时，一定要注意！写入的数据大小一定要再加1bytes，首字节用来存放REPORT ID，并且写入 的数据大小"length"只能固定为设备对应ReportID定义的OUT报告的大小！ 举个例子，若是USB设备只有一个Report ID，该Reprot ID对应的OUT Report大小配置为OUT_cnt bytes。那么buf[0]应该保存Report ID，buf的大小应该设置为(OUT_cnt bytes + 1bytes(report id))， 写入的字节参数"length"无论多少，用"Bus hound"工具会发现，下传的数据大小一律为Out_cnt bytes， 在下位机读取到的USB数据大小通过串口返回，也可证实，下位机读取到的数据大小也为Out_cnt bytes. 至于原因，该库函数作者Alan也做出了一些回答，意思在Windows系统中系统会根据首字节的Report ID 来寻找正确的发送端口，若有兴趣可以搜索作者在该github中Issues的问答。 同样，在Windows中使用 "int hid_read(hid_device *device, unsigned char *data, size_t length);" 这个函数时，"length"的值一定要为下位机定义的IN Report大小。并且这个函数要和函数
"hid_set_nonblocking(...)"使用，设置为堵塞或者非堵塞。跟进"hid_read(..)"函数内，会发现其
最终调用的函数还是 "int hid_read_timeout(... int milliseconds)" 若是设置为堵塞模式，则参数"milliseconds"设置为"-1"，设置为非堵塞模式，则参数"milliseconds"设置 为"0"。 其它的勿用多说，Readme和头文件中已经写的非常详细。 补充一点，已证实"HIDAPI"非线程安全操作，即读和写一定要在一个线程内操作，而不能在两个线程 内操作。2016-12-6 Linux： 在Linux中，其同Windows一致，亦是以两种形式存在，且Linux系统对传输的字节数更加宽容，没有 Windows那么严格，因此"HIDAPI"在Linux系统使用中没有hid_wrte/hid_read在Windows出现的麻烦，写入 低于设备设定字节限定大小的任意字节皆可，读亦如此，不会遭遇读写失败的境遇。 具体的编译方法及使用方法亦在Readme和头文件中已经写的非常详细，在此不再赘述。 三、下载及参考链接： hidraw设备介绍： https://www.kernel.org/doc/Documentation/hid/hidraw.txt HIDAPI介绍： https://valelab.ucsf.edu/svn/3rdpartypublic/hidapi/hidapi-3a66d4e513/README.txt HIDAPI下载页面： https://github.com/signal11/hidapi 记录完毕。 记录地点：深圳WZ 记录时间：2016年4月12日