`
最近在MCU onEclipse网站上看到Erich Styger所写的一篇有关通过SWD的跟踪接口SWO获取ARM Cortex-M相关信息的文章,文章结构明晰,讲解透彻,本人深受启发,特意将其翻译过来供各位同仁参考。当然限于个人水平,有不当之处恳请指正。原文网址:https://mcuoneclipse.com/2016/10/17/tutorial-using-single-wire-output-swo-with-arm-cortex-m-and-eclipse/
作为一个标准过程,我将一些控制台功能添加到我的嵌入式应用程序中。这样我就有了一个命令行接口,可以检查和修改目标系统。ARM Cortex-M的一个有趣的硬件特性是单线输出(SWO) ,它允许通过一根线路将数据(例如字符串)发送到32个不同的激励端口。
ARM调试器接头上的SWO引脚
调试跟踪输出?SWO!
我使用普通的UART/SCI作为标准的文本和命令行与目标板的接口。然而,在许多板上,UART被应用程序使用。
有一个Semihos
ting(半托管),但是速度非常慢,而且取决于调试器和工具链/库,加上需要消耗FLASH和RAM,所以我不建议在任何情况下使用Semihosting。
【注】Semihosting是针对ARM目标机的一种机制,它能够根据应用程序代码的输入/输出请求,与运行有调试功能的主机通讯。这种技术允许主机为通常没有输入和输出功能的目标硬件提供主机资源。
也有一个USB CDC,但这需要一个USB接口,一个USB栈和一个具有USB功能的微控制器。不适用于所有情况。
还有一个Segger RTT,它很小,速度快,最好的是不需要任何特殊的引脚。但只能工作于Segger的调试探测器。
ARM SWO
但还有另一件事:ARM SWO跟踪端口是由ARM为Cortexm-M定义的。从技术上讲,SWO是一个单一的跟踪引脚,它被用来以从CPU核心时钟中提取一个特定的时钟频率发送数据包。您可以将SWO看作是一种使用特殊格式发送数据包的UART TX引脚。可以使用多达32种包类型(或激励)。发送什么样的数据取决于应用程序,并且只需要很少的CPU处理或代码。
常见SWO用法是:
Ø 按字符串发送调试信息
Ø 记录中断的进入与退出
Ø 记录函数的进入与退出
Ø 周期性的PC值采样
Ø 事件提示
Ø 变量或内存单元修改超时
最常见的用法之一就是第一种:使用SWO以UART样式打印来自目标的调试消息。并且这也正是我再这篇文章中将要表达的。还有另一种编码(曼彻斯特编码),这里不做介绍。
ARM CoreSight
SWO是ARM CoreSight调试功能块的一部分,而ARM CoreSight则通常是Cortex-M3,M4,M7的一部分:
CoreSight功能块(来自:http://www.arm.com/files/pdf/AT_-_Advanced_Debug_of_Cortex-M_Systems.pdf)
如上图所示,通过SWO(或SWV)ITM和DWT跟踪消息可以发送。对于指令跟踪需要4个额外的跟踪引脚
SWO引脚
使用SWO的前提条件是这个引脚可以在调试头中使用。这是我的TWR-K64F120M板的情况:
trace swo引脚(来自:TWR-K64F120M原理图)
如上图所示,SWO跟踪引脚是与JTAG TDO引脚共享的。所以这就意味着SWO不能在JTAG中使用,而只能在SWD中使用。
所以仔细检查你板子的原理图确定他是否支持SWO。例如FRDM-K64F(是TWR-K64F120M上一个版本),它的SWO是没有被引到调试头的:
FRDM-K64F上没有SWO
调试探针与SWO
为了能够使用SWO,我需要一个能够读取SWO引脚的调试探测器。例如,Freescale/NXPOpenSDA在Freedom和Tower模块板载调试接口硬件就不支持SWO。
然而,外部的Segger J-Link却支持SWO引脚。下面我有一个J-Link EDU连接到TWR-K64F120M板的调试和跟踪端口:
j-link edu连接到跟踪端口
通过SWO引脚发送调试信息的源码
为了通过SWO写调试消息到主机,需要一小段代码。在Github上有一个可用的完整代码的例子项目:
https://github.com/ErichStyger/mcuoneclipse/tree/master/Examples/KDS/TWR-K64F120M/TWR-K64F120M_Demo/Sources
外部工具(比如Segger RTT查看器)可以在硬件中设置SWO。我的建议是从应用程序初始化它。因为SWO跟踪输出时钟是从CPU时钟派生而来的,所以初始化函数需要这个时钟加上SWO端口号来初始化。下面是我用来初始化SWO输出的代码,默认为64k波特率:
/*!
* rief Initialize the SWO traceport for debug message printing
* param portBits Port bit mask tobe configured
* param cpuCoreFreqHz CPU core clockfrequency in Hz
*/
void SWO_Init(uint32_t portBits,uint32_t cpuCoreFreqHz) {
uint32_t SWOSpeed = 64000;/* default 64k baud rate */
uint32_t SWOPrescaler =(cpuCoreFreqHz / SWOSpeed) - 1; /* SWOSpeed in Hz, note that cpuCoreFreqHz isexpected to be match the CPU core clock */
CoreDebug->DEMCR =CoreDebug_DEMCR_TRCENA_Msk; /* enable trace in core debug */
*((volatile unsigned*)(ITM_BASE + 0x400F0)) = 0x00000002; /* "Selected PIN ProtocolRegister": Select which protocol to use for trace output (2: SWO NRZ, 1:SWO Manchester encoding) */
*((volatile unsigned*)(ITM_BASE + 0x40010)) = SWOPrescaler; /* "Async Clock PrescalerRegister". Scale the baud rate of the asynchronous output */
*((volatile unsigned*)(ITM_BASE + 0x00FB0)) = 0xC5ACCE55; /* ITM Lock Access Register, C5ACCE55enables more write access to Control Register 0xE00 :: 0xFFC */
ITM->TCR =ITM_TCR_TraceBusID_Msk | ITM_TCR_SWOENA_Msk | ITM_TCR_SYNCENA_Msk |ITM_TCR_ITMENA_Msk; /* ITM Trace Control Register */
ITM->TPR = ITM_TPR_PRIVMASK_Msk;/* ITM Trace Privilege Register */
ITM->TER = portBits; /*ITM Trace Enable Register. Enabled tracing on stimulus ports. One bit perstimulus port. */
*((volatile unsigned*)(ITM_BASE + 0x01000)) = 0x400003FE; /* DWT_CTRL */
*((volatile unsigned*)(ITM_BASE + 0x40304)) = 0x00000100; /* Formatter and Flush Control Register*/
}
在我的主应用程序中,我像这样初始化它(对于一个有24MHz核心时钟的系统):
#define CPU_CORE_FREQUENCY_HZ 120000000/* CPU core frequency in Hz */
SWO_Init(0x1,CPU_CORE_FREQUENCY_HZ);
在SWO_PrintChar()函数中完成打印:
/*!
* rief Sends a character overthe SWO channel
* param c Character to be sent
* param portNo SWO channelnumber, value in the range of 0 to 31
*/
void SWO_PrintChar(char c, uint8_t portNo) {
volatile int timeout;
/* Check if Trace ControlRegister (ITM->TCR at 0xE0000E80) is set */
if ((ITM->TCR&ITM_TCR_ITMENA_Msk) == 0){ /* check Trace Control Register if ITM trace is enabled*/
return; /* notenabled? */
}
/* Check if the requestedchannel stimulus port (ITM->TER at 0xE0000E00) is enabled */
return; /*requested port not enabled? */
}
timeout = 5000; /* arbitrarytimeout value */
while (ITM->PORT[0].u32 == 0) {
/* Wait untilSTIMx is ready, then send data */
timeout--;
if (timeout==0) {
return;/* not able to send */
}
}
ITM->PORT[0].u16 = 0x08 |(c<<8);
}
上面的代码使用了一个非常简单的超时机制:重要的一点是,如果SWO没有启用或者SWO端口没有准备好,那么应用程序就会被阻塞。
为了更方便地打印字符串,我使用以下函数:
/*!
* riefSends a string over SWO to the host
* param sString to send
* paramportNumber Port number, 0-31, use 0 for normal debug strings
*/
void SWO_PrintString(const char *s, uint8_tportNumber) {
while(*s!='