你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

实战经验 | 基于 STM32U5 创建 USBx_CustomHID 通信

[复制链接]
STMCU-管管 发布时间:2024-4-22 15:20
1. 前言 9 B7 y% H* b9 P7 M- J; W
某客户在使用 STM32U5 开发一款产品时需要使用到 USB Custom 进行双向通信,并反馈 STM32U5 使用的是 Azure USBx 协议栈,不再支持 ST USB device 库。客户表示只熟悉 ST USB Device 库,对 USBx 协议栈与 API 没有任何使用经验。查阅目前所有 USBx 的例程,发现 目前 USBx 均没有可参考的 Custom HID 双向通信范例,客户希望提供使用 USBx HID 进行双 向通信的例程,这里简单介绍下利用 CubeMx 创建工程的实现过程。
, E5 S" e, o) W2 n, }1 p4 T( \1 }. `7 Z$ ~+ A6 z

: J7 s- L& y9 X- ]/ m& d2. USB 双向通信的几个基本知识点
" d; ~  J* _% ]+ g2 J首先,我们回顾一下 USB2.0 设备端与主机通信的基本原理及数据流,如下图所示。; _' R& |- f- a! y2 t# n1 H& D2 q

USB 双向通信的几个基本知识点

USB 双向通信的几个基本知识点
设备描述符:向主机提供 USB 版本信息、支持的协议、供应商标识(VID)、产品标识(PID)、及制 造商和产品字符串,支持的配置数量等信息。8 [% T, c9 ]( @! O# R2 |
配置描述符:提供特定设备配置的信息,如接口数量、设备由总线供电还是自供电、设备能否启 动一个远程唤醒以及设备功耗。 & [  _! P& k4 `5 O5 N3 H
接口描述符:对配置描述符中的接口信息进行描述,主要包括了接口号、类型以及该接口中的端 点(Endpoints)数量等信息。
4 ~5 k) n% L( S! n; r; S) T端点描述符 :用于向主机提供端点信息,主要包括了端点方向(IN/OUT)、传输类型(中断、批量 bluck、同步、控制)以及数据包最大长度等信息。 - ^( K8 A5 F3 Q
+ h* |& \& }' z# d4 x

+ }, J" S  I1 U3 f- s4 P6 N3. USBx HID 设备端 API 介绍
1 E* Q7 q( V* `USBx Device 协议栈内部实现了一套复杂的基于事件和消息驱动机制的数据流传输和控制传 输逻辑,用户 Application 只需要使用其提供的 APIs 即可实现 USB 通信。USBx Device Stack 所提供的 APIs 如下:
; T1 Q9 U# |7 `( ]% R

系统外设、USB、USBx、Threadx 的添加和基础配置

系统外设、USB、USBx、Threadx 的添加和基础配置

" c' }0 t5 t, K' A5 D

+ ~* \6 s4 t. y& O4. USBx 实现 Custom HID 双向通信的步骤
2 c! m! W! X! r0 S# Z(一) 系统外设、USB、USBx、Threadx 的添加和基础配置1 C- p- t, q9 Q" a6 C
下面我们就使用 NUCELO-U575ZI-Q 基于前面所讲的 USBx Device stack APIs 来实现 USB HID 双向通信。使用 STM32CubeMX 创建如下工程,工程基本配置如下。 - J- q7 q  c; r- M  }8 a

系统外设、USB、USBx、Threadx 的添加和基础配置

系统外设、USB、USBx、Threadx 的添加和基础配置
USB 和 RCC 时钟系统配置如下:
/ e, H7 P( E; F

USB 和 RCC 时钟系统配置如下

USB 和 RCC 时钟系统配置如下
配置 NUCLEO-U575-Q 为 SMPS 供电模式 : H: O1 w4 O' I3 l" _( d0 K, T9 T

配置 NUCLEO-U575-Q 为 SMPS 供电模式

配置 NUCLEO-U575-Q 为 SMPS 供电模式

' t  L6 u+ l) W3 l
9 P# D0 z% N5 Y! ]6 a
配置 USB 引脚及中断功能; Y/ D( \5 j6 [2 t

配置 USB 引脚及中断功能

配置 USB 引脚及中断功能
添加 ThreadX RTOS 协议栈 % Y% q0 `7 X5 A% W' }, ^0 e6 P

添加 ThreadX RTOS 协议栈

添加 ThreadX RTOS 协议栈
添加 USBx 协议栈支持并配置协议栈8 z- _  [. U: E2 T  f1 u6 i
添加 USBx 协议栈支持并配置协议栈1.png
添加 USBx 协议栈支持并配置协议栈2.png
添加 USBx 协议栈支持并配置协议栈3.png
" O+ g' z7 n: H* [0 ?, K& M8 ]8 d

( a( I& Q- p+ c  c- d# C0 T; C设置 MX_USB_OTG_FS_PCD_Init 在 main()中不进行调用,并保存工程并生成代码。8 L7 `! Q* y0 ?: ^. p5 E

设置 MX_USB_OTG_FS_PCD_Init 在 main()中不进行调用,并保存工程并生成代码

设置 MX_USB_OTG_FS_PCD_Init 在 main()中不进行调用,并保存工程并生成代码
(二) 代码的添加及修改
; X* i( x( ?1 l# G6 V本例程目的是实现 USB Custom HID 双向通信。本例程共使用了 3 个 Endpoint,如下:Eendpoint0(控制类型,IN/OUT)、Endpoint1(中断,IN)、Endpoint2(中断,OUT)。Endpoint0:系统默认控制管理端点,用于 Host 对 Device 传输控制和管理命令,如设备描述 符、配置描述符等系统信息进行配置和查询。3 t2 T& J" j+ B, N
Endpoint1:输入(IN)类型端点,用于向 Host 发送数据,在本例程我们创建了一个应用线程 usbx_cutomhid_thread_entry(),以 1S 为周期向 Host 通过 Endpoint1 发送 64 字节的数据包。 " X4 C" `* h2 ^6 _
Endpoint2:输出(OUT)类型端点,用于当 Host 向 device 发送数据时,USBx Stack 会自动调 用 USBD_Custom_HID_SetReport()的回调函数,通过 Endpoint2 来接收 Host 所发送的数据包。
( M( g0 \& q# `) {& r1. 在 app_usbx_devich.h 中包含如下几个头文件。 9 G3 J2 \4 u& v8 i. \
在 app_usbx_devich.h 中包含如下几个头文件1.png 在 app_usbx_devich.h 中包含如下几个头文件2.png
2. 在 app_usbx_device.c 中申明和定义如下结构,其中 ux_app_MsgQueue 消息队列用于实现 USB 的动态管理。9 g. S' Y* o" N7 I* Y$ w8 O- `9 p
在 app_usbx_device.c 中申明和定义如下结构,其中 ux_app_MsgQueue 消息队列用于实现.png 在 app_usbx_device.c 中申明和定义如下结构,其中 ux_app_MsgQueue 消息队列用于实现.png
& Q$ Y! a. P& P" s6 Q3. 在 ux_device_customhid.h/.c 中添加如下申明和定义,并在相关相关函数内分别依次添加下 图所示代码。其中线程 usbx_cutomhid_thread_entry 用于周期性通过 Endpoint1 向 host 发 送 64 字节数据。
5 z0 c) R* h1 ?7 D: ^* \
通过 Endpoint1 向 host 发 送 64 字节数据1.png
通过 Endpoint1 向 host 发 送 64 字节数据2.png
通过 Endpoint1 向 host 发 送 64 字节数据3.png
通过 Endpoint1 向 host 发 送 64 字节数据4.png
通过 Endpoint1 向 host 发 送 64 字节数据5.png
通过 Endpoint1 向 host 发 送 64 字节数据6.png
通过 Endpoint1 向 host 发 送 64 字节数据7.png
+ s* D4 }2 N  M1 T
- I: `7 B4 x0 j' P) O/ K
修改 HID SetReport 函数,接收由 PC 机向 OUT 端点(Endpoint2)发送的数据包。4 l- a: Q# C6 x6 C& G

修改 HID SetReport 函数

修改 HID SetReport 函数
在 usbx_customhid_thread_entry 中实现 IN 端点(Endpoint1)向 PC 机 1S 发送一次数据功能。
& [5 ?: n( L5 E7 r- h

在 usbx_customhid_thread_entry 中实现 IN 端点(Endpoint1)向 PC 机 1S 发送一次数据功能

在 usbx_customhid_thread_entry 中实现 IN 端点(Endpoint1)向 PC 机 1S 发送一次数据功能
添加 HID report 描述符,我们使用 USB 官网 HID 报告描述符工具生成自定义 Custom HID report 描述符,该工具可以到网址 https://www.usb.org/document-library/hid-descriptortool 下载。 0 T3 M) s& @' M! d
根据 USB 规范一个 HID 报告描述符至少应包括如下条目(Items)。* I4 Z( W% X  {: Z6 Z( M) N
根据 USB 规范一个 HID 报告描述符至少应包括如下条目(Items)2.png
根据 USB 规范一个 HID 报告描述符至少应包括如下条目(Items)1.png
(三) 功能测试及验证
0 H9 z: n$ z; W, FUSB 设备端(Device)发送数据测试,在 usbx_customhid_thread_entry()线程里面每 1S 钟 向 Host 发送一包 64Byte 字节数据,然后我们可以在 PC 机端可以看到已成功收到了数据。
2 \" f) @9 G5 a1 }5 F: i6 z& E
功能测试及验证1.png 功能测试及验证2.png
USB 设备端(Device)接收数据测试,我们在 PC 通过向端点 2 发送数据。在 STM32U5 上通过调试窗口我们可以看到 USB device 已经成功的接收到了数据。% D4 e: K. P( k  p9 {' I

USB 设备端(Device)接收数据测试

USB 设备端(Device)接收数据测试
关于利用 STM32U5 创建 USBx_CustomHID 通信的实现过程就介绍到这里,分享出来供有需要的同仁参考。
4 Q' c6 R5 ?. D; O  K  E0 n1 ^% N6 a6 J2 j+ o. t

点评

请问我照着本例配置,用电脑通过usb发送0x00~0x63数据,usb接收到的第21到24位接收到的数据一直是0x00、0x00、0x40、0x84是什么情况?  发表于 2024-10-20 16:15
收藏 评论1 发布时间:2024-4-22 15:20

举报

1个回答
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
STM32Cube扩展软件包
意法半导体边缘AI套件
ST - 理想汽车豪华SUV案例
ST意法半导体智能家居案例
STM32 ARM Cortex 32位微控制器
关注我们
st-img 微信公众号
st-img 手机版