STEPBYSTEP设计一个USB调试助手之九:基于异步传输的简单USB测试工具

原创 嵌入式Lee 2024-04-12 08:01

一. 前言

前面我们实现了批量和中断传输的功能,至此工具已经初步具备了实用价值,可以进行控制传输和批量/中断传输的测试了。但是目前是基于同步接口实现的,也就是点击按钮,进行传输,等待传输完再显示, 这样效率不高,也不适合应用。这一篇就来利用libusb的异步接口,实现新的收发框架,后面再将新的框架应用到我们的测试工具,所以本文先实现一个命令行的工具,先不带GUI,主要是测试异步框架,后面再应用的带GUI的测试工具中。

二. 异步传输编程框架

异步传输参考官方文档

https://libusb.sourceforge.io/api-1.0/group__libusb__asyncio.html

我这里做了个总结,画出了应用框图,看图更直观。

首先传输是针对端点的,所以前面需要一段初始化过程,过程即对应USB的框架层次

设备->接口->端点。当然这里还有libusb的运行环境初始化,

所以初始化过程就是

libusb_init_context->libusb_open_device_with_vid_pid->libusb_claim_interface

对应的释放过程和上述初始化过程完全相反。

初始化之后,至此就可以进行端点的操作了,异步操作分为以下几个步骤

分配传输 libusb_alloc_transfer->

填充传输参数 libusb_fill_bulk_transfer->

提交传输 libusb_submit_transfer->

等待传输完回调cb->

释放传输libusb_free_transfer

当然以上不是所有过程都需要走一遍,比如不需要重复分配传输,可以一直反复用。

当然是否传输完也是需要去检查的,所以这个实际是通过libusb_handle_events来实现的,该函数实现事件消息循环处理。周期调用该函数即可,可以使用一个线程单独运行它。此时cb就是在该线程运行,那么要注意和传输处理所在的线程不是同一个线程注意多线程问题。

如上框图,我这里设计的是用三个线程,主线程实现初始化,然后创建事件处理线程和传输处理线程,等待传输处理线程和事件处理线程运行完再执行释放过程。

事件处理线程只做一件事就是调用libusb_handle_events执行libusb的事件消息循环。

处理线程实现异步传输的处理:分配传输,填充传输,提交传输等。

处理线程如果执行完,我这里设置的是收到指定长度的内容之后,就发送信号量给事件处理线程,并退出线程,事件处理线程收到信号也退出线程。这样主线程等到他们都退出则执行释放过程。

以上仅作为一般框架建议,实际使用一个线程也可以。

三. 接口

实际上面已经介绍了相关的接口,具体可以参考官方文档,这里再总结下

1.运行环境初始化与反初始化

libusb_init_context/libusb_exit

2.设备打开与关闭

libusb_open_device_with_vid_pid/libusb_close

3.接口申请与释放

libusb_claim_interface/libusb_claim_interface

4.异步传输

libusb_alloc_transfer/libusb_fill_bulk_transfer/libusb_submit_transfer/libusb_free_transfer

5.事件循环

libusb_handle_events

四. 基于异步传输框架的测试

4.1 实现

实际上述框架已经介绍的差不多了,实现起来就很简单了,直接上代码,代码里也有注释,就不再赘述了

我这里是用的是mingw qt环境,开发环境搭建参考前面的系列文章。

Usb_test.c实现如下

