最近在MCU on Eclipse网站上看到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被应用程序使用。

有一个Semihosting(半托管),但是速度非常慢,而且取决于调试器和工具链/库,加上需要消耗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/NXP OpenSDA在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波特率:

/*!

* \brief Initialize the SWO trace port for debug message printing

* \param portBits Port bit mask to be configured

* \param cpuCoreFreqHz CPU core clock frequency 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 is expected 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 Protocol Register": Select which protocol to use for trace output (2: SWO NRZ, 1: SWO Manchester encoding) */

*((volatile unsigned *)(ITM_BASE + 0x40010)) = SWOPrescaler; /* "Async Clock Prescaler Register". Scale the baud rate of the asynchronous output */

*((volatile unsigned *)(ITM_BASE + 0x00FB0)) = 0xC5ACCE55; /* ITM Lock Access Register, C5ACCE55 enables 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 per stimulus 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()函数中完成打印:

/*!

* \brief Sends a character over the SWO channel

* \param c Character to be sent

* \param portNo SWO channel number, value in the range of 0 to 31

*/

void SWO_PrintChar(char c, uint8_t portNo) {

volatile int timeout;

/* Check if Trace Control Register (ITM->TCR at 0xE0000E80) is set */

if ((ITM->TCR&ITM_TCR_ITMENA_Msk) == 0) { /* check Trace Control Register if ITM trace is enabled*/

return; /* not enabled? */

}

/* Check if the requested channel stimulus port (ITM->TER at 0xE0000E00) is enabled */

if ((ITM->TER & (1ul<<portNo))==0) { /* check Trace Enable Register if requested port is enabled */

return; /* requested port not enabled? */

}

timeout = 5000; /* arbitrary timeout value */

while (ITM->PORT[0].u32 == 0) {

/* Wait until STIMx is ready, then send data */

timeout--;

if (timeout==0) {

return; /* not able to send */

}

}

ITM->PORT[0].u16 = 0x08 | (c<<8);

}

上面的代码使用了一个非常简单的超时机制:重要的一点是,如果SWO没有启用或者SWO端口没有准备好,那么应用程序就会被阻塞。

为了更方便地打印字符串,我使用以下函数:

/*!

* \brief Sends a string over SWO to the host

* \param s String to send

* \param portNumber Port number, 0-31, use 0 for normal debug strings

*/

void SWO_PrintString(const char *s, uint8_t portNumber) {

while (*s!='\0') {

SWO_PrintChar(*s++, portNumber);

}

}

要通过SWO发送一个“hello”,它就像这样简单:

SWO_PrintString("hello world with SWO\r\n", 0);

第一个参数是要发送的字符串,第二个是SWO跟踪通道号。

GNU ARM Eclipse查看器

要接收主机上的SWO跟踪输出,GNU ARM Eclipse插件内置了Segger J-Link探测器的SWO支持。

SWO仅支持SWD(单线调试)模式,不支持JTAG模式。所以确保SWD被选为调试协议:

SWD调试

