Eclipse插件下T32 Practice脚本如何正确定义输入参数

核心错误点汇总 #

• 命令适用场景混淆：ENTRY和PARAMETERS的使用规则不匹配插件调用逻辑
  • ENTRY是PRACTICE脚本的形参声明，必须放在脚本第一有效行，前置不能有除空行之外的注释、可执行代码，否则声明直接失效
  • PARAMETERS是用来读取命令行传入的自由位置参数，对位置要求低，但如果插件自动追加了隐式参数，会导致参数位偏移，拿到空值
• 插件配置格式错误：直接把参数拼在启动脚本路径栏，插件会将整段字符串识别为脚本文件路径，直接触发“找不到脚本”错误，根本不会执行传参逻辑
• 路径转义错误：Windows路径的反斜杠\在PRACTICE脚本中是转义字符，未做处理会导致路径解析断裂
• 内置命令冲突：插件默认开启内置程序加载逻辑，会覆盖自定义cmm脚本的加载动作

修复&排查步骤 #

1. 修正cmm脚本写法 #

优先用ENTRY做参数声明（和Eclipse T32插件的调用逻辑适配性更好），同时加上参数校验和路径兼容处理，参考代码：

// ENTRY必须放在脚本最开头，前面不要加任何其他有效代码
ENTRY &elfLocation

// 增加参数非空校验，快速定位传参失败问题
IF "&elfLocation" == "" THEN (
  PRINT "ERR: 未传入ELF文件路径参数"
  PAUSE 3s
  ENDDO
)

// 统一替换反斜杠为正斜杠，规避转义问题
&loadPath = REPLACE("&elfLocation", "\\", "/")
PRINT "待加载ELF路径: &loadPath"

// 加载时增加校验参数，加载失败直接抛错
Data.load.Elf &loadPath /Verify
IF FOUND()!= 0 THEN (
  PRINT "ERR: ELF文件加载失败"
  PAUSE 3s
  ENDDO
)

2. 修正Eclipse插件配置 #

• 启动脚本（Script to run on startup）输入框仅填写load.cmm的完整绝对路径，不要在路径后拼接任何参数
• 找到配置页独立的「脚本参数（Script Arguments）」输入框，单独填入ELF文件完整路径，路径两端必须包裹半角双引号，格式为："C:\LocalData\Projects\build\a.elf"，避免路径含空格/特殊字符时被截断
• 取消勾选配置项「使用默认加载命令（Use default load command）」，防止插件内置加载逻辑覆盖自定义脚本

3. 传参有效性验证 #

• 启动调试会话后，在TRACE32底部命令行直接执行PRINT &elfLocation，查看打印的宏值是否为传入的ELF路径：如果为空，说明参数未成功传入；如果路径乱码/缺段，说明引号包裹或转义有问题
• 打开TRACE32安装目录下的t32.log日志文件，查看启动时实际执行的命令行，正确格式应为：<T32执行程序路径> -s <load.cmm完整路径> "<elf完整路径>"，如果参数未跟在-s指定的脚本路径之后，就是插件配置栏填写错误

兜底兼容方案 #

如果插件版本过低（低于R.2020.09）存在传参丢引号、参数位偏移的已知bug，不需要走外部传参逻辑：T32插件启动脚本时会自动注入内置宏变量，直接在脚本里拼接路径即可，稳定性更高：

// 直接用插件注入的工程路径宏拼接ELF路径，无需外部传参
&loadPath = "&PROJECT_PATH/build/a.elf"
Data.load.Elf &loadPath /Verify

常用内置宏包括&WORKSPACE_PATH（当前工作空间路径）、&PROJECT_PATH（当前选中工程路径）、&LAUNCH_CONFIG_NAME（当前启动配置名），可直接在脚本中调用。

内容的提问来源于stack exchange，提问作者ndarkness