1 概述
: ^) s& G/ c# _6 N3 p1.1 资源概述
开发板：ST官方NUCLEO-F103RB开发板
( K! ^0 A) k3 Y6 i, Y6 C  `CUBEMX版本：1.3.0
" T2 c! O7 {6 @" D! T3 V! EMDK版本：5.23
2 e+ J1 ~9 K) ?$ W9 k4 w5 h主控芯片型号：STM32F103RBT6



1.2 SWO功能简介
5 @( g" b( ?% Q' V% U' ]: v) w8 ^SWO也叫做trace（跟踪）功能，通过此功能，只需要在SWD调试基础上增加一条SWO线缆，就可以实现类似串口输出功能，配合printf函数打印相应的信息到utility窗口中。此功能不占用串口资源，无需在中断中执行。
6 m/ j/ Z3 z' G* Q7 D7 b* {0 u+ v/ |
1.3 ITM(指令跟踪微单元)简介
, w$ e6 `" u( a4 Y+ d- U4 _: |我们此次功能实现是通过调用ITM实现的。
ITM是一应用驱动的跟踪源，它支持printf类的调试手段来跟踪操作系统(OS)和应用事件，并发布判定的系统信息。ITM以包的形式发布跟踪信息，它由以下部分组成：
% j% A9 G( F. f3 C5 o. _● 软件跟踪：软件可以通过直接写ITM激发寄存器来发布包信息。
. v% f, g* u0 R( s● 硬件跟踪：ITM会发布由DWT产生的信息包。
● 时间戳：时间戳被发布到相应的包上。ITM包含一个21位的计数器以产生时间戳。Cortex-M3的时钟或串行线观测器(Serial Wire Viewer)的位时钟率给计数器提供时钟。
由ITM发送的信息包输出到TPIU(Trace Port Interface Unit)，TPIU再添加一些额外的包(参考TPIU)，然后输出完整的包序列给调试器。1

1.4 实现功能
本次程序实现的功能如下
1、复位后，向Serial Wire Viewer（utility）打印信息；
& w9 G$ }' y5 m' J4 s5 @2、按按键BUTTON，LED2灯实现翻转；
8 a: [. e; K5 {" y. X+ W9 p; N. v% t对于第二条实现，此次文档不详细描述。
/ o: M4 _) f0 |9 J/ M* t8 L
6 Q! D  ?" `; O5 R5 q" b2 硬件连接以及CUBEMX配置
2.1 硬件连接
开发板内部已经将线接好，如下图所示
; O) H$ Z6 O: d0 U7 d! \
  W' f8 n0 W* u; t1 O/ @对于目标板与STLINK仿真器分开的情况，我们需要使用5根线进行连接，如下表所示。

& q1 U! s* G% S" f1 v$ h1 U0 S- ]
' U) b1 ?6 a5 q$ A2 F6 G
2.2 CUBEMX配置
) M4 k) ?6 `4 I9 y. |选择异步跟踪模式，此时PB3将会自动定义为SWO端口。

. O8 K. g2 p/ o+ y
" C, r1 i5 t0 z# K4 @
3 软件开发
3.1 KEIL软件设置
KEIL软件设置如下，这里由于程序使用的内部HSI，系统频率是64MHz，因此填写64MHz，需要根据实际情况进行填写。

, K; W2 O  K- v$ R

3.2 程序设计
  |5 F! A! x3 K4 O/ X% \使用CUBEMX生成代码。在主函数中进行修改。
% X0 P% s2 U% z8 v: x主程序中包含stdio.h函数的头文件，否则将不能识别printf函数。

1. #include "stdio.h"

复制代码

fputc 函数宏定义。
. r4 a' h+ p, ^& R
/ \6 C% }# V& ^- X: R* }

1. #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f)

复制代码

0 {7 b, W, P# A7 x0 A函数定义，由于printf调用的是fputc函数，通过这么一个转换，printf函数就能调用ITM函数实现输出功能。

1. PUTCHAR_PROTOTYPE
   & R# I, L; Z: f: g8 d
2. {
   9 |  o; e' \" d, v7 l7 T2 y
3.   ITM_SendChar(ch);
   
4.   return ch;
   ( {: ^0 Q- Z, Q' _! M
5. }

复制代码

TIM_Sendchar()函数在core.cm3.h头文件中有进行定义，如下所述
) j  W! I' I5 ]# x8 C0 t7 G
2 H! d+ b) {0 }* f% N

1. __STATIC_INLINE uint32_t ITM_SendChar (uint32_t ch)
   
2. {
   
3.   if (((ITM->TCR & ITM_TCR_ITMENA_Msk) != 0UL) &&      /* ITM enabled */
   
4.       ((ITM->TER & 1UL               ) != 0UL)   )     /* ITM Port #0 enabled */
   
5.   {
   
6.     while (ITM->PORT[0U].u32 == 0UL)
   
7.     {
   , h9 s2 i& ^- V0 y6 ?0 n6 [
8.       __NOP();
   . ?5 N1 K; N2 U+ H
9.     }
   
10.     ITM->PORT[0U].u8 = (uint8_t)ch;
    ; ?; G% ]% I9 b% S; ]& z; N
11.   }
    
12.   return (ch);
    
13. }

复制代码

在主函数main()中增加printf函数，实现输出。

1. printf("** Test finished successfully. ** \n\r");

复制代码

0 b0 H! J9 T5 `* l, D$ o4 实验结果与总结
1 P; J5 a, j* j9 L& H, ]3 _1 W! t/ [4.1 实验结果
打开utility软件，点击printf via SWO viewer。



- Y! n, _: Y$ E5 ?8 |5 O6 _设置频率，点击Start，将调试板复位（程序设置只运行一次printf,因此每输出一次均需要重新复位），即可发现SWV窗口输出了相应的信息。
: W0 b  v/ q* l8 A/ R3 l0 J# ^
6 N6 l" L! P8 f! f

4.2 总结
在传统的调试中，我们可能偏向于断点分析或者LED灯的亮灭来判定程序运行状态，但是都不是太直观，对于程序越大越不好操作。使用这个SWO功能能很大程序解决这个问题。我们可以在各种错误处理函数增加相应的提示信息，协助我们进行软件开发工作。
1 n0 Q6 f/ x% J( h8 |
9 s5 D' ?# s9 f! R: Q9 G" F1 X