寻求Python调用Trace32 rcl API的语法参考文档

• 首先，Lauterbach官方针对lauterbach.trace32.rcl模块的专属文档，是随Trace32安装包一起发布的，路径一般是：

  • Windows：C:\T32\doc\pdf\python_rcl.pdf
  • Linux：/opt/t32/doc/pdf/python_rcl.pdf
    这份文档里有连接实例、执行命令、读写变量的完整语法和示例，比旧的ctypes方法文档详细得多。

• 基础操作的语法示例：

  • 连接Trace32实例：

    from lauterbach.trace32.rcl import *
    
    # 配置连接参数
    config = Config()
    config.host = "localhost"  # 远程控制时换成目标IP
    config.port = 20000        # Trace32默认RCL端口
    
    # 建立连接
    client = Client(config)
    client.connect()
    

  • 执行Trace32命令行指令：
    用client.cmd()直接发送T32原生命令，比如运行脚本、设置断点：

    # 运行CMM脚本文件
    client.cmd("DO ./scripts/init.cmm")
    # 设置硬件断点
    client.cmd("Break.Set 0x80001000 /Hardware")
    # 启动程序运行
    client.cmd("Go")
    

  • 读写目标系统变量：
    用client.var_read()和client.var_write()直接操作变量：

    # 读取全局变量status的值
    status = client.var_read("app_status")
    print(f"当前app_status值: {status}")
    
    # 修改变量值为0x5
    client.var_write("app_status", 0x5)
    

  • 获取命令执行的返回结果：
    用client.cmd_result()获取指令的输出内容，比如读取寄存器：

    # 获取当前PC寄存器的值
    pc = client.cmd_result("Register.PC")
    print(f"当前PC地址: {pc}")
    

• 额外参考：

  • 如果找不到上述文档，打开Trace32后，通过Help > Documentation搜索「Python RCL」就能找到对应的官方文档。
  • Trace32安装目录下的python子文件夹里有现成的示例脚本（比如rcl_example.py），直接运行就能看到实际效果。

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