|
串口调试在项目中被使用越来越多,串口资源的紧缺也变的尤为突出。很多本本人群,更是深有体会,不准备一个USB转串口工具就没办法进行开发。本章节来简单概述STM32低端芯片上的USB虚拟串口的移植。在官方DEMO中已经提供了现成的程序,这里对修改方法做简单说明。
, X9 V9 h9 ]% f, ^* A! W' s' G首先打开官方demo我们开始进行移植,第一步复制我们可用的文件,操作如下: Projects\Virtual_COM_Port文件夹下,复制红线部分 图1
% w' L! B# i' K+ z5 }& e+ t8 J4 d5 c* Z, J: d$ h, G
图2  $ W: w$ R# N/ K. A8 w& X( ~6 B9 a- ]
6 p/ R$ F o5 ]) f
我为了方便演示统放在usb/src文件夹下: 图3 
& M! u5 P1 T5 A9 X6 {; _# X$ m9 a
$ a: t1 {+ C! f% d0 Y现在复制USB的库文件,这些文件不需要我们修改: 图4 
$ r$ p- G! `/ w$ P% {2 b
8 L0 r* ?1 j% f, [( q上图中的文件统一放在usb/lib文件夹下: 图5  8 G3 S/ m3 I7 O+ |% x U% v X
* }4 ~2 @- {% G
好了现在所需要的文件我们以复制完了。这里先讲一下DEMO程序的主要工作流程: 图6  3 r7 o Y \" S& g+ {3 @$ [
由上图可知,PC通过虚拟串口发送数据到STM32 usb口,STM32再通过usart1发送数据到PC串口。我们做项目时,只用USB虚拟串口即可。所以我们现在需要把串口发送部分删除。把USB做为一个COM口来使用。我们要如何使用这个USB口呢?demo中是把USB发送数据做了一个缓存,先把要发送的数据存入缓存中,然后由USB自动发送出去。而接收部分是直接通过串口透传。我们在应用时就需要用到两个FIFO,1是发送,这个和demo方式是样;2是接收,接收也做一个缓存,我们通过查询来判断是否收到新数据。这下大家应该明白为什么使用两个FIFO了。 我这里有写好的FIFO库函数可直接使用Queue.c文件。 现在开始修改: 1,stm32_it.c 更名为usb_it.c删除无用代码,只保留usb中断函数,和唤醒函数。代码如下: 代码1 - 1 /* Includes ------------------------------------------------------------------*/
$ D$ k5 h( r b7 F& p' q5 j; ]- Y N - 2 #include "hw_config.h"
6 J' \2 o# M. X" {9 c) P# v8 S - 3 #include "usb_lib.h"6 A7 P. ? q3 ^3 b( H% _* M3 i# m
- 4 #include "usb_istr.h". T- | O: N! b( B3 b+ e& W
- 5 , g$ i8 r, ^# X/ u7 S0 K( z9 h
- 6
# q" H8 r' L [( D6 l/ \/ q6 b - 7 /*******************************************************************************
; k" r1 H! _7 {# c R& X: [ - 8 * Function Name : USB_IRQHandler
- N( v# Z) m, Q% i, x, W6 u - 9 * Description : This function handles USB Low Priority interrupts; p2 I& [. i, V/ I- u
- 10 * requests.% _+ A& |9 w! S* E0 r5 t( `
- 11 * Input : None' Y+ ~6 u X# c0 [0 a- _
- 12 * Output : None4 |8 ]# a/ s- q; X/ f; i" G
- 13 * Return : None; ]0 ?3 O, H m; f, H; ^
- 14 *******************************************************************************/0 `9 Z8 z4 f7 {8 I% F9 X6 s" |3 h
- 15 #if defined(STM32L1XX_MD) || defined(STM32L1XX_HD)|| defined(STM32L1XX_MD_PLUS)|| defined (STM32F37X)
% F ? X8 p/ {0 J* n+ G( ?) o - 16 void USB_LP_IRQHandler(void)# ]% O/ _% q% z5 A3 V; B+ e q
- 17 #else
- k* F6 s1 M/ L/ Q3 N0 r6 f, ]1 \ - 18 void USB_LP_CAN1_RX0_IRQHandler(void)
: Q+ j9 C: m! f5 s- A - 19 #endif
( t2 P, g: C" e2 w; H" z - 20 {
n0 K4 t) N f( r! U m/ q; } - 21 USB_Istr();
1 ?$ O& n# p7 q6 a, ~ - 22 }3 i& e% ^ e( _ i0 q
- 23
2 X @3 g7 U* c$ m& m - 24 /*******************************************************************************4 b/ K, Q, [6 Z& o4 w
- 25 * Function Name : USB_FS_WKUP_IRQHandler& f% l1 M& d1 X* |# Z
- 26 * Description : This function handles USB WakeUp interrupt request.5 |6 @: m) i# y5 C
- 27 * Input : None! b8 r5 f' M( `
- 28 * Output : None' S/ w2 ~8 y8 m! U
- 29 * Return : None. ^, s7 Q! f% c
- 30 *******************************************************************************/$ u* n% G0 [1 ~% W# c7 N
- 31
" O( z6 L/ o: t0 M0 O1 P% Z - 32 #if defined(STM32L1XX_MD) || defined(STM32L1XX_HD)|| defined(STM32L1XX_MD_PLUS)
) {/ O. X2 s5 ?0 f$ T, b - 33 void USB_FS_WKUP_IRQHandler(void)
v6 V6 G7 i- x- ]6 ^# a - 34 #else/ t! A F- [$ ?) t
- 35 void USBWakeUp_IRQHandler(void)
4 A' }: [4 D2 o) Z4 O! X$ L - 36 #endif
9 f; r& m( K! A+ ~ - 37 {3 q1 G+ S9 Z. k1 Z. ~, ?
- 38 EXTI_ClearITPendingBit(EXTI_Line18);
q4 p7 c; K0 [! c8 f+ @1 D - 39 }
复制代码
0 Y1 M* l& V' }: ^" h+ M2,修改代码hw_config.c删除无用代码,新建立2组,读FIFO和写FIFO的函数。后面会用到。 代码如下: 代码2 - <img src="https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif" border="0" alt=""> View Code
复制代码这里要讲一下为什么要屏蔽SystemInit(),因为demo只运行虚拟串口功能,在USB未插入的情况下,是进入低功耗状态,插入时从低功耗状态退出后会调用此函数。当然我们在项目中一般不会这样,系统是否运行和插USB接口没有联系。所以我在下文中把进入低功耗代码屏蔽了,自然也就不用唤醒代码了。 图7  ' c ?, c' W6 g8 r3 A- @( q ]
5 T+ W4 _8 X8 [# n$ a3 g6 A
关于USB口使能控制引脚,需要根据开发板的引脚定义来修改宏定义platform_config.h文件中,笔者使用的是神舟3号开发板,控制信号刚好和demo相反,所以修改hw_config.c代码如下: 代码3 - 1 /*******************************************************************************
& B0 A4 |0 z) W9 Y - 2 * Function Name : USB_Cable_Config
1 [- |2 ]9 C: k S, V& R - 3 * Description : Software Connection/Disconnection of USB Cable
2 d) Q# T" Z7 @ c0 S0 a1 ~! {: |' e/ R - 4 * Input : None.
* R/ k" z/ L1 A: ]# ^ - 5 * Return : Status
7 k6 q# T% A$ o, p7 s4 U9 T - 6 *******************************************************************************/
: o0 q F0 }& U% b l- M& V+ _ - 7 void USB_Cable_Config (FunctionalState NewState)
' h8 J& b' @0 q8 j7 ? - 8 {
! |* C$ M: Z: k+ s1 g! c - 9 if (NewState == DISABLE)
# o- p; L& l* Y% n. \6 s2 J - 10 {7 a- k2 A' u2 B
- 11 GPIO_ResetBits(USB_DISCONNECT, USB_DISCONNECT_PIN);
2 t* e+ A" a0 Z9 G( p% S - 12 }
. R% }; L# x; |- z) @, J5 E - 13 else
9 o( m7 w+ K D/ e4 y/ c$ M - 14 {$ T0 B' M* F0 [9 S$ U* a
- 15 GPIO_SetBits(USB_DISCONNECT, USB_DISCONNECT_PIN);" Q1 }: w e; w, I) X
- 16 }* M2 @1 q A. o
- 17 }
复制代码 ; W) K8 ?+ v+ X. @& Z
3,现在修改USB 回调函数中的代码usb_endp.c文件。使用下文代码替换: 代码4 - 1 /* Includes ------------------------------------------------------------------*/+ p4 o- C7 K( G1 [5 ?7 Y
- 2 #include "usb_lib.h"
% R0 s- N! ~- R - 3 #include "usb_desc.h"" p q x2 t P% l! l3 c' h6 l8 _
- 4 #include "usb_mem.h"' o. Y* i ^8 y2 k, g
- 5 #include "hw_config.h"
1 ~. i0 A+ E" D4 ^( H3 M - 6 #include "usb_istr.h"+ h$ \" n2 Z( \4 g3 X I J. @) u' z3 M
- 7 #include "usb_pwr.h"7 a4 e& a. {$ R' F0 Q5 a/ r; L
- 8 - Z7 A! v; ^! ~8 a% a4 d
- 9 /* Private typedef -----------------------------------------------------------*/: N2 L, Z. d- ?/ c0 e+ ^5 e
- 10 /* Private define ------------------------------------------------------------*/
' H2 {. a4 z7 P( Y - 11 . t5 V; H/ N8 l8 l' H) f$ H
- 12 /* Interval between sending IN packets in frame number (1 frame = 1ms) */" ^& Y+ d) B. K( [
- 13 #define VCOMPORT_IN_FRAME_INTERVAL 5# B* O" \# s* t7 O
- 14
3 d" s+ D9 M4 p! h - 15 /* Private macro -------------------------------------------------------------*/5 N: j; ~# c6 k' s Q9 C
- 16 /* Private variables ---------------------------------------------------------*/
/ E. U7 L, Z2 P4 b+ u, G1 E - 17 static uint8_t txBuffter[VIRTUAL_COM_PORT_DATA_SIZE] = {0};
+ I4 z6 i5 C( n7 H& ~4 x - 18 static volatile uint8_t txFlg = 0;1 A$ Q- L& U" D( Y* p
- 19 static volatile uint32_t FrameCount = 0;
+ [! q9 G1 B* j! i2 q! n - 20
% C3 P" t2 ^" u0 I' J - 21
$ H! W) Z- M0 r' W - 22 /* Private function prototypes -----------------------------------------------*/1 B, ~! F- a: M6 \
- 23 /* Private functions ---------------------------------------------------------*/4 O" R4 b2 E) r
- 24 2 c- C) Y }5 O! `
- 25 /*******************************************************************************' p! C p& F$ L
- 26 * Function Name : EP1_IN_Callback
# V( P) y0 m4 y* q+ ? - 27 * Description :
6 \! B; p2 O9 t1 t, {' O - 28 * Input : None./ ?0 A, e% d) F5 |) d$ s" X0 S
- 29 * Output : None.
% m" e, l# U, q - 30 * Return : None.7 `, F$ w1 p) x' r5 H
- 31 *******************************************************************************/
9 z% v' [/ N1 p; R ?/ Q - 32 void EP1_IN_Callback (void)# ^; M* v w/ s2 x9 }6 P. s
- 33 {
. b' \5 e$ k/ `) @" s - 34 uint16_t len = 0;! q l6 t/ N% p: R/ N2 w8 }6 q3 h5 ^
- 35
$ N8 e b2 B; y" l - 36 if (1 == txFlg)0 a* c a* M7 W
- 37 {
+ l# e$ _. m& x% x9 I+ W - 38 len = USB_TxRead(txBuffter, sizeof(txBuffter));
6 t$ p$ v3 h! C0 ]+ j- F5 K4 u - 39 9 Y# H4 w3 b- G& L
- 40 if (len > 0)
3 F# V5 _: `0 T6 C - 41 {! @2 N& }: f$ g; [( H. l
- 42 UserToPMABufferCopy(txBuffter, ENDP1_TXADDR, len);8 _( I1 @+ A1 j5 a9 [9 s
- 43 SetEPTxCount(ENDP1, len);
# C- c" R Y, {8 p2 r- w - 44 SetEPTxValid(ENDP1); 1 V( x$ [, F& H3 @, \
- 45 FrameCount = 0;
5 u' T& J; l, {5 P5 S - 46 }" C4 ?0 ]& x% f+ ]8 d
- 47 else
: b7 P6 s4 u- s9 H; t( I2 C/ G - 48 {
1 }) L( e# \0 {. e - 49 txFlg = 0;) s6 r1 n9 m) f% ~0 T) t2 `
- 50 }1 F* L* J8 W& F t
- 51 }
]/ |9 ]3 {+ f" `( d, t7 I - 52 }) y/ r+ b8 e, C$ }
- 53 / |. R6 c/ P1 e& {% L1 M4 Y
- 54 /*******************************************************************************
5 j. V4 _/ d- P" h2 J) x; ^5 d# f - 55 * Function Name : EP3_OUT_Callback+ E( E% a& }6 f
- 56 * Description :
1 y1 y4 Q3 y# |7 l - 57 * Input : None.
" g3 H4 U6 C$ f; @2 r - 58 * Output : None.
) J0 }5 [2 j0 j( u, O. r - 59 * Return : None.' X$ Q: [& Y0 ^. ~0 t
- 60 *******************************************************************************/
. Y8 m0 e8 E" f& G - 61 void EP3_OUT_Callback(void)
( l" P! p4 N$ I( P0 u$ y - 62 {9 h! t5 }$ k1 [- u; ^
- 63 static uint8_t buffter[VIRTUAL_COM_PORT_DATA_SIZE] = {0};( V, L# i) e7 I' t( P
- 64
' D; ?$ y7 _) Z# y9 ~5 p - 65 uint16_t USB_Rx_Cnt;
$ q: x. I2 n! |! U - 66
# d( _& z A0 {, b% T - 67 /* Get the received data buffer and update the counter */7 s% l; v O, b7 }8 ~) D2 W' D7 b
- 68 USB_Rx_Cnt = USB_SIL_Read(EP3_OUT, buffter);
" W* ?9 Y) s H3 u6 N - 69 : ^& F7 B/ f1 k3 Q+ i; t8 H
- 70 /* USB data will be immediately processed, this allow next USB traffic being % o `7 p" x/ H2 K' C
- 71 NAKed till the end of the USART Xfer */
1 Z! N$ M, g6 m - 72 USB_RxWrite(buffter, USB_Rx_Cnt);
: G! D! C5 W% H) y m - 73 6 M7 Y9 @& W/ i) v5 p) J0 m& P' X
- 74 /* Enable the receive of data on EP3 */: e L5 ?' n, O$ K' c! m5 Q
- 75 SetEPRxValid(ENDP3);( c x7 `1 {- z
- 76 6 O! Z# Y, }" ~$ s; u0 @
- 77 }
' T3 J; r, |* i - 78 % c" v) d! O: J
- 79 1 B+ [, }" \$ L k
- 80 /*******************************************************************************- |. D/ e3 E; C6 i! Y# I! ?
- 81 * Function Name : SOF_Callback / INTR_SOFINTR_Callback. f l+ T2 s* c' @; G
- 82 * Description :) K @1 y: @* m
- 83 * Input : None.
7 k$ O0 h N8 |+ U0 ~- i6 I - 84 * Output : None.
: R. w+ t! T" C" t* ?; d - 85 * Return : None.
5 M$ @1 ~; a+ @/ H! L0 ? - 86 *******************************************************************************/$ H/ k2 `* P+ r8 Y; K6 ~6 h
- 87 void SOF_Callback(void)
- S8 N/ B+ x( p, A - 88 {
3 E! L9 ^3 Z8 D) Z# B6 m7 D - 89 uint16_t len = 0;) T9 {( _6 }$ Z! b6 X
- 90
# O: T& U2 T' r4 g/ K9 `3 a- U+ ? - 91 if(bDeviceState == CONFIGURED)& \( p2 q) Q! F. ]/ M
- 92 {
# T& W* {0 g: a( G( [! ^0 \9 e - 93 if (0 == txFlg)
0 v+ @: Y4 z$ W) y5 h - 94 {! f$ l) v: Y% t. ]; g3 h
- 95 if (FrameCount++ == VCOMPORT_IN_FRAME_INTERVAL)# G, R, L8 A2 e; H- K- J, B
- 96 {% U' I0 o* n5 L
- 97 /* Reset the frame counter */
9 `& z, d6 W V. R; C - 98 FrameCount = 0;; [" F& ~4 r1 a$ |
- 99
% T5 a m( {( | - 100 /* Check the data to be sent through IN pipe */( c: n( w9 M. r9 p
- 101 len = USB_TxRead(txBuffter, sizeof(txBuffter));/ _7 O9 j. f$ U" Y) W) w% d
- 102 ( e4 C( r% V4 u; y% d) T+ m9 p
- 103 if (len > 0)$ n1 `9 J( L' f6 ~
- 104 {; D: r/ P+ W. v5 q
- 105 UserToPMABufferCopy(txBuffter, ENDP1_TXADDR, len);
+ H4 a1 a8 Z+ Q& q' A - 106 SetEPTxCount(ENDP1, len);' d, v$ v# b5 P% F+ x1 e: b/ o' k
- 107 SetEPTxValid(ENDP1);
7 a1 C' C9 m- q+ I& y3 ~9 a/ W - 108
9 y+ B: T. e8 ?/ }1 ]3 i - 109 txFlg = 1;; b3 O+ k6 K+ Q6 v/ F, v7 R$ L
- 110 }
& ^) }( a I7 X - 111 }& |/ j" I7 b) v
- 112 }6 ~" @; C& s; Z) K I
- 113 } " X# C2 V$ W+ n
- 114 }* k, `9 a- I, V) Q: l: y4 v
- 115 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
复制代码 % A& N# D. t# H. b s6 ~6 u
" ?" D' z7 R: M
这里讲下大概意思,函数EP3_OUT_Callback是在USB口收到数据后,将数据存入FIFO中。 函数SOF_Callback定时查询用户是否有要发送的数据,如果有则进行发送,在发送完成后会触发发送中断EP1_IN_Callback函数,如果发送完毕就不调用SetEPTxValid(ENDP1)函数,发送完成后就不会再触发EP1_IN_Callback函数。 4,修改usb_pwr.c在前文中说到:不让系统进入休眠状态,这里屏蔽185行 __WFI(); 5,修改usb_prop.c屏蔽COM初始化代码。137行USART_Config_Default(); 237行USART_Config(); 6,修改usb_desc.c 这里修改需要参考一些USB专业的书籍,推荐全圈圈的书,讲的通俗易懂。关于本程序的驱动,笔者在win7下测试可以自动安装,如果无法自动安装可使用文章开始的链接中的驱动程序。本文件如果修改需谨慎,其中pid,vid是制造商ID和产品编号,如果修改了那驱动也要对应修改,官方驱动就无法自动进行安装了。 到这里移植就差不多完成了,下面进行测试。由于USB虚拟串口不受波特率限制,所以笔者进行过50k/s的压力测试,运行半小时未丢1个字节。 移植好的工程STM32_UsbVirtualCom.rar也一起存放在上文章开始的链接中。 6 A# o# b8 R5 \5 X: R
|