尧图网站建设 
简介本资源是一份面向嵌入式开发者与STM32进阶学习者的完整DAPLINK移植工程聚焦于在STM32F103RCT6ARM Cortex-M3上实现USB调试接口功能并集成Keil5环境下的J-Link RTT实时日志打印能力显著提升固件调试效率。资源包共819个文件含473个C源码涵盖HAL驱动、USB协议栈、Flash编程等核心模块、313个头文件定义外设寄存器、RTT接口及DAPLINK协议结构、10个汇编启动文件以及Keil工程配置uvprojx/uvoptx、调试脚本bat、二进制固件bin等关键文件总大小2.78MB目录结构清晰模块划分明确便于理解DAPLINK底层通信机制与RTT集成逻辑。已有2302人学习下载读者可直接导入Keil5编译烧录快速获得具备SWD调试、虚拟串口及RTT Viewer实时输出能力的自定义DAPLINK固件同时掌握中断处理、内存布局优化与多调试工具协同等实战要点。 手头正好有一块STM32F103RCT6核心板主控是Cortex-M372MHz主频256KB Flash、48KB SRAM一直放在抽屉里吃灰。最近调一个新项目需要用DAPLink做下载调试又想在目标板上用RTT Viewer打日志看实时数据。手边没有J-Link也不想为这点事再花几百块干脆把这块F103RCT6刷成DAPLink再配合SEGGER的RTT Viewer做打印Keil5工程一套流程全跑下来。这篇文章就把移植DAPLink、搭建Keil5工程、接入J-Link RTT Viewer的完整过程和踩坑记录写下来。这个组合对经常做嵌入式开发又想省成本的工程师来说非常实用DAPLink是ARM官方开源的CMSIS-DAP调试器方案本身就能当下载器和虚拟串口用而RTT Viewer虽然是SEGGER家的软件但新版已经能识别CMSIS-DAP调试器也就是说没有J-Link硬件也能用RTT打印。适合手头有F103开发板、想低成本搭一套调试下载RTT日志方案的开发者参考。1. 项目拆解DAPLink 与 RTT 到底是两件什么事1.1 DAPLink 在 F103 上能干哪些活DAPLink是ARM mbed团队维护的开源项目核心是CMSIS-DAP协议。固件跑在MCU上让MCU扮演一个调试器的角色通过SWD接口去操作目标芯片。它最常见的几种工作模式在线调试与下载这跟ST-Link、J-Link做的事情一样Keil/IAR等IDE都能识别为CMSIS-DAP Debugger。虚拟串口把调试器上的UART转发成USB CDC串口目标板日志直接通过这路虚拟端口输出到电脑省掉一个USB转串口模块。拖拽烧录配合bootloader把目标固件的bin文件拖进U盘盘符就能自动烧录这个功能需要烧录bootloader配合后面会单独说。磁盘管理以U盘形式暴露一个盘符用于拖拽烧录和配置文件管理。从MCU选型角度看STM32F103RCT6做DAPLink完全够用甚至有点浪费。DAPLink固件很小几十KB的Flash就能装下RCT6的256KB Flash和48KB SRAM绰绰有余。RCT6比C8T6多出来的引脚和内存刚好可以在DAPLink基础上再扩展几个功能比如多几个状态灯、独立按键、甚至给虚拟串口加一个USB转串口缓冲。不过只做标准DAPLink的话C8T6也够RCT6主要适合手头正好有这个芯片或者想留点余量的人。1.2 RTT Viewer 为什么能接在 DAPLink 后面Segger RTT的官方定位是配合J-Link调试器使用的实时日志工具原理其实不复杂目标芯片的RAM里维护一个环形缓冲区调试器通过SWD口不断读写这块内存上位机RTT Viewer负责把读到的内容显示出来同时也能向下发数据。它有几个传统串口比不了的优势不占额外引脚不用接一根UART线只要调试器和目标芯片之间的SWD两根线不断日志通道就在。速度快RTT走内存访问刷新率远高于串口适合高频日志输出。支持双向通信可以向目标芯片发送命令或者输入参数。为什么RTT Viewer能用DAPLink因为RTT的完整数据链路是上位机软件 ---(USB)--- 调试器 ---(SWD)--- 目标芯片RAM。中间那层只负责把USB请求翻译成SWD读写操作这正好是CMSIS-DAP协议的标准能力。SEGGER从较新版本的J-Link软件包开始给RTT Viewer加入了连接CMSIS-DAP调试器的选项所以只要你电脑上装了新版的J-Link软件里面自带的RTT Viewer就能直接选DAPLink。这是整条链路里最巧妙的一点硬件是ARM开源方案软件是SEGGER生态两者通过标准SWD协议打通了。1.3 这套组合适合谁用、不适合谁用适合的场景很明确学生党、电子爱好者、手头只有F103开发板但想体验RTT日志的人还有那些不希望为每个调试台都配一个J-Link的团队。用RCT6刷成DAPLink相当于几十块钱买了一个功能非常接近正统DAPLink的调试器还顺带获得RTT Viewer的使用权。不适合的场景也有如果你需要极致的下载速度或者要调试多核芯片、要跟踪Trace功能那还是老老实实上J-Link Plus级别以上的工具。DAPLink终究是CMSIS-DAP的定位SWD速度比不过J-Link的高端型号RTT在高频大数据场景下也可能面临带宽瓶颈。另外如果你想做产品量产下载工具DAPLink的批量烧录稳定性也值得反复测试不宜直接就用社区固件跑产线。2. 硬件盘点与引脚设计RCT6 相比 C8T6 的优势和要改的地方2.1 核心资源够不够用STM32F103RCT6资源如下资源参数对DAPLink的意义内核Cortex-M3 72MHz处理SWD协议运算余量充足Flash256KB是C8T6的4倍固件随便装SRAM48KB缓存USB端点、SWD命令队列、RTT控制块都够USBUSB 2.0 FS DeviceDAPLink与电脑通信的主通道USART2物理串口虚拟串口的后端通道SWDIO/SWCLKPA13/PA14对外连接目标芯片的调试口DAPLink固件本身在F103上运行它自身被调试时用同一个SWD引脚但一旦固件跑起来PA13/PA14的角色会切换为“输出到目标芯片的信号线”。这个转换逻辑是在固件里实现的所以不用担心引脚冲突但烧录之前要想清楚你在用ST-Link给F103烧DAPLink固件的时候占用的就是PA13/PA14烧完之后ST-Link拔掉PA13/PA14才交给DAPLink固件使用去连接外部目标芯片。2.2 USB、SWD、UART、LED 引脚分配不同DAPLink工程引脚定义略有差异我这里基于常见的F103DAPLink移植工程说明功能引脚备注USB D-PA11必须连接USB座D-USB DPA12必须连接USB座DSWDIOPA13固件内置上拉对目标芯片输出SWCLKPA14对目标芯片输出时钟UART TXPA2虚拟串口发送端USART2_TXUART RXPA3虚拟串口接收端USART2_RXLED连接状态PB0连接上目标芯片后点亮/闪烁LED运行状态PB1固件运行后常亮或呼吸闪烁如果你的板子Pin映射不同修改IOConfig.h重启编译即可。RCT6是LQFP64封装的缘故PB0/PB1这种IO在C8T6上也有但RCT6提供了更多PB和PD口你可以把LED换到更顺手的引脚。关键是USB的PA11/PA12和SWD的PA13/PA14是固定的因为USB外设和调试口的物理映射就这两路没法改。2.3 晶振和供电布局不能省F103的USB模块必须工作在48MHz。它从PLL输出里分频得到48MHz所以PLL链路必须配置正确。如果你的板子用的8MHz晶振那么最常见的配置是HSE8MHzPLL倍频9倍SYSCLK72MHz然后USB预分频1.5分频得到48MHz。这也是绝大多数F103核心板默认的配置。如果板子用了其他频率的晶振比如16MHz或者25MHz改动起来就会麻烦很多要么换晶振要么改固件里的RCC配置代码否则USB枚举很容易失败。供电方面DAPLink从USB取5V后经过板载LDO转3.3V给MCU。USB枚举瞬间电流会有一个尖峰3.3V滤波电容别太小至少要有两个10uF和几个100nF的组合。否则可能出现一种很奇怪的现象刚插USB时能被识别拔插一下又失联最后发现是3.3V电压跌落导致DAPLink复位重启了。2.4 如果从 C8T6 工程改到 RCT6硬件上要动哪些很多现成的DAPLink工程是基于STM32F103C8T6的从C8T6改到RCT6硬件上就几个点封装从LQFP48变成LQFP64引脚变多原理图里其他IO可以按需接出来与DAPLink核心功能无关的引脚留空即可。启动文件从startup_stm32f10x_md.s换成startup_stm32f10x_hd.s因为RCT6属于高密度器件。分散加载文件或链接脚本里Flash/RAM大小从64KB/20KB改成256KB/48KB。如果原工程是针对C8T6的最小板LED引脚可能接在PC13等位置改板型时注意新板的LED实际连接。RCT6的外设和C8T6基本一致USB、USART2、SWD这些没有差异所以固件层的移植工作量不大主要就是启动文件和内存配置不能搞错。3. 固件移植从源码到 Keil5 可编译工程3.1 源码怎么选官方仓库还是社区工程DAPLink官方仓库ARMmbed/DAPLink功能最全但构建系统用的是Yotta和CMake默认目标是GCC工具链直接塞进Keil5会比较痛苦。所以最优解是找社区里的Keil5移植工程比如GitHub上搜索STM32F103 DAPLink Keil有几个成熟项目是基于F103C8的直接拿来改RCT6工程即可。我自己的做法是拉一个基于F103C8的Keil5工程作为模板然后针对RCT6调整启动文件、宏定义和分散加载文件。好处是省掉整个构建系统的折腾坏处是社区代码风格参差不齐需要自己看代码彻底理解引脚配置和宏开关。如果你选择官方仓库需要先把构建工具链跑通编出F103C8的hex然后才能改目标配置。这个过程相对复杂适合想深入学习DAPLink架构的人。纯应用层面直接用社区Keil工程能省大量时间。3.2 Keil5 工程改造的核心宏、启动文件、分散加载文件工程改造重点在三处第一Device选择。在Keil5的Options for Target - Device里芯片型号选择STM32F103RC这样RVCT会根据芯片型号自动选择合适的启动文件和内存布局但工程内原有的启动文件还是检查一下确保是startup_stm32f10x_hd.s或startup_stm32f103xe.s。第二宏定义。Keil的C/C选项卡里不同类型的DAPLink固件需要不同的宏组合。常见宏有DAPLINK_APP DAPLINK_IF TARGET_STM32F103C8 NO_SECT注意工程模板里可能写着TARGET_STM32F103C8虽然是C8T6的板型定义但如果你硬件上只是封装不同核心外设一样可以先保留这个宏。如果固件里用宏来控制Flash大小、引脚映射就需要把宏改成RCT6对应的版本。建议仔细看IOConfig.h和FlashOS相关的条件编译。第三分散加载文件。Keil工程里的sct文件如果写死了64KB Flash必须改成256KB。例如LR_IROM1 0x08000000 0x00040000 { ER_IROM1 0x08000000 0x00040000 { *.o (RESET, First) *(InRoot$$Sections) .ANY (RO) } RW_IRAM1 0x20000000 0x0000C000 { .ANY (RW ZI) } }Flash长度是0x40000256KBRAM是0xC00048KB。如果sct文件不改编译可能通过但运行起来会因为访问越界导致各种诡异错误而且USB枚举失败很难排查。3.3 编译通过不等于好使USB 时钟与 DFU/拖拽的区别第一次编译通过烧进去之后USB不一定能立刻枚举。很多人卡在“进Keil能编译但插电脑没反应”这一步原因大概率是时钟配置不对。刚才说过USB必须48MHz这个48MHz不是MCU自动选的而是固件里RCC初始化代码设定的。如果你拿到的工程原来基于C8T6的8MHz晶振那么RCT6板子如果也是8MHz晶振这一步就没什么问题。但如果板子晶振换了频率就要改SystemInit或board init里的时钟树配置。另外一个概念要提前搞清楚DAPLink固件分APP固件和bootloader引导层。如果你只烧APP固件那么它就是一个纯CMSIS-DAP调试器没有拖拽U盘功能。如果需要U盘拖拽烧录需要先烧bootloader再通过bootloader把APP固件的bin文件烧进去。为了省事我建议第一版只烧APP固件先把调试器功能跑通以后再决定要不要折腾拖拽功能。两种固件的编译目标是分开的烧错了会出怪问题。3.4 烧录引导用 ST-Link 把固件灌进去把编译好的hex烧到RCT6上最可靠的方式是用另一块ST-Link/J-Link通过SWD接口连接PA13/PA14。接线很简单ST-Link SWDIO - F103的PA13ST-Link SWCLK - F103的PA14ST-Link GND - F103的GND如果ST-Link和目标板电压不匹配最好共地然后板子自己供电Keil里Debugger选ST-LinkTarget芯片选STM32F103RC点下载几秒钟就烧完。烧完之后ST-Link直接拔掉不要再占用PA13/PA14因为DAPLink固件接下来要在这两条线上对外输出SWD。还有一种方式是用串口ISP把BOOT0拉高、BOOT1拉低通过串口下载hex到F103。这种方法适合没有ST-Link的人但需要每次烧录都改跳帽麻烦不少而且有的RCT6板子串口ISP的Bootloader版本比较老不认新hex所以不推荐。3.5 首次上电验证枚举成 CMSIS-DAP烧完固件插上USB线正常情况电脑设备管理器里会出现一个HID-compliant vendor-defined device或CMSIS-DAP兼容设备。Windows 10/11通常自动装好驱动。如果出现未知设备或黄色感叹号那就进入排查流程。为了确认DAPLink和电脑通信正常可以在Keil的Options for Target - Debug里把调试器从ST-Link改成CMSIS-DAP然后点Settings如果能识别到SW Device说明DAPLink固件和SWD接口都正常。这一步也相当于验证了你能不能用这个DAPLink给目标板下载程序。如果设备管理器里根本没有新设备大概率是USB总线或时钟问题后面第五部分我会详细讲排查思路。4. RTT Viewer 接入与数据验证4.1 目标端铺 RTT把 SEGGER_RTT 代码加进自己的 Keil 工程RTT要分两部分看一端是目标MCU里的RTT代码一端是PC上位机RTT Viewer。目标端的RTT库是SEGGER提供的不需要额外硬件就几个源文件。获取途径很简单安装J-Link软件后在安装目录下找Samples/RTT文件夹里面有SEGGER_RTT.c、SEGGER_RTT.h、SEGGER_RTT_Conf.h、SEGGER_RTT_printf.c这些文件。拷贝到自己工程的RTT文件夹里在Keil里添加源文件、添加头文件路径然后编译。也可以在SEGGER官网单独下载RTT源码包效果一样。在main函数里加初始化调用#include SEGGER_RTT.h int main(void) { SEGGER_RTT_Init(); // 其他初始化代码 while (1) { SEGGER_RTT_WriteString(0, Hello from F103RCT6\r\n); static uint32_t counter 0; SEGGER_RTT_printf(0, counter%u\r\n, (unsigned int)counter); Delay_Ms(100); } }SEGGER_RTT_WriteString是字符串直出参数0表示通道0这个通道是向上位机发数据的默认通道。SEGGER_RTT_printf支持格式化输出但要注意它不支持浮点数打印float要用整数拆分或者sprintf再输出。这也是我在工程里常见的抱怨点但实际调试够用。还要注意一点SEGGER_RTT.c本身要被正确加入编译并且不要把它放到会被优化掉的编译单元里。Keil的C/C编译优化级别可以保持默认但有特殊情况下需要把SEGGER_RTT相关文件作为不优化或低优化。这个问题后面踩坑再细说。4.2 上位机选调试器让 RTT Viewer 认识 DAPLink把新版的J-Link软件包装上里面自带J-Link RTT Viewer。打开后第一屏会让你选择连接方式Connection to J-Link选USB。“...”按钮打开调试器选择对话框这里不再只显示J-Link也会有CMSIS-DAP兼容的设备选择你的DAPLink。Target Device选目标芯片型号比如STM32F103RC或者直接选Cortex-M3。Interface选SWD。Speed可以先选1MHz稳定后再尝试更高速度。这个对话框很关键。如果你用的J-Link软件版本太老可能看不到CMSIS-DAP选项那是因为它还不支持非J-Link调试器。解决方案就是升级J-Link软件到较新版本比如V7.x下载地址就是SEGGER官网。连接成功后RTT Viewer会去目标芯片的RAM里搜索SEGGER RTT控制块。这个控制块在目标芯片里的数据结构包含了缓冲区地址和读写位置。通常自动搜索就能找到然后你会看到输出终端的空白窗口。如果目标工程正在运行且调用了SEGGER_RTT_WriteString终端里就会滚动显示日志。4.3 参数调优SWD 速度、控制块搜索、缓冲区大小DAPLink的SWD物理速度比J-Link低不少RTT Viewer在高频率输出日志时会有限制。我实测下来DAPLink下SWD速度设在1MHz比较稳4MHz以上容易出错。不是说不能设更高而是F103的DAPLink固件USB枚举和SWD状态机吞吐能力有限过高速度会导致RTT读内存失败。如果RTT Viewer提示找不到控制块可以先检查目标程序里有没有调用SEGGER_RTT_Init以及SEGGER_RTT_CB这个控制块地址是不是被链接器放到了一个搜索范围外。RTT Viewer默认搜索RAM区域一般会自动发现。实在找不到可以在RTT Viewer的设置里手动指定搜索范围如果已知控制块地址直接填进去。一个土办法在目标程序里通过串口打印一下(unsigned int)SEGGER_RTT_CB这个全局变量的地址然后手填给RTT Viewer基本必连上。缓冲区大小在SEGGER_RTT_Conf.h里调整#define BUFFER_SIZE_UP (1024) #define BUFFER_SIZE_DOWN (16)这表示上传缓冲区目标到PC默认1024字节下载缓冲区PC到目标16字节。如果日志量大而PC端没来得及读缓冲区满了之后新的日志会覆盖旧日志默认是丢弃还是覆盖取决于方向设置。增大上传缓冲区能缓解但会占用更多RAM。F103RCT6有48KB RAM给RTT开8KB缓冲完全无压力。对于C8T6那种20KB RAM的芯片就得精打细算一些。5. 我实测中踩过的坑和排查思路5.1 枚举失败先看线再看电源最后看时钟插上USB设备管理器没反应的排查顺序很重要我按这个顺序一次一次定位问题第一换线。很多USB线只有充电能力没有数据线芯这种线插上去完全不会触发设备枚举。我一开始就栽在这里换了一根带数据传输功能的线才识别到。第二供电。如果F103板子上的3.3V电压不够稳MCU可能反复重启USB枚举就无法完成。用万用表量一下LDO输出低于3.2V就先修硬件。第三时钟。用示波器看HSE晶振引脚是否有8MHz振荡没有振荡看晶振电容是否匹配、晶振是否焊接好。如果固件配置了8MHz晶振而板子上实际焊接的是16MHz晶振USB枚举就是起不来。还有一个不容易注意的点F103的USB D需要内部上拉这个上拉由USB_DP引脚控制固件里在USB初始化时会打开。如果固件压根没跑起来D不会被拉高电脑就不知道有设备插入。所以如果灯不亮、程序没启动先不管USB的事先查MCU有没有正常运行。5.2 RTT 连上了但没输出先找控制块RTT Viewer能成功连接目标芯片说明SWD通道没问题但终端里一片空白。这时按顺序排查确认目标程序编译时是否真的包含了SEGGER_RTT.c有时候只把头文件路径加进去了但源文件漏加编译照样过因为头文件里声明了接口但链接时没有实现会报错。如果没报错那就是SEGGER_RTT.c被编译器条件编译屏蔽了更常见的坑是RTT控制块的地址没被正确搜索。自动搜索默认在目标RAM区域扫描特征字符串如果目标程序用了很高的优化等级或者编译器把SEGGER_RTT_CB放在了某个对齐边界上自动搜索可能失败。手动指定RAM起始地址比如0x20000000让RTT Viewer在更大范围搜索通常能解决。还有一种情况是调用了SEGGER_RTT_WriteString但没调用SEGGER_RTT_Init。虽然RTT_Init不是绝对必须但建议在main最前面调用不然某些版本里控制块状态不对。5.3 打印太快丢数据缓冲区与速度怎么平衡RTT在DAPLink下出现日志丢失原因通常是SWD读取速度低于数据生成速度。加大BUFFER_SIZE_UP可以短暂缓解但治标不治本。真正问题在于DAPLink物理层SWD速度上限。建议降到1MHz以下读取更可靠。目标程序里初始化RTT后如果每个循环都大量打印数据量远超SWD带宽。这时需要降低日志频率或者把高频日志暂时别打只保留关键状态。这个瓶颈在J-Link上不那么明显因为J-Link读内存快得多。DAPLink毕竟走CMSIS-DAP通用协议速度上不去很正常。你能做的就是让目标端打印策略更克制比如用level开关控制日志输出或者把周期性日志合并。5.4 高优化等级下 RTT 失效的两种表现Keil的AC6编译器在高优化等级下经常出现RTT输出错乱或者完全没输出。踩过两次坑第一次是整个工程用-O3优化RTT控制块某些字段被编译器优化掉RTT Viewer能连接但读到的缓冲区地址无效。解决方式是把SEGGER_RTT.c单独设置成-O0优化在Keil工程里选中该文件右键Options把Optimization改成Level 0。第二种表现是RTT输出有字符串但内容跳变或者重复。这通常是缓冲区读写的内存顺序问题编译器重排了读写指令顺序。RTT库在SEGGER_RTT_Conf.h里定义了内存屏障相关宏检查字节序和原子操作的配置。正常情况下按官方默认配置就行但如果你改过宏要注意别把无关优化搞进去。5.5 别忽略驱动和软件的版本坑RTT Viewer能识别DAPLink依赖J-Link软件版本前面提过。一个典型坑电脑上装了老版本的J-Link驱动RTT Viewer打开后只能看见J-Link设备完全没有CMSIS-DAP选项。这种情况卸载旧版本装新版即可。另外如果你电脑上同时装了多个版本的J-Link软件或者之前装过DAPLink驱动再插别的调试器可能出现设备管理器里面设备描述符错乱。稳妥的办法是插上DAPLink之后在设备管理器里手动更新驱动让Windows重新匹配CMSIS-DAP类设备。如果还不行把“通用串行总线设备”下的未知设备删掉重新插拔一次。6. 这套方案还能怎么延伸6.1 同时保留虚拟串口和 RTT 双通道DAPLink自带虚拟串口功能目标端的日志如果走USART2PA2/PA3会在电脑上映射成一个COM口。RTT则走SWD通道两者互不干扰。这样可以做一套双通道日志方案低频的启动信息、错误码通过虚拟串口输出高频的实时数据通过RTT输出。这个场景下RCT6的48KB SRAM优势就体现出来了UART和RTT缓冲区都能开大一点。6.2 在 DAPLink 上叠加拖拽烧录功能如果你编译的是bootloaderAPP的完整DAPLink固件插入电脑后会出现一个U盘盘符。把目标固件的bin文件拖进盘里DAPLink会把它写到挂接的目标芯片上。这个功能对快速给目标板换固件很方便。需要注意F103老版本拖拽速度普遍偏慢大文件烧录时要耐心等别中途拔线。6.3 把 DAPLink 变成离线量产工具基于DAPLink可以自己写一个烧录脚本用命令行或者Python调用CMSIS-DAP的DLL实现批量下载。加上RCT6的引脚资源比较充裕你可以做一个小工装板把SWD输出、供电检测、指示灯都做好然后逐台测试目标板。这套方案成本极低适合小批量生产或者售后维修场景。我个人的做法是把DAPLink固件烧进最小的F103RCT6核心板板载的LED改成一个“下载完成”提示灯然后接一个SWD排线出来配合RTT Viewer显示目标板的运行日志。刚开始几天我甚至把它当成J-Link的平替在用Keil里编译下载、断点调试、RTT日志都正常大部分场景下体验已经非常接近正版调试器了。最后再分享一个实际操作中的小技巧把DAPLink固件源码里对目标芯片复位引脚的控制加上。很多DAPLink工程默认不控制目标板的nRST引脚但连接目标板时如果目标芯片休眠或者跑飞了SWD可能连不上。这时如果DAPLink有硬件复位控制线可以在Keil设置里勾选Reset and Run一键把目标板拉复位再下载成功率会高很多。给DAPLink预留一个复位输出引脚几乎不增加成本但能在调一些难缠的低功耗场景时救你一把。本文还有配套的精品资源点击获取 STM32F103刷DAPLink并接入RTT Viewer的低成本调试方案
简介本资源是一份面向嵌入式开发者与STM32进阶学习者的完整DAPLINK移植工程聚焦于在STM32F103RCT6ARM Cortex-M3上实现USB调试接口功能并集成Keil5环境下的J-Link RTT实时日志打印能力显著提升固件调试效率。资源包共819个文件含473个C源码涵盖HAL驱动、USB协议栈、Flash编程等核心模块、313个头文件定义外设寄存器、RTT接口及DAPLINK协议结构、10个汇编启动文件以及Keil工程配置uvprojx/uvoptx、调试脚本bat、二进制固件bin等关键文件总大小2.78MB目录结构清晰模块划分明确便于理解DAPLINK底层通信机制与RTT集成逻辑。已有2302人学习下载读者可直接导入Keil5编译烧录快速获得具备SWD调试、虚拟串口及RTT Viewer实时输出能力的自定义DAPLINK固件同时掌握中断处理、内存布局优化与多调试工具协同等实战要点。 手头正好有一块STM32F103RCT6核心板主控是Cortex-M372MHz主频256KB Flash、48KB SRAM一直放在抽屉里吃灰。最近调一个新项目需要用DAPLink做下载调试又想在目标板上用RTT Viewer打日志看实时数据。手边没有J-Link也不想为这点事再花几百块干脆把这块F103RCT6刷成DAPLink再配合SEGGER的RTT Viewer做打印Keil5工程一套流程全跑下来。这篇文章就把移植DAPLink、搭建Keil5工程、接入J-Link RTT Viewer的完整过程和踩坑记录写下来。这个组合对经常做嵌入式开发又想省成本的工程师来说非常实用DAPLink是ARM官方开源的CMSIS-DAP调试器方案本身就能当下载器和虚拟串口用而RTT Viewer虽然是SEGGER家的软件但新版已经能识别CMSIS-DAP调试器也就是说没有J-Link硬件也能用RTT打印。适合手头有F103开发板、想低成本搭一套调试下载RTT日志方案的开发者参考。1. 项目拆解DAPLink 与 RTT 到底是两件什么事1.1 DAPLink 在 F103 上能干哪些活DAPLink是ARM mbed团队维护的开源项目核心是CMSIS-DAP协议。固件跑在MCU上让MCU扮演一个调试器的角色通过SWD接口去操作目标芯片。它最常见的几种工作模式在线调试与下载这跟ST-Link、J-Link做的事情一样Keil/IAR等IDE都能识别为CMSIS-DAP Debugger。虚拟串口把调试器上的UART转发成USB CDC串口目标板日志直接通过这路虚拟端口输出到电脑省掉一个USB转串口模块。拖拽烧录配合bootloader把目标固件的bin文件拖进U盘盘符就能自动烧录这个功能需要烧录bootloader配合后面会单独说。磁盘管理以U盘形式暴露一个盘符用于拖拽烧录和配置文件管理。从MCU选型角度看STM32F103RCT6做DAPLink完全够用甚至有点浪费。DAPLink固件很小几十KB的Flash就能装下RCT6的256KB Flash和48KB SRAM绰绰有余。RCT6比C8T6多出来的引脚和内存刚好可以在DAPLink基础上再扩展几个功能比如多几个状态灯、独立按键、甚至给虚拟串口加一个USB转串口缓冲。不过只做标准DAPLink的话C8T6也够RCT6主要适合手头正好有这个芯片或者想留点余量的人。1.2 RTT Viewer 为什么能接在 DAPLink 后面Segger RTT的官方定位是配合J-Link调试器使用的实时日志工具原理其实不复杂目标芯片的RAM里维护一个环形缓冲区调试器通过SWD口不断读写这块内存上位机RTT Viewer负责把读到的内容显示出来同时也能向下发数据。它有几个传统串口比不了的优势不占额外引脚不用接一根UART线只要调试器和目标芯片之间的SWD两根线不断日志通道就在。速度快RTT走内存访问刷新率远高于串口适合高频日志输出。支持双向通信可以向目标芯片发送命令或者输入参数。为什么RTT Viewer能用DAPLink因为RTT的完整数据链路是上位机软件 ---(USB)--- 调试器 ---(SWD)--- 目标芯片RAM。中间那层只负责把USB请求翻译成SWD读写操作这正好是CMSIS-DAP协议的标准能力。SEGGER从较新版本的J-Link软件包开始给RTT Viewer加入了连接CMSIS-DAP调试器的选项所以只要你电脑上装了新版的J-Link软件里面自带的RTT Viewer就能直接选DAPLink。这是整条链路里最巧妙的一点硬件是ARM开源方案软件是SEGGER生态两者通过标准SWD协议打通了。1.3 这套组合适合谁用、不适合谁用适合的场景很明确学生党、电子爱好者、手头只有F103开发板但想体验RTT日志的人还有那些不希望为每个调试台都配一个J-Link的团队。用RCT6刷成DAPLink相当于几十块钱买了一个功能非常接近正统DAPLink的调试器还顺带获得RTT Viewer的使用权。不适合的场景也有如果你需要极致的下载速度或者要调试多核芯片、要跟踪Trace功能那还是老老实实上J-Link Plus级别以上的工具。DAPLink终究是CMSIS-DAP的定位SWD速度比不过J-Link的高端型号RTT在高频大数据场景下也可能面临带宽瓶颈。另外如果你想做产品量产下载工具DAPLink的批量烧录稳定性也值得反复测试不宜直接就用社区固件跑产线。2. 硬件盘点与引脚设计RCT6 相比 C8T6 的优势和要改的地方2.1 核心资源够不够用STM32F103RCT6资源如下资源参数对DAPLink的意义内核Cortex-M3 72MHz处理SWD协议运算余量充足Flash256KB是C8T6的4倍固件随便装SRAM48KB缓存USB端点、SWD命令队列、RTT控制块都够USBUSB 2.0 FS DeviceDAPLink与电脑通信的主通道USART2物理串口虚拟串口的后端通道SWDIO/SWCLKPA13/PA14对外连接目标芯片的调试口DAPLink固件本身在F103上运行它自身被调试时用同一个SWD引脚但一旦固件跑起来PA13/PA14的角色会切换为“输出到目标芯片的信号线”。这个转换逻辑是在固件里实现的所以不用担心引脚冲突但烧录之前要想清楚你在用ST-Link给F103烧DAPLink固件的时候占用的就是PA13/PA14烧完之后ST-Link拔掉PA13/PA14才交给DAPLink固件使用去连接外部目标芯片。2.2 USB、SWD、UART、LED 引脚分配不同DAPLink工程引脚定义略有差异我这里基于常见的F103DAPLink移植工程说明功能引脚备注USB D-PA11必须连接USB座D-USB DPA12必须连接USB座DSWDIOPA13固件内置上拉对目标芯片输出SWCLKPA14对目标芯片输出时钟UART TXPA2虚拟串口发送端USART2_TXUART RXPA3虚拟串口接收端USART2_RXLED连接状态PB0连接上目标芯片后点亮/闪烁LED运行状态PB1固件运行后常亮或呼吸闪烁如果你的板子Pin映射不同修改IOConfig.h重启编译即可。RCT6是LQFP64封装的缘故PB0/PB1这种IO在C8T6上也有但RCT6提供了更多PB和PD口你可以把LED换到更顺手的引脚。关键是USB的PA11/PA12和SWD的PA13/PA14是固定的因为USB外设和调试口的物理映射就这两路没法改。2.3 晶振和供电布局不能省F103的USB模块必须工作在48MHz。它从PLL输出里分频得到48MHz所以PLL链路必须配置正确。如果你的板子用的8MHz晶振那么最常见的配置是HSE8MHzPLL倍频9倍SYSCLK72MHz然后USB预分频1.5分频得到48MHz。这也是绝大多数F103核心板默认的配置。如果板子用了其他频率的晶振比如16MHz或者25MHz改动起来就会麻烦很多要么换晶振要么改固件里的RCC配置代码否则USB枚举很容易失败。供电方面DAPLink从USB取5V后经过板载LDO转3.3V给MCU。USB枚举瞬间电流会有一个尖峰3.3V滤波电容别太小至少要有两个10uF和几个100nF的组合。否则可能出现一种很奇怪的现象刚插USB时能被识别拔插一下又失联最后发现是3.3V电压跌落导致DAPLink复位重启了。2.4 如果从 C8T6 工程改到 RCT6硬件上要动哪些很多现成的DAPLink工程是基于STM32F103C8T6的从C8T6改到RCT6硬件上就几个点封装从LQFP48变成LQFP64引脚变多原理图里其他IO可以按需接出来与DAPLink核心功能无关的引脚留空即可。启动文件从startup_stm32f10x_md.s换成startup_stm32f10x_hd.s因为RCT6属于高密度器件。分散加载文件或链接脚本里Flash/RAM大小从64KB/20KB改成256KB/48KB。如果原工程是针对C8T6的最小板LED引脚可能接在PC13等位置改板型时注意新板的LED实际连接。RCT6的外设和C8T6基本一致USB、USART2、SWD这些没有差异所以固件层的移植工作量不大主要就是启动文件和内存配置不能搞错。3. 固件移植从源码到 Keil5 可编译工程3.1 源码怎么选官方仓库还是社区工程DAPLink官方仓库ARMmbed/DAPLink功能最全但构建系统用的是Yotta和CMake默认目标是GCC工具链直接塞进Keil5会比较痛苦。所以最优解是找社区里的Keil5移植工程比如GitHub上搜索STM32F103 DAPLink Keil有几个成熟项目是基于F103C8的直接拿来改RCT6工程即可。我自己的做法是拉一个基于F103C8的Keil5工程作为模板然后针对RCT6调整启动文件、宏定义和分散加载文件。好处是省掉整个构建系统的折腾坏处是社区代码风格参差不齐需要自己看代码彻底理解引脚配置和宏开关。如果你选择官方仓库需要先把构建工具链跑通编出F103C8的hex然后才能改目标配置。这个过程相对复杂适合想深入学习DAPLink架构的人。纯应用层面直接用社区Keil工程能省大量时间。3.2 Keil5 工程改造的核心宏、启动文件、分散加载文件工程改造重点在三处第一Device选择。在Keil5的Options for Target - Device里芯片型号选择STM32F103RC这样RVCT会根据芯片型号自动选择合适的启动文件和内存布局但工程内原有的启动文件还是检查一下确保是startup_stm32f10x_hd.s或startup_stm32f103xe.s。第二宏定义。Keil的C/C选项卡里不同类型的DAPLink固件需要不同的宏组合。常见宏有DAPLINK_APP DAPLINK_IF TARGET_STM32F103C8 NO_SECT注意工程模板里可能写着TARGET_STM32F103C8虽然是C8T6的板型定义但如果你硬件上只是封装不同核心外设一样可以先保留这个宏。如果固件里用宏来控制Flash大小、引脚映射就需要把宏改成RCT6对应的版本。建议仔细看IOConfig.h和FlashOS相关的条件编译。第三分散加载文件。Keil工程里的sct文件如果写死了64KB Flash必须改成256KB。例如LR_IROM1 0x08000000 0x00040000 { ER_IROM1 0x08000000 0x00040000 { *.o (RESET, First) *(InRoot$$Sections) .ANY (RO) } RW_IRAM1 0x20000000 0x0000C000 { .ANY (RW ZI) } }Flash长度是0x40000256KBRAM是0xC00048KB。如果sct文件不改编译可能通过但运行起来会因为访问越界导致各种诡异错误而且USB枚举失败很难排查。3.3 编译通过不等于好使USB 时钟与 DFU/拖拽的区别第一次编译通过烧进去之后USB不一定能立刻枚举。很多人卡在“进Keil能编译但插电脑没反应”这一步原因大概率是时钟配置不对。刚才说过USB必须48MHz这个48MHz不是MCU自动选的而是固件里RCC初始化代码设定的。如果你拿到的工程原来基于C8T6的8MHz晶振那么RCT6板子如果也是8MHz晶振这一步就没什么问题。但如果板子晶振换了频率就要改SystemInit或board init里的时钟树配置。另外一个概念要提前搞清楚DAPLink固件分APP固件和bootloader引导层。如果你只烧APP固件那么它就是一个纯CMSIS-DAP调试器没有拖拽U盘功能。如果需要U盘拖拽烧录需要先烧bootloader再通过bootloader把APP固件的bin文件烧进去。为了省事我建议第一版只烧APP固件先把调试器功能跑通以后再决定要不要折腾拖拽功能。两种固件的编译目标是分开的烧错了会出怪问题。3.4 烧录引导用 ST-Link 把固件灌进去把编译好的hex烧到RCT6上最可靠的方式是用另一块ST-Link/J-Link通过SWD接口连接PA13/PA14。接线很简单ST-Link SWDIO - F103的PA13ST-Link SWCLK - F103的PA14ST-Link GND - F103的GND如果ST-Link和目标板电压不匹配最好共地然后板子自己供电Keil里Debugger选ST-LinkTarget芯片选STM32F103RC点下载几秒钟就烧完。烧完之后ST-Link直接拔掉不要再占用PA13/PA14因为DAPLink固件接下来要在这两条线上对外输出SWD。还有一种方式是用串口ISP把BOOT0拉高、BOOT1拉低通过串口下载hex到F103。这种方法适合没有ST-Link的人但需要每次烧录都改跳帽麻烦不少而且有的RCT6板子串口ISP的Bootloader版本比较老不认新hex所以不推荐。3.5 首次上电验证枚举成 CMSIS-DAP烧完固件插上USB线正常情况电脑设备管理器里会出现一个HID-compliant vendor-defined device或CMSIS-DAP兼容设备。Windows 10/11通常自动装好驱动。如果出现未知设备或黄色感叹号那就进入排查流程。为了确认DAPLink和电脑通信正常可以在Keil的Options for Target - Debug里把调试器从ST-Link改成CMSIS-DAP然后点Settings如果能识别到SW Device说明DAPLink固件和SWD接口都正常。这一步也相当于验证了你能不能用这个DAPLink给目标板下载程序。如果设备管理器里根本没有新设备大概率是USB总线或时钟问题后面第五部分我会详细讲排查思路。4. RTT Viewer 接入与数据验证4.1 目标端铺 RTT把 SEGGER_RTT 代码加进自己的 Keil 工程RTT要分两部分看一端是目标MCU里的RTT代码一端是PC上位机RTT Viewer。目标端的RTT库是SEGGER提供的不需要额外硬件就几个源文件。获取途径很简单安装J-Link软件后在安装目录下找Samples/RTT文件夹里面有SEGGER_RTT.c、SEGGER_RTT.h、SEGGER_RTT_Conf.h、SEGGER_RTT_printf.c这些文件。拷贝到自己工程的RTT文件夹里在Keil里添加源文件、添加头文件路径然后编译。也可以在SEGGER官网单独下载RTT源码包效果一样。在main函数里加初始化调用#include SEGGER_RTT.h int main(void) { SEGGER_RTT_Init(); // 其他初始化代码 while (1) { SEGGER_RTT_WriteString(0, Hello from F103RCT6\r\n); static uint32_t counter 0; SEGGER_RTT_printf(0, counter%u\r\n, (unsigned int)counter); Delay_Ms(100); } }SEGGER_RTT_WriteString是字符串直出参数0表示通道0这个通道是向上位机发数据的默认通道。SEGGER_RTT_printf支持格式化输出但要注意它不支持浮点数打印float要用整数拆分或者sprintf再输出。这也是我在工程里常见的抱怨点但实际调试够用。还要注意一点SEGGER_RTT.c本身要被正确加入编译并且不要把它放到会被优化掉的编译单元里。Keil的C/C编译优化级别可以保持默认但有特殊情况下需要把SEGGER_RTT相关文件作为不优化或低优化。这个问题后面踩坑再细说。4.2 上位机选调试器让 RTT Viewer 认识 DAPLink把新版的J-Link软件包装上里面自带J-Link RTT Viewer。打开后第一屏会让你选择连接方式Connection to J-Link选USB。“...”按钮打开调试器选择对话框这里不再只显示J-Link也会有CMSIS-DAP兼容的设备选择你的DAPLink。Target Device选目标芯片型号比如STM32F103RC或者直接选Cortex-M3。Interface选SWD。Speed可以先选1MHz稳定后再尝试更高速度。这个对话框很关键。如果你用的J-Link软件版本太老可能看不到CMSIS-DAP选项那是因为它还不支持非J-Link调试器。解决方案就是升级J-Link软件到较新版本比如V7.x下载地址就是SEGGER官网。连接成功后RTT Viewer会去目标芯片的RAM里搜索SEGGER RTT控制块。这个控制块在目标芯片里的数据结构包含了缓冲区地址和读写位置。通常自动搜索就能找到然后你会看到输出终端的空白窗口。如果目标工程正在运行且调用了SEGGER_RTT_WriteString终端里就会滚动显示日志。4.3 参数调优SWD 速度、控制块搜索、缓冲区大小DAPLink的SWD物理速度比J-Link低不少RTT Viewer在高频率输出日志时会有限制。我实测下来DAPLink下SWD速度设在1MHz比较稳4MHz以上容易出错。不是说不能设更高而是F103的DAPLink固件USB枚举和SWD状态机吞吐能力有限过高速度会导致RTT读内存失败。如果RTT Viewer提示找不到控制块可以先检查目标程序里有没有调用SEGGER_RTT_Init以及SEGGER_RTT_CB这个控制块地址是不是被链接器放到了一个搜索范围外。RTT Viewer默认搜索RAM区域一般会自动发现。实在找不到可以在RTT Viewer的设置里手动指定搜索范围如果已知控制块地址直接填进去。一个土办法在目标程序里通过串口打印一下(unsigned int)SEGGER_RTT_CB这个全局变量的地址然后手填给RTT Viewer基本必连上。缓冲区大小在SEGGER_RTT_Conf.h里调整#define BUFFER_SIZE_UP (1024) #define BUFFER_SIZE_DOWN (16)这表示上传缓冲区目标到PC默认1024字节下载缓冲区PC到目标16字节。如果日志量大而PC端没来得及读缓冲区满了之后新的日志会覆盖旧日志默认是丢弃还是覆盖取决于方向设置。增大上传缓冲区能缓解但会占用更多RAM。F103RCT6有48KB RAM给RTT开8KB缓冲完全无压力。对于C8T6那种20KB RAM的芯片就得精打细算一些。5. 我实测中踩过的坑和排查思路5.1 枚举失败先看线再看电源最后看时钟插上USB设备管理器没反应的排查顺序很重要我按这个顺序一次一次定位问题第一换线。很多USB线只有充电能力没有数据线芯这种线插上去完全不会触发设备枚举。我一开始就栽在这里换了一根带数据传输功能的线才识别到。第二供电。如果F103板子上的3.3V电压不够稳MCU可能反复重启USB枚举就无法完成。用万用表量一下LDO输出低于3.2V就先修硬件。第三时钟。用示波器看HSE晶振引脚是否有8MHz振荡没有振荡看晶振电容是否匹配、晶振是否焊接好。如果固件配置了8MHz晶振而板子上实际焊接的是16MHz晶振USB枚举就是起不来。还有一个不容易注意的点F103的USB D需要内部上拉这个上拉由USB_DP引脚控制固件里在USB初始化时会打开。如果固件压根没跑起来D不会被拉高电脑就不知道有设备插入。所以如果灯不亮、程序没启动先不管USB的事先查MCU有没有正常运行。5.2 RTT 连上了但没输出先找控制块RTT Viewer能成功连接目标芯片说明SWD通道没问题但终端里一片空白。这时按顺序排查确认目标程序编译时是否真的包含了SEGGER_RTT.c有时候只把头文件路径加进去了但源文件漏加编译照样过因为头文件里声明了接口但链接时没有实现会报错。如果没报错那就是SEGGER_RTT.c被编译器条件编译屏蔽了更常见的坑是RTT控制块的地址没被正确搜索。自动搜索默认在目标RAM区域扫描特征字符串如果目标程序用了很高的优化等级或者编译器把SEGGER_RTT_CB放在了某个对齐边界上自动搜索可能失败。手动指定RAM起始地址比如0x20000000让RTT Viewer在更大范围搜索通常能解决。还有一种情况是调用了SEGGER_RTT_WriteString但没调用SEGGER_RTT_Init。虽然RTT_Init不是绝对必须但建议在main最前面调用不然某些版本里控制块状态不对。5.3 打印太快丢数据缓冲区与速度怎么平衡RTT在DAPLink下出现日志丢失原因通常是SWD读取速度低于数据生成速度。加大BUFFER_SIZE_UP可以短暂缓解但治标不治本。真正问题在于DAPLink物理层SWD速度上限。建议降到1MHz以下读取更可靠。目标程序里初始化RTT后如果每个循环都大量打印数据量远超SWD带宽。这时需要降低日志频率或者把高频日志暂时别打只保留关键状态。这个瓶颈在J-Link上不那么明显因为J-Link读内存快得多。DAPLink毕竟走CMSIS-DAP通用协议速度上不去很正常。你能做的就是让目标端打印策略更克制比如用level开关控制日志输出或者把周期性日志合并。5.4 高优化等级下 RTT 失效的两种表现Keil的AC6编译器在高优化等级下经常出现RTT输出错乱或者完全没输出。踩过两次坑第一次是整个工程用-O3优化RTT控制块某些字段被编译器优化掉RTT Viewer能连接但读到的缓冲区地址无效。解决方式是把SEGGER_RTT.c单独设置成-O0优化在Keil工程里选中该文件右键Options把Optimization改成Level 0。第二种表现是RTT输出有字符串但内容跳变或者重复。这通常是缓冲区读写的内存顺序问题编译器重排了读写指令顺序。RTT库在SEGGER_RTT_Conf.h里定义了内存屏障相关宏检查字节序和原子操作的配置。正常情况下按官方默认配置就行但如果你改过宏要注意别把无关优化搞进去。5.5 别忽略驱动和软件的版本坑RTT Viewer能识别DAPLink依赖J-Link软件版本前面提过。一个典型坑电脑上装了老版本的J-Link驱动RTT Viewer打开后只能看见J-Link设备完全没有CMSIS-DAP选项。这种情况卸载旧版本装新版即可。另外如果你电脑上同时装了多个版本的J-Link软件或者之前装过DAPLink驱动再插别的调试器可能出现设备管理器里面设备描述符错乱。稳妥的办法是插上DAPLink之后在设备管理器里手动更新驱动让Windows重新匹配CMSIS-DAP类设备。如果还不行把“通用串行总线设备”下的未知设备删掉重新插拔一次。6. 这套方案还能怎么延伸6.1 同时保留虚拟串口和 RTT 双通道DAPLink自带虚拟串口功能目标端的日志如果走USART2PA2/PA3会在电脑上映射成一个COM口。RTT则走SWD通道两者互不干扰。这样可以做一套双通道日志方案低频的启动信息、错误码通过虚拟串口输出高频的实时数据通过RTT输出。这个场景下RCT6的48KB SRAM优势就体现出来了UART和RTT缓冲区都能开大一点。6.2 在 DAPLink 上叠加拖拽烧录功能如果你编译的是bootloaderAPP的完整DAPLink固件插入电脑后会出现一个U盘盘符。把目标固件的bin文件拖进盘里DAPLink会把它写到挂接的目标芯片上。这个功能对快速给目标板换固件很方便。需要注意F103老版本拖拽速度普遍偏慢大文件烧录时要耐心等别中途拔线。6.3 把 DAPLink 变成离线量产工具基于DAPLink可以自己写一个烧录脚本用命令行或者Python调用CMSIS-DAP的DLL实现批量下载。加上RCT6的引脚资源比较充裕你可以做一个小工装板把SWD输出、供电检测、指示灯都做好然后逐台测试目标板。这套方案成本极低适合小批量生产或者售后维修场景。我个人的做法是把DAPLink固件烧进最小的F103RCT6核心板板载的LED改成一个“下载完成”提示灯然后接一个SWD排线出来配合RTT Viewer显示目标板的运行日志。刚开始几天我甚至把它当成J-Link的平替在用Keil里编译下载、断点调试、RTT日志都正常大部分场景下体验已经非常接近正版调试器了。最后再分享一个实际操作中的小技巧把DAPLink固件源码里对目标芯片复位引脚的控制加上。很多DAPLink工程默认不控制目标板的nRST引脚但连接目标板时如果目标芯片休眠或者跑飞了SWD可能连不上。这时如果DAPLink有硬件复位控制线可以在Keil设置里勾选Reset and Run一键把目标板拉复位再下载成功率会高很多。给DAPLink预留一个复位输出引脚几乎不增加成本但能在调一些难缠的低功耗场景时救你一把。本文还有配套的精品资源点击获取