第四章 CMN调试环境搭建：DS-5/DS-1000调试器连接、CMN调试脚本基础、Trace工具配置
说实话，调试CMN这种级别的互联，光靠看代码和波形是不够的。你得有一套趁手的工具链。这一章，我就带你亲手把调试环境搭起来。别小看这一步，我见过太多工程师在环境配置上卡了一整天，结果发现是线没插紧。
4.1 DS-5与DS-1000调试器连接
DS-5是ARM官方的调试IDE，配合DS-1000调试器，可以直连CMN的调试接口。嗯，这里要注意，CMN的调试接口不是普通的JTAG，它走的是CoreSight架构。
核心要点：CMN的调试入口是APB-AP（Access Port），通过DS-1000的JTAG/SWD口接入，再映射到CMN的配置寄存器空间。
我个人习惯的接线方式是这样的：
- DS-1000的JTAG口连到目标板的20-pin调试座
- 确保目标板供电正常，调试器独立供电（别问我为什么强调这个，我曾经烧过一个调试器）
- 在DS-5中新建一个Debug Configuration，选择"ARM DS-1000"作为连接器
连接成功后，你会看到CMN的地址空间被映射到调试器的内存窗口。这时候，你就可以直接读写CMN的配置寄存器了。
小技巧：第一次连接时，建议先读一下CMN的PERIPHERAL_ID寄存器，确认调试路径是否打通。这个寄存器的值通常是0xB105F00D，读出来不对的话，先检查硬件连接。
4.2 CMN调试脚本基础
手动点寄存器太慢了。我一般会写一套调试脚本，用DS-5的Command Line Interface（CLI）来批量操作。说白了，就是用脚本代替手工劳动。
下面是我常用的一个脚本模板，用来初始化CMN的调试环境：
// cmn_debug_init.ds
// 作者：我，2024年更新
// 用途：初始化CMN调试环境
// 1. 连接到目标
connect -target "ARM DS-1000"
// 2. 选择CMN的APB-AP
target select 1
// 3. 读取CMN版本信息
mem32 0x80000000 4 // 假设CMN基地址为0x80000000
// 4. 使能CMN的调试模式
mem32 0x80001000 = 0x00000001 // CMN_DEBUG_CTRL寄存器
// 5. 验证使能状态
mem32 0x80001000 1
echo "CMN调试模式已使能"你想想看，如果每次都要手动输入这些命令，多累啊。写成脚本后，一键执行，省时省力。
警告：写脚本时，一定要确认CMN的基地址。不同芯片的CMN基地址可能不同。我曾经在某个项目中，因为基地址写错了，读回来的全是0xDEADBEEF，排查了半天才发现是地址问题。
除了初始化脚本，我还会写一些常用的调试函数，比如：
read_cmn_reg(addr)：读取CMN寄存器write_cmn_reg(addr, value)：写入CMN寄存器dump_cmn_config()：导出CMN的完整配置
这些函数可以封装成一个库文件，每次调试时直接source进来。
4.3 Trace工具配置
Trace工具是调试CMN的利器。它能实时抓取CMN内部的事务流，比如请求从哪里来、到哪里去、花了多少时间。说白了，就是给CMN装了个行车记录仪。
我常用的Trace工具是ARM的Streamline，配合DS-1000的Trace接口使用。配置步骤如下：
- 在DS-5中打开Streamline
- 选择Trace Source为"CMN-600"（根据你的CMN版本选择）
- 配置Trace使能寄存器，选择要监控的事件类型
- 开始采集，运行目标程序
- 停止采集，分析Trace数据
关键配置：Trace使能寄存器位于CMN的调试地址空间，通常偏移量为0x2000。你需要设置ENABLE位，并选择要监控的RN-F（请求节点）和HN-F（主节点）。
我记得有一次，系统性能上不去，怀疑是CMN的带宽瓶颈。用Trace工具一抓，发现某个HN-F的请求队列经常满，导致请求被阻塞。后来调整了队列深度，性能就上来了。没有Trace工具，这种问题根本没法定位。
4.4 知识体系结构图
下面这张图，是我自己画的CMN调试环境搭建的完整流程。你可以把它贴在工位上，每次调试前看一眼，心里就有数了。
4.5 避坑指南
调试环境搭建过程中，有几个坑我踩过，分享给你：
- 电源问题：DS-1000调试器需要独立供电，不要从目标板取电。我曾经因为偷懒，直接从目标板取电，结果调试器不稳定，数据经常出错。
- 时钟问题：CMN的调试接口需要独立的调试时钟。如果目标板的调试时钟没起振，你是连不上CMN的。先量一下TCK引脚有没有波形。
- 地址映射问题：CMN的调试地址空间可能被其他外设占用。在连接前，先确认地址没有冲突。
我的经验：每次搭建新平台的调试环境时，我都会先写一个"hello world"脚本——就是读一下CMN的版本寄存器。如果这个能读对，说明环境基本没问题。然后逐步增加功能，这样排查问题会快很多。
好了，调试环境搭好了，脚本也写好了，Trace工具也配好了。接下来，你就可以开始真正的CMN调试之旅了。记住，工具只是手段，理解CMN的内部机制才是关键。