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

实战经验 | 选择USBX模块生成USB CDC ACM无PD的项目

[复制链接]
STMCU-管管 发布时间:2025-2-24 09:28
01
/ w: A1 D% {! E3 y8 P) r客户需求
7 a! D. A/ E- L* b- f" n客户使用STM32H563开发产品,需要USB CDC ACM虚拟串口的工程,并且要求不使用PD功能,而我们STM32CubeH5代码库中是包含PD功能的工程。于是协助客户解决这个问题,提供给客户不带PD功能的虚拟串口工程。
9 K, K0 O' U" q+ R
: _; O1 a# Q6 z% |0 |3 B  `在STM32CubeMX软件中,选择ThreadX USBX模块完成USB CDC ACM虚拟串口的工程,并且不使能PD功能。
5 }$ x, v$ D! M% D* \
5 P1 ?" {# I: p02! x8 O( }! B* h8 m& n
基本硬件和STM32CubeMX的配置
; D6 N  H/ G7 S: o: k8 c6 t' J- @

. L" G1 L8 M' R7 [+ g& h0 z硬件方面使用客户开发板和NUCLEO_H563ZI同时来进行软件开发。) v2 \; j, {8 l2 y# S5 X

# ]! g/ s( j$ P% [1 R下面是NUCLEO_H563ZI USB Type C接口原理图:- I1 b' y! d- G
12.png
# n- h& l/ R& y
( [4 b( ?/ g5 m5 Z+ S) Y

5 |3 H, N5 p! F( |* `3 Z# `% [% B
由于不使用PD功能,需要对NUCLEO_H563ZI的电路进行改动,在开发板上 PA11、PA12连接到了使用PD功能的Type-C接口,因此需要做如下的硬件修改:需要把SB27、SB28上的两个小电阻换移到SB22、SB21的位置,这样做是把  PA11、PA12连接到开发板的CN12上,然后就可以接USB线了。
" K7 G! S1 u2 ~& z* V- T5 J& Y

. f9 d: r* A' ?+ `
13.png

6 @$ K/ M9 |3 c& y6 D
14.png
+ y$ n( Z" ]  Y5 X1 i

3 w8 ^6 Z8 ]+ n0 m8 h, q" X' _

( v" Q) l3 q' w0 L9 J
USB连接线需要接GND、D+、D-;在对NUCLEO_H563ZI开发板的调试中,VBUS没有连接起来,但客户开发板的设计中是需要连接的。以此来告诉USB Device端(STM32H563ZI)的软件工程,USB线连接到PC上了。

+ T0 I2 I2 k* e, T" B. Y
2.1. 使用STM32CubeMX配置并生成工程(不带trustZone)

- n& P+ w, h; s- }' u
4 x$ D4 K, Z2 g! d/ b6 L, f
* G1 k: W# ^* B7 b; a% J7 M0 i
% I9 ?; U6 ?7 p( ~( R
第一步:开始一个新的不带trustZone工程:
1 R* V+ v9 Q6 \% V+ J1 r- S* |. x# Z
/ f" \9 [0 X- v0 ^. W8 X
15.png ' d5 k5 g  p9 m6 _6 v& \5 j1 H
' B6 Z4 k* d. J0 F3 I* S

& R1 i2 O: L0 k2 W# z. }3 k0 b
第二步:配置USB外设,基本上选择默认配置,同时使能USB的全局中断。
( I1 F; L1 u. V

4 ]( i$ ~9 @( k* P0 z
16.png
7 Q- g1 L7 v, ~" x. i2 {
第三步:配置ThreadX外设,使能Core,其它先选择默认配置。

5 K$ w6 V. a9 ]

& w% j5 W( d. m3 `$ j1 z6 H
17.png 7 I) |+ L: X/ u0 N8 v

$ e9 r$ t- y% D: a! R. i. L) `

7 w& J5 b; M6 e* Z9 A
第四步:配置USBX:

5 G0 c8 J, M8 \8 y
1. 使能Core System。

9 n) I" K  h) _" m  B# f. u9 P. c; ]
2. 在UX Device FS中,选择Device CoreStack FS和Device Contronllers FS。
# @& X9 |! `$ {; M
3. 在Device Class FS中,选择CDC ACM。
. M: P% e$ u, X4 p: C1 A9 W) w
7 o/ i; l7 k8 _5 ], `8 Y; ]# z
18.png 1 |2 a' r' J. ^6 ]: V% P

0 e: n: [" t8 m# v

: j& F9 ?( I5 d0 E5 ?6 K: F+ p
4. 配置USB基本参数。其配置除了对RAM需要设置外,其它选择基本配置就可以了。

7 O  c! k  B0 J5 E# p: X

6 Q4 ?% g5 P- K+ U
19.png / q/ B8 j/ z5 X& L4 \- o( t
5. 其它的Platform,选择USB。

% f9 l+ a- O) v) |' l; H
20.png $ b) l  |9 V) q. U8 G. T" o
9 d! F" g9 v: I$ ]5 T
( Q0 E1 H- Y. t9 U; i+ B
第五步:配置SYS,选择TIM6作为系统滴答时钟的时钟源。

* a3 Q, D8 ~; L" W6 z4 E2 O. ~
' f0 g! D2 L8 A, \# d
21.png
1 X$ Z$ _8 Z( U9 F

" s$ s# Q1 h: @$ k: z: s

) A+ {( I8 H2 b1 m, n: \! I9 L0 A! {
第六步:为了模拟USB的断开也连接,使用一个GPIO来控制USB的断开和连接 (GPIO_EXTI13);并且使能外部中断。

9 `8 g( w) S7 S
( a8 n9 g9 B' Y+ F, R/ a% Q4 N
22.png " P# y+ v& }( m+ G

# l( Y: ^( j) R) N' ~; h* H$ ]

5 b% s" E, @. W5 q% I
第七步:配置时钟,选择默认时钟源。配置系统时钟为250MHz。

# W6 [& t' e( n0 ^- @4 {

# J9 |1 E, J+ {" O8 j
23.png
! ~/ M; C+ g/ y4 A: S/ g
  E" u( D7 b# n( q( {& D3 q- O
* e! p% |0 X  q  h
请注意:使用HSI48作为CRS时钟,同时注意选择HSI48作为USB时钟源。

. R, v5 m6 ~! _7 a
1 Z% P0 I+ h1 j
24.png
! i! q8 S4 j5 c! `+ @" s
" |( w* ?, \7 j$ L
6 L* e# U2 `1 B5 Q8 M+ Z4 o
2.2. 使用STM32CubeMX配置并生成工程
) S9 V2 }: o% x( |+ B
定义一个自己的工程名,由于用的RTOS和USB,所以需要适增加堆栈空间:

( q% `! L2 I7 E# [2 f/ ?

! }. Y/ z+ f7 b0 n) [4 _
25.png
/ H& P. e! {  E' R% Y- [# r( A
最后生成的工程文件的结构如下:

8 O, i: J' u6 |6 P$ m

. J3 z  I7 D6 G% M
26.png
8 S3 x( U# D5 p1 U& m" a* [' m) b! F% a
2.3. 参数配置的解释

& X- Q2 |- A" Q9 W1 B
需要调整USBX Device System Stack Size和USBX Device memory pool size的参数。
1 j) i" c6 w4 l& q$ ?7 ?

+ B8 c- W( I" O! Y+ X+ {
27.png
4 N+ N$ M9 X7 w; c
调整依据请参考如下内容:
' y0 N( W' r7 f6 p" ~" d: N

) a# L+ C/ d6 _. `
28.png
& @# {# `4 A0 ]" k3 H4 L& ^5 y
) Z! A/ F3 ~. O( I! j

' U6 Z8 X# h4 y) p: I* L; S5 z
要定义USBX设备内存池(USBX Device memory pool size)大小的内存量,必须考虑以下因素:
: e" X# Q# }6 Q. {  h" S
1. USBX设备系统堆栈大小(USBX Device System Stack Size)

' f6 Y* q) ?! f, X
2. USBX设备应用程序线程堆栈大小(USBX Device Application Thread stack size)

. Z2 B) u, r6 f" a
3. USB应用程序创建的线程堆栈

. Z, U1 z; S# `! G$ P
4. 以及RX和TX缓冲区
+ d- c* }5 q- Q9 F# x9 N

6 q/ |7 ]: I: e9 a+ b
29.png ; |. c( ]  M& @6 Z4 W! g0 D) I% W

2 g4 _! P: K$ L# U# m+ \
03

. H4 \3 ^/ d+ U4 f
对工程进行完善和修改

" K4 g" i( Q( K" M1 E
由于CubeMX的生成的代码有限,生成软件工程后需要对工程进行完善,具体改动如下:

; m6 ?( t4 l: a. g

" ?" c& C- _0 z7 f- s
30.png
* n" F! E9 S4 P3 b: `  s
& m% E1 \* G! I/ k& q

2 f* w9 I0 h9 @4 ?' N( x
代码开发的第一步是将ST HAL USB驱动程序与USBX固件连接起来,然后初始化USB外设。还需要添加一下必要的代码,下面蓝色部分为需要添加的,绿色部分是生成的代码,你可以搜索绿色部分快捷收到需要添加的位置。

" W8 a! J/ d0 M# q( `4 o1 q* ^/ s/ V6 K* r# x' {1 F& H
第一步:在“app_usbx_device.h”添加必须包含的头文件和需要用到的函数声明。
3 M+ T* M- O1 C: W4 y3 }  k( V
  1. <div style="text-align: left;">/* USER CODE BEGIN Includes *///</div><div style="text-align: left;">#include "ux_dcd_stm32.h"   </div><div style="text-align: left;">#include "main.h"</div><div style="text-align: left;">/* USER CODE END Includes */  </div><div style="text-align: left;">/* USER CODE BEGIN 1 */</div><div style="text-align: left;">#define APP_QUEUE_SIZE  5</div><div style="text-align: left;">typedef enum     </div><div style="text-align: left;">{</div><div style="text-align: left;">STOP_USB_DEVICE = 1,</div><div style="text-align: left;">START_USB_DEVICE,</div><div style="text-align: left;">} USB_MODE_STATE;</div><div style="text-align: left;">/* USER CODE END 1 */</div>
复制代码

) V% d; d4 ]4 c1 M! V( i% y# ~第二步:在“app_usbx_device.c”添加需要用到的变量和函数声明。  _) c  R: ^6 w  B' A
  1. <div style="text-align: left;">/* USER CODE BEGIN PTD */</div><div style="text-align: left;">extern PCD_HandleTypeDef hpcd_USB_DRD_FS;</div><div style="text-align: left;">#if defined ( __ICCARM__ ) /* IAR Compiler */</div><div style="text-align: left;">  #pragma data_alignment=4</div><div style="text-align: left;">#endif /* defined ( __ICCARM__ ) */</div><div style="text-align: left;">__ALIGN_BEGIN USB_MODE_STATE                  USB_Device_State_Msg   __ALIGN_END;   </div><div style="text-align: left;">TX_QUEUE                         ux_app_MsgQueue;   </div><div style="text-align: left;">extern TX_QUEUE     ux_app_MsgQueue;</div><div style="text-align: left;">extern TX_BYTE_POOL ux_device_app_byte_pool;</div><div style="text-align: left;">extern unsigned int USB_connect_State;</div><div style="text-align: left;">/* USER CODE END PTD */</div><div style="text-align: left;">/* USER CODE BEGIN PV */</div><div style="text-align: left;">extern PCD_HandleTypeDef hpcd_USB_DRD_FS;</div><div style="text-align: left;">static TX_THREAD ux_cdc_read_thread;   </div><div style="text-align: left;">static TX_THREAD ux_cdc_write_thread;</div><div style="text-align: left;">unsigned int KeyNumber=0;  </div><div style="text-align: left;">void usb_connect(PCD_HandleTypeDef* hpcd);</div><div style="text-align: left;">void usb_disconnect(PCD_HandleTypeDef* hpcd);</div><div style="text-align: left;">void HAL_GPIO_EXTI_Rising_Callback(uint16_t GPIO_Pin);</div><div style="text-align: left;">void HAL_GPIO_EXTI_Falling_Callback(uint16_t GPIO_Pin);</div><div style="text-align: left;">/* USER CODE END PV */</div>
复制代码

! p) p& e9 M( v
第三步:在app_ux_device_thread_entry函数中,添加链接驱动程序和初始化USB外设的代码。

7 x3 _1 T- ^' X1 d
  1. <div style="text-align: left;">static VOID app_ux_device_thread_entry(ULONG thread_input)      </div><div style="text-align: left;">  /* USER CODE BEGIN app_ux_device_thread_entry */</div><div style="text-align: left;">{</div><div style="text-align: left;">      MX_USB_PCD_Init();   </div><div style="text-align: left;">      HAL_PCDEx_PMAConfig(&hpcd_USB_DRD_FS, 0x00 , PCD_SNG_BUF, 0x40);</div><div style="text-align: left;">      HAL_PCDEx_PMAConfig(&hpcd_USB_DRD_FS, 0x80 , PCD_SNG_BUF, 0x80);</div><div style="text-align: left;">      HAL_PCDEx_PMAConfig(&hpcd_USB_DRD_FS, 0x03, PCD_SNG_BUF, 0xC0);</div><div style="text-align: left;">      HAL_PCDEx_PMAConfig(&hpcd_USB_DRD_FS, 0x81, PCD_SNG_BUF, 0x100);</div><div style="text-align: left;">      HAL_PCDEx_PMAConfig(&hpcd_USB_DRD_FS, 0x82, PCD_SNG_BUF, 0x140);</div><div style="text-align: left;">      ux_dcd_stm32_initialize((ULONG)USB_DRD_FS, (ULONG)&hpcd_USB_DRD_FS);</div><div style="text-align: left;">  /* USER CODE END app_ux_device_thread_entry */</div><div style="text-align: left;">}</div>
复制代码

, e% \; r3 T2 N
先调用MX_USB_PCD_Init()来初始化USB外设;然后使用HAL_PCDEx_PMAConfig(…)进行配置,该函数为STM32H563配置专用USB RAM内存中的PMA(packet memory area),在本例中,端点为0 IN/OUT ( USB标准控制端点)、端点3 OUT  (CDC数据输出点)、端点1 IN  (CDC数据输 入端点)和控制端点2 IN ( CDC 命令端点)。PCD_SNG_BUF参数意味着我们为端点使用单个缓冲区,这是必要的,因为我们在双向模式下使用端点。最后,该函数的最后一个参数是PMA地址,缓冲区大小为64Bytes。

( D% W5 {2 O0 j0 r% B
9 o+ m$ M* s* _8 W4 f; W' e
31.png
- Y" L* F9 v) L3 k
使用内存的第一个地址来存储BTABLE,它是端点缓冲区的地址列表。BTABLE为每个端点存储8个字节。由于STM32H563有8个端点,因此它最多可以消耗64字节。
% k* H( ~/ q4 ?+ ]! h* l' A$ G
+ w/ `- w) ^; w1 n. `

) E! {9 F9 i0 C8 g8 J8 R5 O

% `4 U9 }* i1 {
在本例中,我们使用从0到3的端点,因此可以不使用剩余的其余部分。如果需要可以减少TX Ep 0缓冲区的偏移量,优化内存的使用。但是,按照这个表,您可以毫无问题地分配所有8个端点缓冲区。

7 [8 z1 e& W& F0 n# g; l
+ A# t* g, q2 T' P
8 }1 O: f! @0 _9 ~. X# E5 Y; O8 T
$ U* w- T9 r/ p1 B, t3 e0 e% r
CDC类的配置描述符一般包含一个接口0(Interface 0),一个控制接口,另外一个是数据接口(Interface 1),除此之外,IAD(Interface Association Description),这个是可选的,根据实际情况来确定是否需要。
0 ^( V% u2 n5 f5 k* F) Y7 P+ i
9 J& T; G$ F& e2 G) l  V
) x* }: A$ v6 |; K- h8 e6 M! w' R

' [' _- H( A. L1 N
下一个调用的函数是ux_dcd_stm32_initialize(…) ,它负责将HAL USB驱动程序链接到USBX应用程序。最后,我们调用HAL_PCD_Start(..)来启动 USB PCD外设。
9 M( I/ E. t8 ~9 j) ?0 Q! k
) U) F% L5 p5 G" q

+ ~$ M1 _. A2 P! B6 B
, R% B3 M2 ~% v& \' w! z* o
第四步:在app_usbx_device.c中MX_USBX_Device_Init(…)函数的最后用户代码部分,创建两个线程来处理数据的写和读,以及一个消息句柄,具体的代码如下,最后一个参数为TX_DONT_START,意思是任务先挂起,之后再启动。

' n/ q; A5 J( Q1 Z  h, w  e
  1. <div style="text-align: left;">/* USER CODE BEGIN MX_USBX_Device_Init1 */</div><div style="text-align: left;">    /* Allocate Memory for the Queue */</div><div style="text-align: left;">    if (tx_byte_allocate(byte_pool, (VOID **) &pointer, APP_QUEUE_SIZE*sizeof(ULONG),</div><div style="text-align: left;">                       TX_NO_WAIT) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    /* USER CODE BEGIN MAIN_THREAD_ALLOCATE_STACK_ERROR */</div><div style="text-align: left;">    return TX_POOL_ERROR;</div><div style="text-align: left;">    /* USER CODE END MAIN_THREAD_ALLOCATE_STACK_ERROR */</div><div style="text-align: left;">  }</div><div style="text-align: left;">  /* Create the MsgQueue */</div><div style="text-align: left;">  if (tx_queue_create(&ux_app_MsgQueue, "Message Queue app", TX_1_ULONG,</div><div style="text-align: left;">                      pointer, APP_QUEUE_SIZE * sizeof(ULONG)) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    return TX_QUEUE_ERROR;</div><div style="text-align: left;">  }</div><div style="text-align: left;">/* Allocate memory for the UX RX thread */</div><div style="text-align: left;">if (tx_byte_allocate(byte_pool, (VOID **) &pointer, UX_DEVICE_APP_THREAD_STACK_SIZE,</div><div style="text-align: left;">                       TX_NO_WAIT) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    /* USER CODE BEGIN MAIN_THREAD_ALLOCATE_STACK_ERROR */</div><div style="text-align: left;">    return TX_POOL_ERROR;</div><div style="text-align: left;">    /* USER CODE END MAIN_THREAD_ALLOCATE_STACK_ERROR */</div><div style="text-align: left;">  }</div><div style="text-align: left;">/* Create the UX RX thread */</div><div style="text-align: left;">    if (tx_thread_create(&ux_cdc_read_thread, "cdc_acm_read_usbx_app_thread_entry", usbx_cdc_acm_read_thread_entry,</div><div style="text-align: left;">                       1, pointer, UX_DEVICE_APP_THREAD_STACK_SIZE, UX_DEVICE_APP_THREAD_PRIO,</div><div style="text-align: left;">                       UX_DEVICE_APP_THREAD_PREEMPTION_THRESHOLD, UX_DEVICE_APP_THREAD_TIME_SLICE,</div><div style="text-align: left;">                       TX_DONT_START) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    /* USER CODE BEGIN MAIN_THREAD_CREATE_ERROR */</div><div style="text-align: left;">    return TX_THREAD_ERROR;</div><div style="text-align: left;">    /* USER CODE END MAIN_THREAD_CREATE_ERROR */</div><div style="text-align: left;">  }</div><div style="text-align: left;">   </div><div style="text-align: left;">/* Allocate memory for the UX TX thread */</div><div style="text-align: left;">if (tx_byte_allocate(byte_pool, (VOID **) &pointer, UX_DEVICE_APP_THREAD_STACK_SIZE,</div><div style="text-align: left;">                       TX_NO_WAIT) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    /* USER CODE BEGIN MAIN_THREAD_ALLOCATE_STACK_ERROR */</div><div style="text-align: left;">    return TX_POOL_ERROR;</div><div style="text-align: left;">    /* USER CODE END MAIN_THREAD_ALLOCATE_STACK_ERROR */</div><div style="text-align: left;">  }</div><div style="text-align: left;">/* Create the UX TX thread */</div><div style="text-align: left;">    if (tx_thread_create(&ux_cdc_write_thread, "cdc_acm_write_usbx_app_thread_entry",</div><div style="text-align: left;">usbx_cdc_acm_write_thread_entry,</div><div style="text-align: left;">                       1, pointer, UX_DEVICE_APP_THREAD_STACK_SIZE, UX_DEVICE_APP_THREAD_PRIO,</div><div style="text-align: left;">                       UX_DEVICE_APP_THREAD_PREEMPTION_THRESHOLD, UX_DEVICE_APP_THREAD_TIME_SLICE,</div><div style="text-align: left;">                       TX_DONT_START) != TX_SUCCESS)  //UX_DEVICE_APP_THREAD_START_OPTION</div><div style="text-align: left;">  {</div><div style="text-align: left;">    /* USER CODE BEGIN MAIN_THREAD_CREATE_ERROR */</div><div style="text-align: left;">    return TX_THREAD_ERROR;</div><div style="text-align: left;">    /* USER CODE END MAIN_THREAD_CREATE_ERROR */</div><div style="text-align: left;">  }</div>
复制代码
3 G& f1 ~+ }6 B  \! _
第五步:下面的usb_connect()函数是根据客户需要设计的。在PC端连接到设备端STM32H563,VBUS连接时触发中断后调用的函数(客户产品中把VBUS分压后连接到一个GPIO口,由于客户第一版本的PCB没有设计这部分电路,因此调试时使用按键中断替换了Device连接到PC的情况)。Usb_disconnect()函数,是处理STM32H563从PC断开的情况(调试时使用按键再次按下来替换VBUS断开的具体功能)。保留了信号量,程序处理中如果不使用这个信号量可以删除,具体请参考软件工程文件:
" l6 }5 l0 y% V' B  G8 \
  1. <div style="text-align: left;">/* USER CODE BEGIN PFP */</div><div style="text-align: left;">void usb_connect(PCD_HandleTypeDef* hpcd) {</div><div style="text-align: left;">  HAL_PCD_Start(hpcd);   </div><div style="text-align: left;">  USB_Device_State_Msg = START_USB_DEVICE;</div><div style="text-align: left;">  if (tx_queue_send(&ux_app_MsgQueue, &USB_Device_State_Msg, TX_NO_WAIT) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    Error_Handler();  }</div><div style="text-align: left;">   if(tx_thread_resume(&ux_cdc_read_thread)==TX_THREAD_ERROR)</div><div style="text-align: left;">   {</div><div style="text-align: left;">     Error_Handler();   }</div><div style="text-align: left;">  if(tx_thread_resume(&ux_cdc_write_thread)==TX_THREAD_ERROR)</div><div style="text-align: left;">   {</div><div style="text-align: left;">     Error_Handler();  }</div><div style="text-align: left;">}</div><div style="text-align: left;">void usb_disconnect(PCD_HandleTypeDef* hpcd)  {</div><div style="text-align: left;">  HAL_PCD_Stop(hpcd);  </div><div style="text-align: left;">   USB_Device_State_Msg = STOP_USB_DEVICE;</div><div style="text-align: left;">  if (tx_queue_send(&ux_app_MsgQueue, &USB_Device_State_Msg, TX_NO_WAIT) != TX_SUCCESS)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    Error_Handler();  }</div><div style="text-align: left;">  if(tx_thread_suspend(&ux_cdc_read_thread)==TX_THREAD_ERROR)</div><div style="text-align: left;">   {</div><div style="text-align: left;">     Error_Handler();   }</div><div style="text-align: left;">  if(tx_thread_suspend(&ux_cdc_write_thread)==TX_THREAD_ERROR)   {</div><div style="text-align: left;">     Error_Handler();</div><div style="text-align: left;">   }</div><div style="text-align: left;">}</div><div style="text-align: left;">void HAL_GPIO_EXTI_Rising_Callback(uint16_t GPIO_Pin){</div><div style="text-align: left;">   if(KeyNumber==0)  //please use the status of "VBUS connect and disconnect" to control program direction.</div><div style="text-align: left;">  {</div><div style="text-align: left;">    usb_connect(&hpcd_USB_DRD_FS);   }</div><div style="text-align: left;">   if(KeyNumber==1)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    usb_disconnect(&hpcd_USB_DRD_FS);  </div><div style="text-align: left;">  }</div><div style="text-align: left;">}</div><div style="text-align: left;">void HAL_GPIO_EXTI_Falling_Callback(uint16_t GPIO_Pin){</div><div style="text-align: left;">  if(KeyNumber==0)  //please use the status of "VBUS connect and disconnect" to control program direction.</div><div style="text-align: left;">  {   </div><div style="text-align: left;">    usb_connect(&hpcd_USB_DRD_FS);   }</div><div style="text-align: left;">   if(KeyNumber==1)</div><div style="text-align: left;">  {</div><div style="text-align: left;">    usb_disconnect(&hpcd_USB_DRD_FS);  </div><div style="text-align: left;">  }</div><div style="text-align: left;">}</div><div style="text-align: left;">/* USER CODE END PFP */</div>
复制代码
1 D6 q- W/ |' a6 L
第六步,在ux_device_cdc_acm.h文件并添加必要的头文件包含和函数声明:

+ G# e  j$ ?# D4 R) u! l
  1. <div style="text-align: left;">/* Private includes ----------------------------------------------------------*/</div><div style="text-align: left;">/* USER CODE BEGIN Includes */</div><div style="text-align: left;">#include "app_usbx_device.h"</div><div style="text-align: left;">/* USER CODE END Includes */</div><div style="text-align: left;">/* USER CODE BEGIN EFP */</div><div style="text-align: left;">#define APP_RX_DATA_SIZE   2048   </div><div style="text-align: left;">#define APP_TX_DATA_SIZE   2048</div><div style="text-align: left;">VOID usbx_cdc_acm_write_thread_entry(ULONG thread_input);</div><div style="text-align: left;">VOID usbx_cdc_acm_read_thread_entry(ULONG thread_input);</div><div style="text-align: left;">/* USER CODE END EFP */</div>
复制代码

) b; V: W7 Y. G/ _; Z# }( F0 G" C8 [
第七步,在ux_device_cdc_acm.c添加私有变量并在“USBD_CDC_ACM_Activate”初始化。
3 e+ s7 n6 a( u# q9 k& \9 B! g
  1. <div style="text-align: left;">/* Private define ------------------------------------------------------------*/</div><div style="text-align: left;">/* USER CODE BEGIN PD */</div><div style="text-align: left;">UX_SLAVE_CLASS_CDC_ACM *cdc_acm;   </div><div style="text-align: left;">/* USER CODE END PD */</div><div style="text-align: left;">VOID USBD_CDC_ACM_Activate(VOID *cdc_acm_instance)</div><div style="text-align: left;">{</div><div style="text-align: left;">/* USER CODE BEGIN USBD_CDC_ACM_Activate */</div><div style="text-align: left;">cdc_acm = (UX_SLAVE_CLASS_CDC_ACM *)cdc_acm_instance;     </div><div style="text-align: left;">//UX_PARAMETER_NOT_USED(cdc_acm_instance);</div><div style="text-align: left;">/* USER CODE END USBD_CDC_ACM_Activate */</div><div style="text-align: left;">return;</div><div style="text-align: left;">}</div>
复制代码
0 |/ J( ?: P  f
这样,我们已经有了USB应用程序的功能。类资源在ux_device_cdc_acm.c文件中可用。

" G- V0 w; z* }: A. A; o' R* [
0 k" t' w" I) Y9 e
第八步:在“ux_device_cdc_acm.c”中定义线程的实现程序。
) b' d* T2 Q' l" \
  1. <div style="text-align: left;">/* USER CODE BEGIN 1 */</div> <div style="text-align: left;">6 B+ `$ s3 p" w! y1 N. @
  2. </div><div style="text-align: left;">VOID usbx_cdc_acm_write_thread_entry(ULONG thread_input)</div><div style="text-align: left;">{</div><div style="text-align: left;">      ULONG tx_actual_length;</div><div style="text-align: left;">      const uint8_t message[] = "USBX Application Running!\r\n";</div><div style="text-align: left;">   while(1)</div><div style="text-align: left;">      {</div><div style="text-align: left;">        ux_device_class_cdc_acm_write(cdc_acm, (UCHAR *)(message), sizeof(message), &tx_actual_length);</div><div style="text-align: left;">                     tx_thread_sleep(100);</div><div style="text-align: left;">      }</div><div style="text-align: left;">}</div><div style="text-align: left;">VOID usbx_cdc_acm_read_thread_entry(ULONG thread_input)</div><div style="text-align: left;">{</div><div style="text-align: left;">      /* Private Variables */</div><div style="text-align: left;">      ULONG rx_actual_length;</div><div style="text-align: left;">     uint8_t UserRxBuffer[64];</div><div style="text-align: left;">      while(1)</div><div style="text-align: left;">      {</div><div style="text-align: left;">          if(cdc_acm != UX_NULL)</div><div style="text-align: left;">             {</div><div style="text-align: left;">                    ux_device_class_cdc_acm_read(cdc_acm, (UCHAR *)UserRxBuffer, 64, &rx_actual_length);</div><div style="text-align: left;">                   switch(UserRxBuffer[rx_actual_length-1])</div><div style="text-align: left;">                   {</div><div style="text-align: left;">                   case '1':</div><div style="text-align: left;">                          break;</div><div style="text-align: left;">                   case '0':</div><div style="text-align: left;">                          break;</div><div style="text-align: left;">                   }</div><div style="text-align: left;">             }   </div><div style="text-align: left;">      }</div><div style="text-align: left;">}</div>
复制代码
9 |. G6 K+ w* G) e- l* H0 F. f
% U; B. j9 b2 T6 q# u6 r6 N
04
4 W6 y! ?/ [/ W$ C2 g7 t1 f
对代码进行的测试
1 y+ G2 M# T4 l, T! j
对软件工程添加代码后就可以进入编译和调试环节。

. H; ]% H+ J, z' |8 \- J9 S
: H% H: _) u9 u6 B- Q/ ?
客户第一版的硬件产品板上无PC13按键,要手动触发按键中断,需要在下面蓝色栏中写‘1’,然后按下键盘中的回车键来模拟按键按下的动作。(NUCLEO_H563ZI硬件有这个按键,可以直接使用这个按键来生成按键中断)。

0 R/ f. N2 d* ~8 }* _
1 q+ ~; H' Z8 O
32.png " |: o& b& ?. K3 U/ `: {( ]5 D
或EXTI_SWIER1.SWI13中写1回车后:
( e& V5 ~. q" n! {

" r( P; E5 d0 |6 D0 u1 P
33.png
2 m. ]4 n, g, {' F+ k" m
然后产生外部按键中断:
. ]; C5 D5 L# ?" ^

- N; k' D" W* [9 k
34.png
1 a! h* c( w  u) T
使用USB线连接PC,并且程序全速运行后会看到识别的端口号:

7 _7 s9 E" ~* {5 B
- u, b" ]5 u: Z" F* K
35.png 6 Q. Q- ^! w- _3 C- T
代码运行后在PC端打开UART调试助手,可以看到从虚拟串口接收到的内容,然后PC发送“1”,在usbx_cdc_acm_read_thread_entry函数中设置断点就可以看到接收到的数据:
/ e( s" G* C* k$ d: `2 u

; G( g$ S: Z/ X" j- U1 C
36.png
+ n+ v/ {0 C) d' [- S: p
按键(Nucleo_H563ZI 上的 USER蓝色按键)第一次按下(模拟VBUS上电的动作)后启动(resume)usbx_cdc_acm_write_thread_entry和 usbx_cdc_acm_read_thread_entry任务,在第二次按键按下时挂起(suspend)那两个任务。

2 j0 u; }  x# C2 v6 ]+ o( Z1 _# A1 ^0 K
使用时需要根据情况修改HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_13)函数,以实现使用Vbus上电代替第一次按下Key的功能,Vbus掉电代替第二次按下Key的功能。
, \1 M$ O" C- m/ k
+ n% ?& Q; k# q
, U( k, \' |/ ?: d

9 a& X8 s! g' v9 x+ P
代码调试时Vbus上电(第一次按键)和Vbus下电(第二次按键)之间需要暂停程序,然后在调试状态下,在观察窗中修改KeyNumber的值从0到1;Vbus下电(第二次按键)后需要在窗口中改KeyNumber为0:

% F4 s" T1 o7 O! o

5 |8 K7 `; L% N/ r5 |
/ V: {7 ?! [& ~2 \

! {1 f. h" X6 y
下面的功能在程序中预留了,如果后续程序开发中不使用可以删除。
) Q. T2 t5 \9 N
  1. <div style="text-align: left;">tx_queue_create(&ux_app_MsgQueue, "Message Queue app", TX_1_ULONG,</div><div style="text-align: left;">pointer, APP_QUEUE_SIZE * sizeof(ULONG))</div><div style="text-align: left;">tx_queue_send(&ux_app_MsgQueue, &USB_Device_State_Msg, TX_NO_WAIT)</div><div style="text-align: left;">tx_queue_receive(…)</div>
复制代码

+ a* ^; b: [# O0 S
初次上电后,请全速运行代码,等待初始化完成,第一次按下按键后走usb_connect流程(vbus 上电,参考HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_13)处理函数,代码运行后PC端会看到具体的串口端口号。用串口调试助手测试过数据收发功能后,在调试中暂停代码运行,然后修改KeyNumber从0到1(在观察窗中直接修改后回车)。然后全速运行然后再次按下按键就会走usb_disconnect流程。之后再修改KeyNumber从1到0,再次按下按键(vbus上电),进入的设备枚举阶段…

0 y6 T( p) d2 A3 G* }7 N* w

1 R5 e( T# y; v& D" Q$ X
37.png
/ r4 v1 H3 U2 ^. `7 s: k& S2 W6 B
05
* u8 F5 x! e6 |7 z# G% T
小结
" _* l3 Z7 O/ s4 |4 U4 V& G  z& t1 g
具体的软件工程放在了附件中,使用NUCLEO_H563ZI,然后修改硬件就可以进行测试。

0 V4 f0 Q. [4 V% w
8 ]. A! ]& \/ H9 Q6 q
赞 收藏 评论1 发布时间:2025-2-24 09:28

举报

1个回答
郭若 回答时间:2025-11-4 14:56:50

请问下这个软件工程的附件在哪,怎么没找见😄

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版