文章目录

• 前言
• 一、HIDAPI是什么？
• 二、添加HIDAPI库
• • 1.下载HIDAPI相关库文件
  • 2.重新编译x64库文件
• 三、使用函数介绍
• • 1.初始化以及释放函数
  • 2.遍历HID USB函数
  • 3.打开USB函数
  • 4.读写USB函数
• 四、HID USB链表结构体介绍
• 五、获取指定VID和PID的HID USB设备信息
• • 1.获取设备的VID和PID
  • 2.代码
• 六、指定HID USB设备端口读写
• • 1.端口的选择
  • 2.数据发送hid_write()函数详解
  • 3.数据接收hid_read()函数详解
• 七、总结

前言

HID设备介绍可以看这里。
usb 不仅仅hid通信方式，还有其余的usb通信方式，但hid的好处就是无需安装驱动，热插拔直接用。

一、HIDAPI是什么？

HIDAPI 是一个 USB 和蓝牙的 hid 类设备在 Windows、Linux、FreeBSD 和 Mac 的 C 语言通用库，使用 HIDAPI可以在 Windows、Linux、FreeBSD 和 Mac 平台进行 USB 和蓝牙的 hid 类设备通信，非常简单实用。

二、添加HIDAPI库

1.下载HIDAPI相关库文件

文件连接可以去github查看：https://github.com/libusb/hidapi/tree/hidapi-0.12.0

打开window文件夹里的文件就是源码，里面包含的lib、dll为32位，需要64位的需要自己编译。
或者直接下载已经编译好的：https://download.csdn.net/download/cao_jie_xin/86827407

2.重新编译x64库文件

新建一个控制台程序，在配置类型中改成dll,把源代码内容拷贝过来重新编译生成dll.

三、使用函数介绍

1.初始化以及释放函数

//非必要函数，调用hid_enumerate()和hid_open()都会自动调用它
hid_init(void);
//释放hidapi
hid_exit(void);

2.遍历HID USB函数

//传入vid和pid可以遍历该id下的所有接口号地址等数据并形成链表返回
//若是vid和pid=0则遍历所有hid usb数据并形成链表返回
hid_enumerate(unsigned short vendor_id, unsigned short product_id);

3.打开USB函数

//指定vid和pid打开，最后一个参数可以是NULL，返回句柄（不建议使用）
//该操作使用默认端口，不能自主选择
hid_open(unsigned short vendor_id, unsigned short product_id, const wchar_t *serial_number);
//指定路径打开usb设备，返回句柄（建议使用）
hid_open_path(const char *path);
//释放链表，参数为hid_enumerate()返回的链表
hid_free_enumeration(struct hid_device_info *devs);

4.读写USB函数

//写操作
hid_write(hid_device *dev, const unsigned char *data, size_t length);
//设定阻塞读与非阻塞读 0为阻塞 1为非阻塞
hid_set_nonblocking(hid_device *dev, int nonblock);
//读操作
hid_read(hid_device *dev, unsigned char *data, size_t length);

四、HID USB链表结构体介绍

结构如下：

/** hidapi信息结构 */
struct hid_device_info {/** 设备路径 */char *path;/** VID */unsigned short vendor_id;/** PID */unsigned short product_id;/** 序列号 */wchar_t *serial_number;/** 以二进制编码的十进制表示的设备版本号 */unsigned short release_number;/** 制造商字符串 */wchar_t *manufacturer_string;/** 产品字符串 */wchar_t *product_string;/** 此设备/界面的使用页面（仅限Windows/Mac/hidraw） */unsigned short usage_page;/** 此设备/接口的用法（仅限Windows/Mac/hidraw） */unsigned short usage;/** 设备接口号 */int interface_number;/** 连接到下一个 */struct hid_device_info *next;
};

五、获取指定VID和PID的HID USB设备信息

1.获取设备的VID和PID

在windows下打开usb应该是需要root权限，建议用管理员模式打开QT不然容易异常退出。

两种方式：
1.自己写的下位机VID和PID自己决定。
2.使用Bus Hound获取，具体使用方式就不说了。

