3.1.7:调试器使用教程
1. 支持的开发环境
支持MDK、IAR 免配置直接使用。
基于eclipse 框架的IDE
eclipse 框架的IDE 一般编译器配置为 gcc,调试器配置为 pyocd 或者 openocd 的形式,需要定制厂家对DAPLink 进行支持,或者安装 DAPLINK 的支持插件,典型的IDE 比如 RT-thread Studio 原生支持 DAPLink 的调试。
openocd 使用文档:Documentation (openocd.org)
使用pyocd 或者 openocd 的用户,以及使用eclipse 框架的IDE,请尽可能的使用新版本的驱动和软件,原因在于开源的发展速度相对较快,过时的版本可能支持不完善,或者已经弃用,而避免产生问题。
2. 调试环境设置
2.1 MDK 调试设置
按照如下的流程,打开项目设置,选择CMSIS-DAP 调试器,如下图所示:
按照如下的设置,调整调试器的基本设置,并检查目标芯片是否连接正常,如下图所示,没问题之后,进入下一步。
SWD/JTAG Communication Failure/ RDDI Error 处理方法:
Flash Download 设置如下,根据实际的项目要求,设置合适的擦除方式,以及Program、Verify、Reset and Run 选项,并添加当前芯片的flash 算法,如下图所示
- 擦除方式选择:如果需要保留芯片的某些数据,比如设置数据,签名信息,一般选择擦除方式为 Sector Sections
- Reset and Run:在现在固件后要执行复位并运行,需要勾选Reset and Run 选项
针对高级用户,可以根据需要调整自定义调试设置,如下所示:
检查Use Debug Driver选项,启用硬件调试器,此选项默认是开启的,如遇到问题,此选项也是重点需要检查的设置,如下所示
检查设置之后,即可正常进入调试
操作示范
2.2 IAR 调试设置
项目右键,进入 Options 设置,切换到 General Options 标准设置页面,检查Target -> Device 是否选择正确,如下所示。
进入到Debugger 菜单,Setup 标签页面,选择 Driver 为:CMSIS-DAP 设备,根据需要可以勾选 Run to main 选项,如下所示。
在Debugger -> CMSIS-DAP 的 Interface 标签页中,选择接口为 SWD,如下所示
经过以上的设置就可以进行芯片的调试开发。
2.3 RT-thread Studio 调试设置
RT - thread Stduio 下载地址:https://www.rt-thread.org/studio.html
进入SDK Manager ,如下所示:
检查当前芯片支持包,RT-thread 源码,以及Pyocd 是否安装。
通过DAPLink进行项目调试,必须使用Pyocd 或者 OpenOCD 作为调试器的Adapter ,最终通过gdb 连接进行调试。
新建RT-Thread 项目,如下所示:
设置调试器,如下所示:
配置完成后,生成项目,即可进行下载和调试,如下:
在SDK-manager 中安装好 Pyocd 或者 Openocd 是必须的,
3. 常见问题报错
3.1提示设备不匹配
1.Connection refused due to device mismatch!(Not a genuine ST Device! Abort connection)
2.Not a genuine ST Device!Abort connection
3.PDSC:Sequence Execution failed
上述问题可能是由于购买芯片不是原装芯片,详情请见
https://docs.powerwriter.com/docs/faq/powerwriter/base/debug%20question#device_mismatch
3.2 无法识别烧录器或者芯片
1.No Debug Unit Device found
2.SWD/JTAG Communication Failure
3.RDDI-DAP ERROR
上述问题详情请见
3.3 烧录失败
1.Flash Timeout.Reset the Target and try it again.
2.Error:Flash Download failed - "Cortex-M4"
3.Could not stop Cortex-M device!Please check the JTAG cable.
4.Error:Flash Download failed - Target DLL has been cancelled
上述问题详情请见
3.4 烧录成功,校验失败
1.Contents mismatch at: 08000064H(Flash=FFH Required=0)
上述问题详情请见
https://docs.powerwriter.com/docs/faq/powerwriter/base/debug%20question#2189-contents-mismatch
3.5 Flash算法配置错误
1.Cannot Load Flash Programming Algorithm!
2.Overlapping of Algorithms at Address 08000000H
上述问题详情请见