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

keil+stm32+jlink 用swd方式printf输出

[复制链接]
sayuenala 发布时间:2016-7-17 14:31
使用ITM机制实现调试stm32单片机,实现printf与scanf。
) N$ E- B) c7 A
$ v/ ]1 C9 C9 d* [$ F9 I) {1. ITM简介* b: U' K' o' ]$ W% a1 @) }
ITM机制是一种调试机制,是新一代调试方式,在这之前,有一种比较出名的调试方式,称为半主机(semihosting)方式。, p5 o( k& l0 T6 q5 g5 |

* w, I1 C# o; \* d+ D在pc上编写过C语言的人都知道,printf可以向控制台输出,scanf可以从控制台获取输入,这里的printf/scanf都是标准库函数,利用操作系统的这些函数,我们可以很方便的调试程序。在嵌入式设备上(如stm32单片机平台上)开发工具(如MDK/IAR)也都提供了标准库函,自然也提供了printf/scanf函数,那么这些函数是否可以使用呢? 问题来了,printf向哪里输出呢?并且大部分情况下,也没有键盘,又如何使用scanf实现输入呢?
5 e4 c& R0 e: @9 e' p: a  F4 d
! ?. b; w5 j8 Q# B  z$ a我们都知道,嵌入式设备一般的使用仿真器,如常见Jlink/ulink,可以实现烧录,单步,下断点,查看变量,等等。仿真器将PC机和单片机连接器来。聪明的设计者们就在考虑是否可以借助仿真器,使得单片机可以借助PC机的屏幕以及PC机的键盘实现printf的输出和scanf的按键获取。
+ _1 ~% }, j+ A. G  Q0 V也就是说,如下的hello,world程序, ?/ C: l( f. q6 c; t
# J2 f8 @( [8 q5 n
  1. #include <stdio.h>  , K5 C, E! C, \$ [9 H' U
  2. int main()  ; X2 h! |0 X, X: |, f. T
  3. {  
    3 y5 U3 C1 ~8 _5 Z- O3 N
  4.         //硬件初始化  : O8 V- E" \* A, Y+ q$ _
  5.         //....  
    8 A8 p6 _6 s' \8 h& `1 D0 h! G
  6.         printf("hello, world");  
    ; U( ]6 X2 s, c) c& e$ t
  7.         for(;;);  9 z3 ?- e. V2 N, C  y# K/ F% w
  8. }  
复制代码

' C4 \1 ^( n: Y# L5 f, ]
& a0 P8 u4 ]' t& \
) j/ W! O% G% @8 l
这个程序烧录到单片机中后,仿真器连接接单片机与PC,开始在线调试后,那么这个程序会将"Hello, world"输出到PC机上,在开发工具(MDK/IAR等)的某个窗口中显示。
) n/ p2 O/ v! G- \' ~/ u& ]: p* C3 ~
, [7 |: s6 \, s+ W- _3 m# Q这就相当于,单片机借助了PC机的显示/输入设备实现了自己的输出/输入。这种方式无疑可以方便程序开发者调试。. H" C/ w+ I5 Q% }
$ C$ K: [0 T" N+ [
这种机制有多种实现方式,比较著名的就是semihosting(半主机机制)和ITM机制。& D- [' s/ G% D# \1 d+ W
ITM是ARM在推出semihosting之后推出的新一代调试机制。现在我们来尝试一下这种方式调试。) H4 u0 ]" k' E! _1 h5 k0 E  }. @

2 X& A' A- u7 M4 K2. stm32使用ITM调试
0 V3 N& E, O2 _! }& C' L4 WMCU:stm32f207VG& y3 j7 O' ~. k. G/ I: x
仿真器:Jlink V8
4 e- I5 G' q$ b% ]; W/ rIDE:MDK4.50. h" F$ T' V: \
% c- c$ i# k, ?
2.1 硬件连接" k2 `% {# b4 B
ITM机制要求使用SWD方式接口,并需要连接SWO线,一般的四线SWD方式(VCC SDCLK,SDIO,GND)是不行的。标准的20针JTAG接口是可以的,只需要在MDK里设置使用SWD接口即可。
( C  E# r9 x& {1 s/ m8 I; G" H3 {& x: ^$ o8 K
2.2 添加重定向文件
; P2 N7 G* h3 C! Y9 ^$ X- I4 g将下面的文件保存成任意C文件,并添加到工程中。这里对这个文件简单说明一下,要知道我们的程序是在单片机上运行的,为什么printf可以输出到MDK窗口里去呢?这是因为 标准库中的printf实际上调用 fputc实现输出,所以我们需要自己编写一个fputc函数,这个函数会借助ITM(类似于USART)提供的寄存器,实现数据的发送,仿真器会收到这些数据,并发往PC机。4 b' W$ ]* a8 P4 c! @
' V/ J0 `2 l3 t/ j. |
实际上,如果你的单片机和一块LCD连接,那么你只需要重新实现fputc函数,并向LCD上输出即可,那么你调用printf时就会输出到LCD上了。这中机制,就是所谓的重定向机制。  y2 D# h0 U/ d: ^
9 j5 k( a' Y& V7 X% x' X5 \! W

6 w  T. h0 t" |  Q7 @
  1. #include <stdio.h>    z* ?2 L0 g& G
  2.   ; T- K' f. ^/ D. A' R/ d" j
  3. #define ITM_Port8(n)    (*((volatile unsigned char *)(0xE0000000+4*n)))  9 u8 a3 O# N5 a; g7 z, ^) |
  4. #define ITM_Port16(n)   (*((volatile unsigned short*)(0xE0000000+4*n)))  ( w1 S9 _9 T& H6 X0 r
  5. #define ITM_Port32(n)   (*((volatile unsigned long *)(0xE0000000+4*n)))  
    ( T- b% C* S% P3 |2 \% f' `
  6. #define DEMCR           (*((volatile unsigned long *)(0xE000EDFC)))  
    # c9 u$ a8 ~/ A8 m) u
  7. #define TRCENA          0x01000000  ' p3 B+ @1 n! x! n( _0 V
  8.   
    ' J; Q$ ^- ~: ^- a
  9. struct __FILE { int handle; /* Add whatever you need here */ };  2 |) z. d* V& N+ F# ]$ j8 M, b2 M
  10.     FILE __stdout;  
    3 Z7 y0 S) g' V; s
  11.     FILE __stdin;  : }% o6 P, W) t! [( S% z! J
  12.       . [3 m+ s+ |! U, s1 S
  13. int fputc(int ch, FILE *f)   1 l, I! Q- |7 {5 p1 H: r
  14. {  # F9 f8 U4 n( a% F2 M7 `
  15.     if (DEMCR & TRCENA)   
    , q7 Y- k0 {3 e# O
  16.     {  8 w% O9 F4 r5 K- q! a/ Q" @% k" V9 R
  17.         while (ITM_Port32(0) == 0);  
    9 _8 u) X2 T, m2 ~" @+ f: j
  18.         ITM_Port8(0) = ch;  
    3 Y. X3 P5 q* I
  19.     }  $ P7 U  I6 b3 k% U  J6 c
  20.     return(ch);  
    , K6 s1 I: _, S
  21. }  
复制代码
! H( U. {  o& h$ k/ [5 e( o  g

+ K1 t7 r) F( R8 z1 `4 n5 n* r2.2 配置JLINK的初始化配置文件
! c: x6 M, P: M9 g* Y5 V
1 f# E; s( `7 G6 O# f/ A- N. t将下面文件放置在你的工程下,并取任意名称,这里笔者取名为 STM32DBG.ini- d/ I, R! k; g) ^

% ^0 ]5 {4 @' |, C7 I+ G+ Y

" i$ B: u6 x$ G6 S( f3 Z2 ~
  1. /******************************************************************************/  
    - C! q6 M# z5 P$ R* l3 Y4 M
  2. /* STM32DBG.INI: STM32 Debugger Initialization File                           */  ! m8 t9 M  F2 Y; f
  3. /******************************************************************************/  & L/ Z3 |4 i5 F5 x
  4. // <<< Use Configuration Wizard in Context Menu >>>                           //   
    + V- q) u+ C/ `" z
  5. /******************************************************************************/  ( U% M* w) h6 b7 a. W
  6. /* This file is part of the uVision/ARM development tools.                    */  
    1 [2 @5 `& @" ?( K( z* a' ]
  7. /* Copyright (c) 2005-2007 Keil Software. All rights reserved.                */  
    0 I% K- K- m3 `& H
  8. /* This software may only be used under the terms of a valid, current,        */  % U4 m! v9 w0 V& D
  9. /* end user licence from KEIL for a compatible version of KEIL software       */  2 N4 K' k7 G% H" R' i' x" j
  10. /* development tools. Nothing else gives you the right to use this software.  */  
    1 e  y9 |* T) X& e
  11. /******************************************************************************/  5 I$ g; _. @' b
  12.   3 C0 y' w- k/ T2 _9 q- T/ _
  13.   
      j! u. A4 B6 l. M0 i3 E8 Y9 L
  14. FUNC void DebugSetup (void) {  
    8 k9 X% B: y4 B: {
  15. // <h> Debug MCU Configuration  
    & S8 m1 R% e- M! o; `7 W5 s
  16. //   <o1.0>    DBG_SLEEP     <i> Debug Sleep Mode  ! }- v1 r$ h  u# H6 X* Y
  17. //   <o1.1>    DBG_STOP      <i> Debug Stop Mode  
    ) z' c. t. W! S7 s
  18. //   <o1.2>    DBG_STANDBY   <i> Debug Standby Mode  
    $ K/ M0 `6 H% `1 u# \7 l7 j2 R0 E  N
  19. //   <o1.5>    TRACE_IOEN    <i> Trace I/O Enable   
    $ `* w) B/ p& J8 L
  20. //   <o1.6..7> TRACE_MODE    <i> Trace Mode  + `+ Z: M3 v# M% |: L7 P2 S, S
  21. //             <0=> Asynchronous  
    1 N0 C+ N: r+ O  i+ `- w9 |) K
  22. //             <1=> Synchronous: TRACEDATA Size 1  , s# _) ]: o+ _5 O9 h3 `
  23. //             <2=> Synchronous: TRACEDATA Size 2  2 g& i, ~( ~2 _* V( ~  D: h
  24. //             <3=> Synchronous: TRACEDATA Size 4  
    " d/ L& S1 s( u& O. h! i
  25. //   <o1.8>    DBG_IWDG_STOP <i> Independant Watchdog Stopped when Core is halted  6 @3 x7 v+ b1 E; j, G" _
  26. //   <o1.9>    DBG_WWDG_STOP <i> Window Watchdog Stopped when Core is halted  8 x# K( I4 X5 l' [# C( R
  27. //   <o1.10>   DBG_TIM1_STOP <i> Timer 1 Stopped when Core is halted  
    / C( D' y0 q5 @! m
  28. //   <o1.11>   DBG_TIM2_STOP <i> Timer 2 Stopped when Core is halted  / g! E; M$ ~2 m6 }1 \* V
  29. //   <o1.12>   DBG_TIM3_STOP <i> Timer 3 Stopped when Core is halted  
    7 l' d& G9 @  \( r! n
  30. //   <o1.13>   DBG_TIM4_STOP <i> Timer 4 Stopped when Core is halted  
    " u# `& K: R8 x2 y
  31. //   <o1.14>   DBG_CAN_STOP  <i> CAN Stopped when Core is halted  9 |. D0 Q( c4 V' u1 j; y8 \, ?
  32. // </h>  4 m( C4 n" N) ~* E4 o, X
  33. _WDWORD(0xE0042004, 0x00000027);  // DBGMCU_CR  
    4 ]! `  ^3 k' H3 d9 n
  34. _WDWORD(0xE000ED08, 0x20000000);   // Setup Vector Table Offset Register  
    4 G! l& b: T/ [
  35. }  0 n7 l1 Y; U8 R# t
  36.   # F- V1 R, k# @0 I4 x/ V/ S
  37. DebugSetup();                       // Debugger Setup
复制代码

; \  h2 A- G* @8 ^4 t
( K$ g1 `& G1 L9 e, d8 y7 N这里对这个文件做简单的解释,
8 H6 }6 R. \( A. H, b; E" e) T$ N_WDWORD(0xE0042004, 0x00000027); // DBGMCU_CR% F" W7 R' E2 {+ F" r3 w
这一句表示想 0xE0042004地址处写入 0x000000027,这个寄存器是各个位表示的含义在注释中给出了详细的解释。 0x27即表示
( F; S5 j5 D8 |( r4 j        BIT0 DBG_SLEEP% ]9 r$ z" i$ v( [) R
        BIT1 DBG_STOP
! }# t! w+ k. V: z& n4 J        BIT2 DBG_STANDBY0 y; ?' }2 y& X. M! p/ @; q
        BIT5 TRACE_IOEN! Q7 ]5 y1 N/ J9 \* S( Y
注意,要使用ITM机制,必须要打开BIT5。
" x# T. {9 D4 h+ `  ^; D$ D/ p: D8 x) U. b
打开MDK工程,按照下图修改。
. R4 a, n2 ~- K/ }8 z
1.jpg
  ^- h+ |% q' r; ?2 N
' I' {# o- u0 U. c" S# p
2.3 MDK中对JLINK的配置
+ I3 W# S2 V- W  `" j0 g# J
2.jpg
# N9 Q7 k8 j0 a1 D
( c" p  k- U% t; o
下图中注意两点" [9 \: d" _# `- _  H5 ?; o
1). 这里的CoreClock是120M,因为笔者使用的是stm32F207VG这款芯片,并且时钟配置为120M,所以这里填入120M,如果你使用stm32F10x,时钟配置成72M,那么这里需要填入72M。即需要跟实际情况保持一致。2 d1 I3 I- r; D: z
2). 最后一定要将 0处打勾,并将其他bit位上的勾去掉,最好与此图保持一致,除CoreClock外。
5 o5 {( K6 g+ Y) ^
3.jpg 3 y+ P* w/ W3 ?' S! l5 u2 z

4 X! Y3 v( u/ O: E, M2.4 烧录程序,并启动调试。可以看到,笔者在程序源码中插入了一句printf语句输出,然后按照下图,就可以看到程序的输出了。8 {8 e6 m+ k+ X4 e7 X4 {: X" t
4.jpg
1 Z. R/ C; c, d% |

! c3 e1 C3 R2 w$ W3. 综合版本使用scanf和printf4 s$ o* X1 \+ i  o! j4 d7 B/ n+ o
3.1 添加retarget文件, m) `: q, m& c& e# ]# j' O  k2 @
将如下代码保存成retarget.c,然后加入到工程中。3 e5 v! q# a3 x  I
4 P6 i: n+ [! s- W
% v8 b$ F, _8 l3 v0 l$ C$ v
  1. #pragma import(__use_no_semihosting_swi)  : K# Q. n- V8 O- @) T; a# s
  2.   
    + G+ X. a) U8 ^) r+ _+ q
  3. struct __FILE { int handle; /* Add whatever you need here */ };  * ^- U. |! ?( S/ \0 [# g
  4.     FILE __stdout;  4 N$ z! C5 R1 [% X5 [
  5.     FILE __stdin;  : m" |  @9 G  {
  6.       1 ?  Z. k& P, e( x
  7. int fputc(int ch, FILE *f)   
    ; L6 H  e, S+ S
  8. {  * d; ^+ O7 F) C) ]8 h
  9.     return ITM_SendChar(ch);  
    4 z/ Y1 q6 F: t. @! \5 T
  10. }  
      |4 x8 j( Y& k" u+ K2 Q7 D
  11.   
    : B( g1 E% P( \0 k8 L
  12. volatile int32_t ITM_RxBuffer;  8 u( }2 d/ u7 d5 U8 I5 j
  13. int fgetc(FILE *f)  
    4 |/ I. K, z3 H" t/ H9 h
  14. {  2 A7 l  Q6 f1 a, C$ m5 U
  15.   while (ITM_CheckChar() != 1) __NOP();  
    6 X& i4 [. B8 a( }" Z
  16.   return (ITM_ReceiveChar());  0 t' j' |/ @) I* b! b
  17. }  
    5 ]( {) |+ ~  |! a; s* e2 v( d
  18.   $ E; T  q0 J# j" x4 I1 n
  19. int ferror(FILE *f)  ' G& ~3 h! e. o- o( s6 f) t
  20. {  5 m8 Z4 |' ~* J9 @
  21.     /* Your implementation of ferror */  : v% W$ D' I% _- f
  22.     return EOF;  
    " |+ C$ `- `; h' v1 o, K
  23. }  
    1 N( y- l* v, Z. ^  g9 F
  24.   % O. j# p! N3 X. Y! |* U2 P( N. i
  25. void _ttywrch(int c)  
    5 B9 Y' ~5 t. S1 G* t  a
  26. {  + N& I2 \- |% l. I, I1 @" q
  27.     fputc(c, 0);  4 E" C8 g- [/ w: r, E* R- v- U
  28. }  9 R7 R( L% r! w
  29.   6 F5 Q4 h8 P* Y2 W* O3 j8 [4 P3 v
  30. int __backspace()  
    " n5 s& L3 ~/ N+ e9 f# o
  31. {  ) B+ j4 _4 }% H& u7 s* P3 x% ^# ^
  32.     return 0;  5 u" \5 D( ~! d9 A
  33. }  / u$ C' d6 w3 T
  34. void _sys_exit(int return_code)  & S( D+ I" ^, J+ I
  35. {  
    6 ?% w* Q+ [' f! n! x% @1 O3 ^( G; L
  36. label:  $ N: m5 G( |6 z6 w* K! k9 {/ ]3 r
  37.     goto label;  /* endless loop */  . i' f0 E& m( m: l  G
  38. }  
复制代码
" j1 Z) t. _0 ]& `6 P7 x
) V6 J& M2 ^: l( h

% X+ P5 n5 G. h  }; k6 z( j
3.2 编译运行" I5 }- x9 r- E/ _
编译,烧录,运行,打开Debug (printf) viewer,就可以看到输入,参看下图! `" E+ f; a7 b
5.jpg
3 e8 {) k5 H' p2 K+ n2 O2 X
( m6 C4 i3 C9 u# J2 A, [
这里对retarget.c文件做几点说明.
) w' {3 g" t6 ]# H) j! m$ k1). 上面的代码实际是在X:\Keil\ARM\Startup\Retarget.c上修改而成的,scanf依赖的函数共有两个,fgetc和__backspace都需要实现,如果缺少__backespace函数,则scanf胡无法从Debug Viewer Dialog 窗口获取输入。另外上面提供的代码只是个demo,用于演示效果,用于生产时应该处理的更完善一些。见参考文献[1]- \8 I$ d9 X. x9 M2 G/ F

$ o1 o7 g: N# N5 J/ p6 W2). 函数ITM_SendChar,ITM_CheckChar,ITM_ReceiveChar在库文件CMSIS\Include\core_cm3.h中。
7 h0 q$ r4 C# ~$ N; s5 l& a( c9 b) K6 H* F
3) 查看函数的符号引用关系,可以通过生成详细的map文件来查看。命令行增加 --verbose --list rtt.map选项即可生成名为rtt.map的文件。
( ?3 B- X! y  ^" A/ m0 q& F; M3 b
2 ~3 i& C! T7 K, C' C5 P4. ITM与RTT结合(待实现)
( F2 y% {- g3 x1 c: O7 Cgrissiom 写道:4 U, ~4 C9 p& @* r% ]7 J
忽然想到,或许可以把这个半主机做成 device,然后 rt_console_set_device("semi") 就可以直接用半主机做 finsh/rt_kprintf 了…… 不知可行不可行……3 I4 x' Q; z# b+ Z

0 M: m' v  P( e% T0 x3 p* ]1 |prife: ITM的接收不知道是否支持中断,目前接收字符使用是轮询方式。如果是中断才有意义。这样可以把ITM设备做成一个 rtt 的device了,让finsh跑在 Debug printf Viewer窗口上。以后只要接一个jtag/SWD口就可以调试了,不用再接串口线了
( e* Z+ u; o* L; S
4 ]/ e7 w+ D( q# q* e! \$ i2 b
赞 1 收藏 11 评论6 发布时间:2016-7-17 14:31

举报

6个回答
stary666 回答时间:2016-7-17 16:23:06
想带你骑单车ing 回答时间:2017-10-11 17:38:11
楼主厉害
epochal 回答时间:2017-10-11 19:37:52
hades2013 回答时间:2017-10-11 20:37:44
学习,,来看看。。1 ~$ |6 S4 u* Z/ b* q
枫天123 回答时间:2018-1-9 11:46:22
搞不定,全是编译错误
jorry 回答时间:2018-9-18 21:44:12
赞赞!!!!
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版