2.代码

 int USB::hid_print(void)
{hid_device_info *hid_info;//usb链表/*打开指定VID PID设备*/hid_info = hid_enumerate(0x5511,0x0011);/*遍历所有信息并打印*/for(;hid_info != nullptr;hid_info = hid_info->next){qDebug("设备接口号:%d",hid_info->interface_number);qDebug("厂商字符串:%ls",hid_info->manufacturer_string);qDebug("设备字符串:%ls",hid_info->product_string);qDebug("版本号:%d",hid_info->release_number);qDebug("地址:%s",hid_info->path);}/*释放链表*/hid_free_enumeration(hid_info);return 0;
}

运行后可以看到以下数据：

和Bus Hound读取到的对比一致，证明读取每出错。

六、指定HID USB设备端口读写

1.端口的选择

在第五点中我们已经遍历了该USB设备内的所有端口，这些端口被保存在上述USB链表内，因此我们需要找到我们要操作的端口号，并通过hid_open_path()这个函数来打开，这样才能指定端口收发数据。

#define	TX_MAXSIZE   64;
int USB::usb_write(void)
{int res;uint8_t buf[TX_MAXSIZE + 1];hid_device *handle;//usb句柄hid_device_info *hid_info;//usb链表/*打开指定VID PID设备*/hid_info = hid_enumerate(0x5511,0x0011);for(;hid_info != nullptr;hid_info = hid_info->next){if(hid_info->interface_number == 2)//接口匹配{qDebug("interface_number:%s",hid_info->path);//打印地址break;}}return 0;
}

2.数据发送hid_write()函数详解

int hid_write(hid_device *device, const unsigned char *data, size_t length);

在Windows中使用 hid_write()这个函数时，一定要注意！写入的数据大小一定要再加1bytes，首字节用来存放REPORT ID，并且写入 的数据大小"length"只能固定为设备对应ReportID定义的OUT报告的大小！我的下位机设定了端口收发最大字节为64，所以hid_write()发送的数组长度为64+1；读写的一些注意事项在这。

int USB::usb_write(void)
{int res;uint8_t buf[TX_MAXSIZE + 1];hid_device *handle;//usb句柄hid_device_info *hid_info;//usb链表/*打开指定VID PID设备*/hid_info = hid_enumerate(0x5511,0x0011);for(;hid_info != nullptr;hid_info = hid_info->next){if(hid_info->interface_number == 2)//接口匹配{qDebug("interface_number:%s",hid_info->path);//打印地址break;}}/*打开指定地址的设备*/handle = hid_open_path(hid_info->path);/*释放链表*/hid_free_enumeration(hid_info);buf[0] = 0x3f;//Report ID（自定义）buf[1] = 0x21;//随便一点东西buf[2] = 0x03;buf[3] = 0x00;buf[4] = 0x00;buf[5] = 0x00;res = hid_write(handle, buf, TX_MAXSIZE + 1);if(res < 0){/*返回值查看*/qDebug("err_string = %ls\n",hid_error(handle));}return 0;
}

3.数据接收hid_read()函数详解

阻塞式接收代码，不收到消息不会退出：

int USB::usb_read(void)
{int res;uint8_t buf[64+1];hid_device *handle;//usb句柄hid_device_info *hid_info;//usb链表/*打开指定VID PID设备*/hid_info = hid_enumerate(0x5511,0x0011);for(;hid_info != nullptr;hid_info = hid_info->next){if(hid_info->interface_number == 2)//接口匹配{qDebug("interface_number:%s",hid_info->path);//打印地址break;}}/*打开指定地址的设备*/handle = hid_open_path(hid_info->path);/*释放链表*/hid_free_enumeration(hid_info);res = hid_read(handle, buf, 64+1);if(res < 0){/*返回值查看*/qDebug("err_string = %ls\n",hid_error(handle));}/*阻塞*/hid_set_nonblocking(handle, 0);for(int i = 0;i<64;i++){qDebug("buf[%d]:%02x",i,buf[i]);}return 0;
}

使用Bus Hound发送指令，可以看到已经收到下位机返回的消息（当然这个接收指令后返回消息的处理是在下位机写的）

七、总结

本文就是简单的hidapi收发消息操作，若有错误，欢迎指出。

参考链接：链接1

参考链接：链接2

本文需要的dll ，工具，例程，源码，开源代码，官方例程链接：https://download.csdn.net/download/cao_jie_xin/86827407