linux/windows hid

liukun2009

一、背景：
   　　最近在做的一个项目需要使用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