在GNU ARM Eclipse调试配置中,启用SWO并指定CPU频率和SWO频率(请参见http://gnuarmeclipse.github.io/debug/jlink/上的有关频率的文档)。我必须提供CPU频率(在我的情况下为120 MHz),并且可以将SWO频率设置为0,以便J-Link自动确定速度)。在端口掩码中指定使用的端口(作为位掩码),因此0x1用于使用端口0:

SWO的设置

这样,在目标板上运行应用程序就会在Eclipse控制台视图中显示输出:

Eclipse控制台视图

Segger SWO Viewer

Segger有一个特殊的SWO Viewer(命令行和GUI版本)。

在GUI版本中,我指定使用的设备,它可以感测跟踪时钟:

segger gui swo viewer

在查看器中,我可以打开/关闭端口,并查看收到的数据:

segger j-link swo viewer

Telnet: Putty

但是,没有需要查看SWO数据的花哨的查看器或Eclipse。Segger默认使用端口2332:

SEGGER SWO端口

我可以配置任何telnet客户端(例如PuTTY)在端口2332上打开会话:

putty telnet会话设置

我在PuTTY中得到的输出:

SWO在PuTTY中的输出

综述

ARM SWO跟踪引脚允许向主机发送跟踪消息。一个常见的用法是向主机发送调试或其他消息。SWO只需要一个引脚,仅适用于SWD(而不是JTAG),并且在目标上需要很少的代码和资源。不幸的是,许多电路板没有将SWO跟踪引脚路由到调试头,因此如果您正在进行自己的设计,则至少应考虑将SWO路由到调试头。

虽然SWO跟踪输出很大,但是限于高端Cortex-M,我没有在Cortex-M0(+)中找到它,它只是输出,需要一个支持它的调试探针/接口。至少与Eclipse和GNU ARM Eclipse插件结合Segger J-Link探针SWO输出对我来说非常棒。

另一方面,Segger RTT的功能更加多样化,也非常快。它适用于所有ARM Cortex,最重要的是不需要额外的引脚。然而,它在目标系统上需要更多的开销和RAM资源。此外,它允许发送和接收数据。所以对于串行调试消息打印,Segger RTT对我来说听起来更好的解决方案。

接下来就是快乐SWO中了!

相关链接

  • SWO on Kinetis:https://community.nxp.com/thread/318058
  • SWO与GNU ARM Eclipse插件:http : //gnuarmeclipse.github.io/debug/jlink/
  • Segger SWO Viewer:https : //www.segger.com/j-link-swo-viewer.html
  • GNU ARM Eclipse插件:http : //gnuarmeclipse.github.io/debug/
  • Eclipse RxTx插件,用于解析SWO数据:http : //forum.segger.com/index.php? page=Thread&threadID=1010
  • ARM CoreSight概述:http : //www.arm.com/files/pdf/AT_-_Advanced_Debug_of_Cortex-M_Systems.pdf
  • GitHub上的示例代码:https://github.com/ErichStyger/mcuoneclipse/tree/master/Examples/KDS/TWR-K64F120M/TWR-K64F120M_Demo/Sources

欢迎关注:

基于ARM Cortex-M和Eclipse的SWO单总线输出的更多相关文章

  1. 《嵌入式软件设计基础——基于ARM Cortex—M3》读书笔记

    此书有点深,记录点自己能够看懂的. 1.内存管理一章:讲到变量的类型.生存周期.内存分配. auto static register 局部变量,全局变量 malloc free 内存碎片,消除内存池的 ...

  2. 灵动微电子ARM Cortex M0 MM32F0010 GPIO 的配置驱动LED灯

    灵动微电子ARM Cortex M0 MM32F0010 GPIO的配置 目录: 1.前言 2.学习方法简要说明 3.要点提示 4.注意事项 5.MM32F0010系统时钟的配置 6.MM32F001 ...

  3. 课程设计个人报告——基于ARM实验箱的捕鱼游戏的设计与实现

    课程设计个人报告--基于ARM实验箱的捕鱼游戏的设计与实现 一.个人贡献 参与课设题目讨论及部分过程 资料收集 负责代码调试 捕鱼游戏相应功能的实现 实验环境 Eclipse软件开发环境: ARM实验 ...

  4. 课程设计小组报告——基于ARM实验箱的捕鱼游戏的设计与实现

    课程设计小组报告--基于ARM实验箱的捕鱼游戏的设计与实现 一.任务简介 1.1 任务内容 捕鱼游戏这个项目是一个娱乐性的游戏开发,该游戏可以给人们带来娱乐的同时还可以给人感官上的享受,所以很受人们的 ...

  5. 20155338课程设计个人报告——基于ARM实验箱的Android交友软件的设计与实现

    课程设计个人报告--基于ARM实验箱的Android交友软件的设计与实现 个人贡献 实验环境的搭建 代码调试 在电脑上成功运行 研究程序代码撰写小组报告 一.实验环境 1.Eclipse软件开发环境: ...

  6. 基于ARM的射频识别读卡器电路设计

    http://tech.yktworld.com/201010/201010032128115666.html 来源:一卡通世界      作者:江小平,李中捷,余晓峰      2010-10-3 ...

  7. 基于ARM处理器的反汇编器软件简单设计及实现

    写在前面 2012年写的毕业设计,仅供参考 反汇编的目的 缺乏某些必要的说明资料的情况下, 想获得某些软件系统的源代码.设计思想及理念, 以便复制, 改造.移植和发展: 从源码上对软件的可靠性和安全性 ...

  8. 基于CDH5.x 下面使用eclipse 操作hive 。使用java通过jdbc连接HIVESERVICE 创建表

    基于CDH5.x 下面使用eclipse 操作hive .使用java通过jdbc连接HIVESERVICE 创建表 import java.sql.Connection; import java.s ...

  9. 基于arm开发板四个按键控制四个灯亮

    基于s5pv2410,cortex a8的四个按键每一个按键点了对应的灯 对于用汇编来编程的话不难,重点在于数据手册,电路图,管脚的看懂 直接上代码 .globl _start_start: ldr ...

随机推荐

  1. Leetcode#118. Pascal's Triangle(杨辉三角)

    题目描述 给定一个非负整数 numRows,生成杨辉三角的前 numRows 行. 在杨辉三角中,每个数是它左上方和右上方的数的和. 示例: 输入: 5 输出: [ [1], [1,1], [1,2, ...

  2. computed,methods,watch

    加载顺序: 在官方文档中,强调了computed区别于method最重要的两点 computed是属性调用,而methods是函数调用 computed带有缓存功能,而methods不是 计算属性是基 ...

  3. 【blog】SpringMVC接收数组

    页面 var idsArray = new Array(); idsArray.push(userId); SpringMVC @RequestParam(value = "ids[]&qu ...

  4. java.lang.Enum

    参考博客链接 java枚举类型的优势在哪里? Java 枚举(enum) 详解7种常见的用法

  5. Javascript - ExtJs - Toolbar - 工具栏

    Toolbar组件 创建工具栏 Toolbar类是一种子组件,它不能独立存在,需要依附在其它组件上面.很多容器组件都具备tbar(顶部工具栏).bbar(底部工具栏)的配置,所以可以像下面那样使用它. ...

  6. 2017-2018-2 20165234 实验二 《Java面向对象程序设计》实验报告

    一.实验报告封面 课程:Java程序设计  班级:1652班  姓名:刘津甫  学号:20165234 指导教师:娄嘉鹏  实验日期:2018年4月13日 实验时间:15:35 - 17:15  实验 ...

  7. CF1139A Even Substrings

    题目地址:CF1139A Even Substrings 一个数是偶数等价于其最后一位为偶数(2/4/6/8/0) 从左往右扫一遍,如果一个数是奇数则直接跳过,偶数则加上它对答案的贡献 这里的贡献应该 ...

  8. 关于Mac或Linux下GO的Permission denied提示错误

    有时候当你下载第三方库的时候,编译时会提示Permission denied 权限不足, 出现这种错误因为权限不够.其中一种办法是需要把你项目目录和go的pck.bin权限放开. chmod -R 7 ...

  9. Crash工具实战-变量解析【转】

    转自:http://blog.chinaunix.net/uid-14528823-id-4358785.html Crash工具实战-变量解析 Crash工具用于解析Vmcore文件,Vmcore文 ...

  10. linux批量替换文件内容3种方法(perl,sed,shell)

    方法1:perl   这两天在构建一个应用的使用用到了maven,由于project很大,足足有700多个 pom.xml文件,更郁闷的是在很多pom.xml文件里都单独指定了资源库的url,我需要把 ...