//#include //#include #include #include #include #include "libusb.h"
#define TRANSFER_SIZE 64 /* 一次传输的大小 */#define VID 0x1999#define PID 0x0101#define USB_ITF_ID 0#define USB_IN_EP 0x81#define USB_OUT_EP 0x01
static void* usb_event_thread(void *arg); /* USB事件线程处理函数 */static void* usb_handle_thread(void *arg); /* USB业务线程处理函数 */pthread_t s_usb_event_thread; /* USB事件处理线程句柄 */pthread_t s_usb_handle_thread; /* USB业务处理线程句柄 */
libusb_device_handle *s_opened_handle = NULL; /* USB打开的设备句柄 */
struct libusb_transfer* s_tx_transfer = NULL; /* 发送传输 */struct libusb_transfer* s_rx_transfer = NULL; /* 接收传输 */static uint8_t s_tx_buffer[TRANSFER_SIZE]; /* 发送数据 */static uint8_t s_rx_buffer[TRANSFER_SIZE]; /* 接收数据 */static int s_tx_busy = 0; /* 发送忙标志 */static int s_rx_busy = 0; /* 接收忙标志 */static int s_tx_len = 0;static int s_rx_len = 0;sem_t s_sem;
int16_t vid = VID;int16_t pid = PID;int16_t itf = USB_ITF_ID;int16_t in_ep = USB_IN_EP;int16_t out_ep = USB_OUT_EP;
#define MAX_TX_LEN (sizeof(s_tx_buffer)*100)
int usb_test_main(int argc, char *argv[]){ int r; /* 解析参数 */ if(argc != 6) { printf("usage:usb_test.exe vid pid itf inep outep"); }
sscanf("%*s %#x %#x %d %#x %#x",&vid,&pid,&itf,&in_ep,&out_ep); for(size_t i=0 ;i<sizeof(s_tx_buffer); i++) { s_tx_buffer[i] = i; }
r = libusb_init_context(/*ctx=*/NULL, /*options=*/NULL, /*num_options=*/0); if (r < 0) { printf("failed to init context %d\r\n",r); return r; }
s_opened_handle = libusb_open_device_with_vid_pid(NULL, vid, pid); if (s_opened_handle == NULL) { printf("open dev err\r\n"); libusb_exit(NULL); return r; }
r = libusb_claim_interface(s_opened_handle,itf); if (r < 0) { printf("failed to claim interface %d\r\n",r); libusb_close(s_opened_handle); libusb_exit(NULL); return r; }
sem_init(&s_sem, 0, 0);
/* 创建usb事件处理线程 */ r = pthread_create(&s_usb_event_thread,0,usb_event_thread,0); if (r != 0) { printf("failed to create usb event thread:%d\r\n",r); libusb_release_interface(s_opened_handle,itf); libusb_close(s_opened_handle); libusb_exit(NULL); return r; }
/* 创建usb业务处理线程 */ r = pthread_create(&s_usb_handle_thread,0,usb_handle_thread,0); if (r != 0) { printf("failed to create usb handle thread:%d\r\n",r); libusb_release_interface(s_opened_handle,itf); libusb_close(s_opened_handle); libusb_exit(NULL); return r; }
/* 等待线程结束 */ void *res; pthread_join(s_usb_event_thread,&res); pthread_join(s_usb_handle_thread,&res); sem_destroy(&s_sem);
if(s_tx_len != s_rx_len) { printf("err send_len:%d,rx_len:%d!\r\n",s_tx_len,s_rx_len); } else { printf("ok send_len:%d,rx_len:%d!\r\n",s_tx_len,s_rx_len); }
libusb_release_interface(s_opened_handle,USB_ITF_ID); libusb_close(s_opened_handle); libusb_exit(NULL);
return 0;}
void tx_cb(struct libusb_transfer *transfer){ if (transfer->status == LIBUSB_TRANSFER_COMPLETED) { /* 成功 */ printf("tx_cb ok\r\n"); } else { /* 失败 */ printf("tx_cb err %d\r\n",transfer->status); //libusb_submit_transfer(transfer); } s_tx_len += transfer->actual_length; libusb_free_transfer(transfer); s_tx_busy = 0;}
void rx_cb(struct libusb_transfer *transfer){ if (transfer->status == LIBUSB_TRANSFER_COMPLETED) { /* 成功 */ printf("rx_cb ok\r\n"); } else { /* 失败 */ printf("rx_cb err %d\r\n",transfer->status); //libusb_submit_transfer(transfer); }
if(transfer->actual_length > 0) { printf("rx len %d\r\n",transfer->actual_length); } s_rx_len += transfer->actual_length; libusb_free_transfer(transfer);
s_rx_busy = 0;}
static void* usb_event_thread(void *arg){ while(1) { if(0 == sem_trywait(&s_sem)) { return 0; } libusb_handle_events(0); const struct timespec interval= { .tv_nsec = 1000000, .tv_sec = 0, }; pthread_delay_np(&interval); } return 0;}
static void* usb_handle_thread(void *arg){ while(1) { int rc; if(s_rx_len >= MAX_TX_LEN) { sem_post(&s_sem); return 0; }
/* 发送处理 */ s_tx_transfer = libusb_alloc_transfer(0); libusb_fill_bulk_transfer(s_tx_transfer,s_opened_handle,out_ep,s_tx_buffer,sizeof(s_tx_buffer),&tx_cb,0,100); rc = libusb_submit_transfer(s_tx_transfer); if(rc < 0) { s_tx_busy = 0; libusb_free_transfer(s_tx_transfer); s_tx_transfer = 0; }
/* 接收处理 */ s_rx_transfer = libusb_alloc_transfer(0); libusb_fill_bulk_transfer(s_rx_transfer,s_opened_handle,in_ep,s_rx_buffer,sizeof(s_rx_buffer),&rx_cb,0,100); rc = libusb_submit_transfer(s_rx_transfer); if(rc < 0) { s_rx_busy = 0; libusb_free_transfer(s_rx_transfer); s_rx_transfer = 0; }
const struct timespec interval= { .tv_nsec = 1000000, .tv_sec = 0, }; pthread_delay_np(&interval); }
return 0;}

Usb_test.h如下

#ifndef USB_TEST_H#define USB_TEST_H
#if defined(__cplusplus)extern "C" {#endif
int usb_test_main(int argc, char *argv[]);
#if defined(__cplusplus)}#endif
#endif // USB_TEST_H

Main.cpp如下

#include #include "usb_test.h"
int main(int argc, char *argv[]){ QCoreApplication a(argc, argv); usb_test_main(argc, argv); return a.exec();}

整个工程如下

4.2 发布程序

这里顺便提一下发布代码,直接拷贝usb_tool.exe到其他地方是不能直接运行的,因为依赖一些库, 需要使用工具发布。

build-usb_tool-Desktop_Qt_6_6_1_MinGW_64_bit-Debug\debug下的

Usb_tool.exe放到某个文件夹下

开始菜单搜索打开如下命令行

 

Cd usb_tool.exe所在目录

执行windeployqt usb_tool.exe

会自动添加对应的依赖库

生成文件如下,在这里就可以直接点击exe运行了,发布就复制整个文件夹即可。

4.3 测试

命令行输入

usb_tool.exe 0x1999 0x0101 0 0x81 0x01

我这里接的是一个winusb设备,vid pid0x1999 0x0101

接口0下有0x81IN端点和0x01OUT端点,设备代码逻辑是收到01端点的数据原样从0x81端点返回。

4.4 工程和可执行代码

完整的代码,框图和可执行文件可以从以下地址下载

链接:https://pan.baidu.com/s/1CfWEpmxFS4NAweZpWd3slw?pwd=pzj7

提取码:pzj7

五. 总结

以上只是简单的demo,还有一些可改进的地方

1.以上demo处理线程中提交传输,回调中进行处理,等回调处理完设置标志,处理线程再提交下一次传输,实际并没有pipeline流水起来,因为处理线程需要等到回调中处理完才提交下一次传输,这里中间会有间隔。实际libusb支持pipeline,提交传输实际是动态分配资源并挂载描述符的,所以可以一次提交多个,这样在一个传输完成时,后续还有多个传输正在进行,此时处理线程又可以继续提交传输,这样流水起来,才能高效。

2.以上demo仅仅作为演示,实际应用,需要提供给应用层更简单的读写接口,此时需要借助FIFO,即处理线程负责接收数据到RX FIFO,负责从TX FIFO取数据发送, 这样应用层读写数据只需要读RX FIFO,写TX FIFO,实现和底层解耦。


评论
  • 故障现象 一辆2007款法拉利599 GTB车,搭载6.0 L V12自然吸气发动机(图1),累计行驶里程约为6万km。该车因发动机故障灯异常点亮进厂检修。 图1 发动机的布置 故障诊断接车后试车,发动机怠速轻微抖动,发动机故障灯长亮。用故障检测仪检测,发现发动机控制单元(NCM)中存储有故障代码“P0300 多缸失火”“P0309 气缸9失火”“P0307 气缸7失火”,初步判断发动机存在失火故障。考虑到该车使用年数较长,决定先使用虹科Pico汽车示波器进行相对压缩测试,以
    虹科Pico汽车示波器 2025-01-15 17:30 43浏览
  • 百佳泰特为您整理2025年1月各大Logo的最新规格信息,本月有更新信息的logo有HDMI、Wi-Fi、Bluetooth、DisplayHDR、ClearMR、Intel EVO。HDMI®▶ 2025年1月6日,HDMI Forum, Inc. 宣布即将发布HDMI规范2.2版本。新规范将支持更高的分辨率和刷新率,并提供更多高质量选项。更快的96Gbps 带宽可满足数据密集型沉浸式和虚拟应用对传输的要求,如 AR/VR/MR、空间现实和光场显示,以及各种商业应用,如大型数字标牌、医疗成像和
    百佳泰测试实验室 2025-01-16 15:41 50浏览
  • 数字隔离芯片是现代电气工程师在进行电路设计时所必须考虑的一种电子元件,主要用于保护低压控制电路中敏感电子设备的稳定运行与操作人员的人身安全。其不仅能隔离两个或多个高低压回路之间的电气联系,还能防止漏电流、共模噪声与浪涌等干扰信号的传播,有效增强电路间信号传输的抗干扰能力,同时提升电子系统的电磁兼容性与通信稳定性。容耦隔离芯片的典型应用原理图值得一提的是,在电子电路中引入隔离措施会带来传输延迟、功耗增加、成本增加与尺寸增加等问题,而数字隔离芯片的目标就是尽可能消除这些不利影响,同时满足安全法规的要
    华普微HOPERF 2025-01-15 09:48 119浏览
  • 随着智慧科技的快速发展,智能显示器的生态圈应用变得越来越丰富多元,智能显示器不仅仅是传统的显示设备,透过结合人工智能(AI)和语音助理,它还可以成为家庭、办公室和商业环境中的核心互动接口。提供多元且个性化的服务,如智能家居控制、影音串流拨放、实时信息显示等,极大提升了使用体验。此外,智能家居系统的整合能力也不容小觑,透过智能装置之间的无缝连接,形成了强大的多元应用生态圈。企业也利用智能显示器进行会议展示和多方远程合作,大大提高效率和互动性。Smart Display Ecosystem示意图,作
    百佳泰测试实验室 2025-01-16 15:37 42浏览
  • 晶台光耦KL817和KL3053在小家电产品(如微波炉等)辅助电源中的广泛应用。具备小功率、高性能、高度集成以及低待机功耗的特点,同时支持宽输入电压范围。▲光耦在实物应用中的产品图其一次侧集成了交流电压过零检测与信号输出功能,该功能产生的过零信号可用于精确控制继电器、可控硅等器件的过零开关动作,从而有效减小开关应力,显著提升器件的使用寿命。通过高度的集成化和先进的控制技术,该电源大幅减少了所需的外围器件数量,不仅降低了系统成本和体积,还进一步增强了整体的可靠性。▲电路示意图该电路的过零检测信号由
    晶台光耦 2025-01-16 10:12 40浏览
  • 近期,智能家居领域Matter标准的制定者,全球最具影响力的科技联盟之一,连接标准联盟(Connectivity Standards Alliance,简称CSA)“利好”频出,不仅为智能家居领域的设备制造商们提供了更为快速便捷的Matter认证流程,而且苹果、三星与谷歌等智能家居平台厂商都表示会接纳CSA的Matter认证体系,并计划将其整合至各自的“Works with”项目中。那么,在本轮“利好”背景下,智能家居的设备制造商们该如何捉住机会,“掘金”万亿市场呢?重认证快通道计划,为家居设备
    华普微HOPERF 2025-01-16 10:22 72浏览
  • 全球领先的光学解决方案供应商艾迈斯欧司朗(SIX:AMS)近日宣布,与汽车技术领先者法雷奥合作,采用创新的开放系统协议(OSP)技术,旨在改变汽车内饰照明方式,革新汽车行业座舱照明理念。结合艾迈斯欧司朗开创性的OSIRE® E3731i智能LED和法雷奥的动态环境照明系统,两家公司将为车辆内饰设计和功能设立一套全新标准。汽车内饰照明的作用日益凸显,座舱设计的主流趋势应满足终端用户的需求:即易于使用、个性化,并能提供符合用户生活方式的清晰信息。因此,动态环境照明带来了众多新机遇。智能LED的应用已
    艾迈斯欧司朗 2025-01-15 19:00 49浏览
  • 一个易用且轻量化的UI可以大大提高用户的使用效率和满意度——通过快速启动、直观操作和及时反馈,帮助用户快速上手并高效完成任务;轻量化设计则可以减少资源占用,提升启动和运行速度,增强产品竞争力。LVGL(Light and Versatile Graphics Library)是一个免费开源的图形库,专为嵌入式系统设计。它以轻量级、高效和易于使用而著称,支持多种屏幕分辨率和硬件配置,并提供了丰富的GUI组件,能够帮助开发者轻松构建出美观且功能强大的用户界面。近期,飞凌嵌入式为基于NXP i.MX9
    飞凌嵌入式 2025-01-16 13:15 61浏览
  • 电竞鼠标应用环境与客户需求电竞行业近年来发展迅速,「鼠标延迟」已成为决定游戏体验与比赛结果的关键因素。从技术角度来看,传统鼠标的延迟大约为20毫秒,入门级电竞鼠标通常为5毫秒,而高阶电竞鼠标的延迟可降低至仅2毫秒。这些差异看似微小,但在竞技激烈的游戏中,尤其在对反应和速度要求极高的场景中,每一毫秒的优化都可能带来致胜的优势。电竞比赛的普及促使玩家更加渴望降低鼠标延迟以提升竞技表现。他们希望通过精确的测试,了解不同操作系统与设定对延迟的具体影响,并寻求最佳配置方案来获得竞技优势。这样的需求推动市场
    百佳泰测试实验室 2025-01-16 15:45 55浏览
  • 实用性高值得收藏!! (时源芯微)时源专注于EMC整改与服务,配备完整器件 TVS全称Transient Voltage Suppre,亦称TVS管、瞬态抑制二极管等,有单向和双向之分。单向TVS 一般应用于直流供电电路,双向TVS 应用于电压交变的电路。在直流电路的应用中,TVS被并联接入电路中。在电路处于正常运行状态时,TVS会保持截止状态,从而不对电路的正常工作产生任何影响。然而,一旦电路中出现异常的过电压,并且这个电压达到TVS的击穿阈值时,TVS的状态就会
    时源芯微 2025-01-16 14:23 71浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