winUSB设备的开发方法

1、winUSB功能介绍

winUSB设备在win10系统下自带驱动程序的，winUSB设备连接到USB后，可以直接被系统识别，无需安装驱动，实现了免驱的功能。就像键盘、鼠标插入到电脑上直接使用一下。

winUSB设备使用BULK传输，具有传输数据量的优点，设备使用BULK IN, BULK OUT，CONTROL3个端点来进行通信。因此winUSB设备在开发USB产品时是一个很好的选择。

2、winUSB软件选型

winUSB软件采用RT thread操作系统自带的USB device协议中 Winusb类驱动，此协议栈已经实现了USB的基本功能，具体代码可以参考分享仓库地址：GitHub - longtengmcu/USB-HOST-driver-4G-rndis-device: STM32F429 USB HOST driver 4G rndis device, Realization of high speed Ethernet data communication。

1程序在STM32中运行USB连接到WIN10电脑后是可以直接枚举到的，但是具体进行数据通信时要做软件上的修改。
2其中对于winUSB部分代码做了改进：

对于winUSB的read部分函数：修改成读取剩余部分的数据，这样在USB主机发送一包数据后就会立即触发接收回调函数来处理数据，原来的写法是接收到输入缓冲区长度的数据后才什么触发接收回调函数。

对winusb设备端点IN处理流程中增加对发送整最大包数长度数据的处理，即这种情况下发送一个ZLP，0长度包，让主机知道这次传输完成。

到这里，winUSB的驱动部分已经改好了。但是要做USB进行通信还有很多代码要写。

3、winUSB应用程序的编写

winUSB设备在RT THREAD操作系统中注册成winUSB设备，所以对winUSB的读写要使用设备操作的几个函数rt_device_find, rt_device_open, rt_device_read, rt_device_write。感觉跟其他设备一样，但是在实际调试过程中由于底层是USB设备，用法还是有不少区别的，应用时要做很多特殊的处理。

3.1 winUSB设备的初始化

1初始化时跟基他设备类型，find,open，注意除了注册接收回调函数外还要注册发送回调函数。最后必须先调用一下rt_device_read()给winUSB设备接收数据时传入接收数据使用的缓冲区，同时启动USB设备接收。

 1/*findandopencommanddevice*/
 2dev_name=“winUSB”
 3client->device=rt_device_find(dev_name);
 4if(client->device)
 5{
 6/*usingthetxinterruptwhenuartisRS485*/
 7open_result=rt_device_open(client->device,RT_DEVICE_OFLAG_RDWR);
 8RT_ASSERT(open_result==RT_EOK);
 9rt_device_set_tx_complete(client->device,utc_d_tx_ind);
10rt_device_set_rx_indicate(client->device,utc_d_rx_ind);
11client->putc_package=client->utcA_package;
12/*waitreadthewinusbdevicesuccess*/
13while(rt_device_read(client->device,0,client->putc_package,sizeof(client->utcA_package))==0)
14{
15rt_thread_mdelay(10);
16}
17}
18else
19{
20LOG_E("Notfindthedevice(%s).",dev_name);
21result=-RT_ERROR;
22}

1接收回调函数，USB设备接收到数据后，发送一个信号量给接收数据的线程通知数据处理。这个接收回调函数中使用双缓冲区，让接收数据与处理数据互不干扰。

 1staticrt_err_tutc_d_rx_ind(rt_device_tdev,rt_size_tsize)
 2{
 3utc_d_client_tclient=&utc_d_client;
 4if(client->package_len)
 5{
 6LOG_W("utcpackageoverwrite!");
 7}
 8client->package_len=size;
 9if(client->putc_package==client->utcA_package)
10{
11client->putc_package=client->utcB_package;
12}
13else
14{
15client->putc_package=client->utcA_package;
16}
17/*readtheusbdatanext*/
18rt_device_read(dev,0,client->putc_package,sizeof(client->utcA_package));
19if(size)
20{
21/*releasethesem*/
22rt_sem_release(client->rx_notice);
23}
24returnRT_EOK;
25}

1发送回调函数，usb设备发送成功后会调用发送回调函数，发送一个信号量，通知发送函数已经成功完成发送，这个功能非常重要，否则，USB设备无法正常工作。

1staticrt_err_tutc_d_tx_ind(rt_device_tdev,void*buffer)
2{
3utc_d_client_tclient=&utc_d_client;
4rt_sem_release(client->tx_notice);
5returnRT_EOK;
6}

1usb设备发送函数通过rt_device_write函数把数据发送给usb设备驱动后，一定要等待发送完成才行。

 1staticintutc_d_send(utc_d_client_tclient,rt_uint8_t*send_data,rt_uint32_tsend_len)
 2{
 3/*sendthepacketcounter*/
 4client->send_packet_counter++;
 5if(rt_device_write(client->device,0,send_data,send_len)==send_len)
 6{
 7/*Mustwaittheusbsenddatafinish*/
 8returnrt_sem_take(client->tx_notice,RT_WAITING_FOREVER);
 9}
10else
11{
12return-RT_ERROR;
13}
14}

1至此，winUSB设备的应用程序基本功能就全部实现，你可以基于此来进行与上位机的数据通信了。
2下期预告，winUSB的调试环境搭建与调试方法。

winUSB设备上位机驱动开发环境的搭建:

https://club.rt-thread.org/ask/article/691e79f4e05eb0fc.html(请复制至外部浏览器打开）

版权声明：本文为RT-Thread论坛用户「fhqmcu」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。

原文链接：

https://club.rt-thread.org/ask/article/691e79f4e05eb0fc.html

---

RT-Thread开发者大会

我们将联合重量级合作伙伴，围绕AIoT的发展、产业技术趋势，聚焦控制、连接、行业应用开发，通过主题演讲、技术分享、应用演示等环节，助力开发者探索万物智能的世界，期待与大家一起相聚线上直播间！

现在扫码报名 我们将在报名者中抽取“幸运参会者100名” 赠送RT-Thread新款开发板（即将揭秘）

本次将在大会当天在直播间宣布中奖名单

更多奖品即将来袭...

原文标题：winUSB设备的开发方法

文章出处：【微信公众号：RTThread物联网操作系统】欢迎添加关注！文章转载请注明出处。