最近在用 openocd 调试 zynq ultrascale mpsoc PS端的 A53。现在调通了,对配置文件进行一个解析记录,方便自己后续回顾。
一、配置文件代码
openocd 使用的是 PJTAG 端去连接的 MPSOC,JTAG 扫描链上只有 ARM DAP。如下图所示:
调试器使用的是 FTDI ft4232h。这个配置文件简单,openocd官方也有demo,也不赘述了。
zynq mpsoc的配置文件如下所示,我会逐行解释代码:
# SD 卡配置模式启动,配置 MIO 映射,启用 PJTAG 接口。
# zynq_ultrascale MPSOC
# 执行命令:openocd -f ft4232h.cfg -f zynq.cfg
# 设置 芯片名,自定义即可
set _CHIPNAME uscale
# 设置 ARM DAP 的 IDCODE,会通过此ID去检索 DAP。
set _DAP_TAPID 0x5ba00477
# 创建名为 tap 的JTAG TAP,指定 IR 长度为4,期望 IDCODE 为 0x5ba00477,并验证 IR 移位capture的正确性。
jtag newtap $_CHIPNAME tap -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_DAP_TAPID
# 创建一个 DAP 实例绑定到刚创建的 JTAG TAP 上。
dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.tap
# 设置一些变量,后续使用
set _TARGETNAME $_CHIPNAME.a53
set _CTINAME $_CHIPNAME.cti
set _smp_command ""
# ug1085 p1200 CoreSight Address Map
# 四个 A53 core debug coresignt 组件的地址
set DBGBASE {0x80410000 0x80510000 0x80610000 0x80710000}
# 四个 A53 core CIT coresignt 组件的地址
set CTIBASE {0x80420000 0x80520000 0x80620000 0x80720000}
# A53 core 的数量,zynq mpsoc PS端有 四核 A53
set _cores 4
# TCL语法,用于创建 target
for { set _core 0 } { $_core < $_cores } { incr _core } {
# 在DAP实例上指定 MEM-AP 和基地址访问 Coresight 组件 CTI,并创建对应实例。一共4个CTI实例,对应4个core。
cti create $_CTINAME.$_core -dap $_CHIPNAME.dap -ap-num 1 \
-baseaddr [lindex $CTIBASE $_core]
# 通过指定 DAP,CTI以及Core debug 组件地址来创建 target
set _command "target create $_TARGETNAME.$_core aarch64 -dap $_CHIPNAME.dap \
-dbgbase [lindex $DBGBASE $_core] -cti $_CTINAME.$_core"
if { $_core != 0 } {
# 对于 core1,2,3取消 JTAG 链初始化和复位时的检查操作
# 需要手动调用 arp_examine 才能访问这些目标进行调试。
set _command "$_command -defer-examine"
# 拼接指令
set _smp_command "$_smp_command $_TARGETNAME.$_core"
} else {
# 拼接指令
set _smp_command "target smp $_TARGETNAME.$_core"
}
# 执行命令
eval $_command
}
# 指定 ap 为 AXI-AP ,创建目标 axi,可访问 axi bus上所挂载的外设。
target create $_CHIPNAME.axi mem_ap -dap uscale.dap -ap-num 0
# 执行命令 target smp uscale.a53.0 uscale.a53.1 uscale.a53.2 uscale.a53.3
eval $_smp_command
targets $_TARGETNAME.0
# tcl语法,定义名为 core_up 的过程,用于切换当前 target。
proc core_up { args } {
global _TARGETNAME
foreach { core } [set args] {
$_TARGETNAME.$core arp_examine
}
}
二、相关命令官方文档参考链接
查找渠道:通过 Command and Driver Index 页面进行命令检索。
- jtag newtap :10.3 TAP Declaration Commands
举例:
jtag newtap $_CHIPNAME tap -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_DAP_TAPID
dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.tap
(1)这里需要注意的一点是 调用 tap 时,通过 chipname.tapname
的形式进行调用。
(2)然后 -ircapture 0x1 -irmask 0xf
是用来验证 IR 扫描链的正确性的,但具体怎么做的还是没懂,这个 掩码表示什么意思如果有明白的朋友可以在评论区分享下,谢谢啦!
-
dap create:10.8 DAP declaration (ARMv6-M, ARMv7 and ARMv8 targets)
-
cti create:16.2 ARM Cross-Trigger Interface
-
target create : 11.3 Target Configuration
创建所要进行 debug 的目标芯片或者其他器件,通过 TAP 发送指令对其进行调试操作。
(1)-defer-examine :在 JTAG 扫描链初始化和复位时跳过对目标的检查,需要手动调用arp_examine
才能访问这些目标进行调试。 -
$target_name arp_examine 11.4 Other $target_name Commands