4. TRACE32安装与工作环境搭建

TRACE32 是 Lauterbach 公司提供的硬件辅助调试与跟踪工具，其安装并不是“双击下一步”那么简单。它由多个相互依赖的部分组成：主程序与调试器内核、芯片/内核架构支持包、目标处理器描述文件、License 授权、用户工作目录，以及连接目标板的调试接口驱动。只有这些部分都正确就位，TRACE32 才能识别目标芯片、加载符号、访问内存并采集 Trace 数据。本节围绕软件安装、License 配置、工作目录、配置文件与远程调试环境初始化五个环节展开，目标是搭建一个可复现、可迁移的调试工作环境。

软件安装：主程序与架构支持包

TRACE32 的安装介质通常按主机操作系统和调试器类型区分。以 Windows 主机为例，安装目录常见为 C:\T32，其下会形成若干关键子目录：bin\windows64 存放可执行程序，demo 存放示例脚本，pdf 存放手册，而各架构支持包则位于形如 C:\T32\arm、C:\T32\riscv 的目录中。安装时建议遵循两条原则：一是路径中不要出现中文和空格，避免脚本解析异常；二是主程序与架构包版本保持一致，混用不同版本的 bin 与架构目录可能导致调试器启动时报“incompatible”类错误。

安装完成后，可通过命令行验证基础环境是否可用。例如在 C:\T32\bin\windows64 下执行：

t32marm.exe -c config.t32

其中 t32marm.exe 是 ARM 架构的调试器主程序，-c 指定配置文件。若程序能弹出 TRACE32 主窗口并显示命令行区域，说明主程序与架构包已正确关联。对于多架构项目，可以并存多个架构目录，通过不同主程序分别启动，互不干扰。

License 配置：授权文件与节点锁定

TRACE32 的 License 决定可用功能范围，例如是否支持 Trace、是否支持多核调试、是否允许远程访问。License 通常以授权文件或加密狗形式提供。授权文件一般命名为 license.dat 或类似名称，需放置在 TRACE32 能够识别的路径下，常见做法是放在安装根目录或用户工作目录，并在配置文件中通过 LICENSE 关键字指向它。

License 分为节点锁定（Node-Locked）和浮动（Floating）两类。节点锁定绑定主机网卡 MAC 地址或加密狗，适合单机调试；浮动 License 由 License Server 统一管理，适合团队共享。配置浮动 License 时，需要在配置文件中写入服务器地址与端口，例如：

LICENSE=27000@192.168.1.50

配置完成后，启动 TRACE32 时若 License 无效，会在消息区提示 License error 或功能受限。此时应检查：授权文件路径是否正确、MAC 地址是否与申请时一致、浮动服务器是否可达、防火墙是否放行对应端口。建议在正式使用前先用一个简单脚本验证 Trace 功能是否被授权，避免到采集阶段才发现权限不足。

工作目录与配置文件

工作目录是 TRACE32 存放用户脚本、符号文件、Trace 采集结果和日志的根目录。推荐为每个项目建立独立工作目录，例如 D:\t32_work\project_a，并在其中组织如下结构：config 存放配置文件，scripts 存放 .cmm 脚本，symbols 存放 ELF/AXF 符号文件，trace 存放采集数据。这样做的目的是让调试环境与项目绑定，便于版本管理和团队交接。

配置文件通常命名为 config.t32，是 TRACE32 启动时读取的核心文件。它定义了调试接口、目标芯片、License、工作目录和远程访问等参数。一个典型的 ARM 调试配置片段如下：

PBI=
  USB
OS=
ID=MyTarget
TARGET=
  SYStem.CPU Cortex-A53
  SYStem.JtagClock 10MHz
LICENSE=27000@192.168.1.50
TMP=D:\t32_work\project_a\tmp

其中 PBI 指定物理接口，SYStem.CPU 指定目标 CPU 型号，SYStem.JtagClock 设置 JTAG 时钟，TMP 指定临时目录。配置文件中的参数会直接影响调试器能否连接目标板，因此修改后应逐项核对，尤其是 CPU 型号与接口类型必须与实际硬件一致。

远程调试环境初始化

在嵌入式项目中，目标板常位于实验室或产线，而工程师在办公区工作，此时需要配置远程调试。TRACE32 支持通过 TCP/IP 进行远程访问，典型架构是：目标板通过 JTAG/TRACE 接口连接一台“调试服务器”主机，该主机运行 TRACE32 并监听端口；工程师在本地主机运行 TRACE32 客户端，通过 SYStem.Up 和远程连接命令访问服务器。

初始化远程环境的关键步骤包括：在服务器端配置文件中启用远程访问，例如设置 RCL=NETTCP 和监听端口；在客户端使用 SYStem.CONFIG 或 SYStem.Mode 指定服务器 IP 与端口；确认两端 TRACE32 版本兼容。远程连接建立后，客户端可以像本地一样加载符号、设置断点、读取内存和采集 Trace，但数据实际由服务器端硬件接口产生。

环境验证与常见问题

完成上述配置后，建议按以下顺序验证环境：首先启动 TRACE32，确认主窗口和命令行正常；其次执行 SYStem.CPU 确认目标 CPU 被识别；然后执行 SYStem.Up 尝试连接目标板，观察是否返回 SYStem.Up: OK；接着加载符号文件并读取一个已知地址的内存值，确认访问正常；最后运行一段简单 Trace 采集脚本，确认 Trace 功能被 License 授权且数据能正常回读。

常见问题中，SYStem.Up 失败多与 JTAG 时钟过高、目标板未上电或复位状态有关，可尝试降低 SYStem.JtagClock 至 1MHz 再试。License 报错则优先检查授权文件路径和浮动服务器连通性。远程连接失败时，可用 ping 和 telnet 验证服务器端口是否开放。工作目录不可写会导致 Trace 数据无法保存，应在配置阶段就确认磁盘权限。