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
# 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' ?+ `
6 @$ K/ M9 |3 c& y6 D
+ y$ n( Z" ] Y5 X1 i
3 w8 ^6 Z8 ]+ n0 m8 h, q" X' _
( v" Q) l3 q' w0 L9 JUSB连接线需要接GND、D+、D-;在对NUCLEO_H563ZI开发板的调试中,VBUS没有连接起来,但客户开发板的设计中是需要连接的。以此来告诉USB Device端(STM32H563ZI)的软件工程,USB线连接到PC上了。
+ T0 I2 I2 k* e, T" B. Y2.1. 使用STM32CubeMX配置并生成工程(不带trustZone)
- n& P+ w, h; s- }' u4 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
' 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
7 Q- g1 L7 v, ~" x. i2 {第三步:配置ThreadX外设,使能Core,其它先选择默认配置。
5 K$ w6 V. a9 ]
& w% j5 W( d. m3 `$ j1 z6 H
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 y1. 使能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
1 |2 a' r' J. ^6 ]: V% P
0 e: n: [" t8 m# v
: j& F9 ?( I5 d0 E5 ?6 K: F+ p4. 配置USB基本参数。其配置除了对RAM需要设置外,其它选择基本配置就可以了。
7 O c! k B0 J5 E# p: X
6 Q4 ?% g5 P- K+ U
/ q/ B8 j/ z5 X& L4 \- o( t
5. 其它的Platform,选择USB。
% f9 l+ a- O) v) |' l; H
$ 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
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
" 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
! ~/ 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
! 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 _
/ H& P. e! { E' R% Y- [# r( A最后生成的工程文件的结构如下:
8 O, i: J' u6 |6 P$ m
. J3 z I7 D6 G% M
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+ {
4 N+ N$ M9 X7 w; c调整依据请参考如下内容: ' y0 N( W' r7 f6 p" ~" d: N
) a# L+ C/ d6 _. `
& @# {# `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, X2. USBX设备应用程序线程堆栈大小(USBX Device Application Thread stack size)
. Z2 B) u, r6 f" a3. USB应用程序创建的线程堆栈
. Z, U1 z; S# `! G$ P4. 以及RX和TX缓冲区 + d- c* }5 q- Q9 F# x9 N
6 q/ |7 ]: I: e9 a+ b
; |. 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
* 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
- <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
- <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- <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
- 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- <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 \
- <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- <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
- <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" \
- <div style="text-align: left;">/* USER CODE BEGIN 1 */</div> <div style="text-align: left;">6 B+ `$ s3 p" w! y1 N. @
- </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
" |: o& b& ?. K3 U/ `: {( ]5 D
或EXTI_SWIER1.SWI13中写1回车后: ( e& V5 ~. q" n! {
" r( P; E5 d0 |6 D0 u1 P
2 m. ]4 n, g, {' F+ k" m然后产生外部按键中断: . ]; C5 D5 L# ?" ^
- N; k' D" W* [9 k
1 a! h* c( w u) T使用USB线连接PC,并且程序全速运行后会看到识别的端口号:
7 _7 s9 E" ~* {5 B - u, b" ]5 u: Z" F* K
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
+ 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
- <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
/ r4 v1 H3 U2 ^. `7 s: k& S2 W6 B05 * 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
|
请问下这个软件工程的附件在哪,怎么没找见😄