Skip to main content
欢迎来到PAWPAW技术文档网站，了解更多信息。

XRUN使用手册

概览​

xrun [查询选项]

xrun [执行选项] xe文件

xrun [执行选项] --args xe文件 arg1 arg2 .. argn

功能描述​

xrun工具主要有两个功能：

实际上，xrun是xgdb工具的封装，旨在简化xgdb的常用操作。因此，凡是可以通过xrun实现的功能，也都可以通过xgdb来完成（但反过来不一定成立）。

选项说明​

--args <xe文件> <arg1> <arg2> ... <argn>​

这个选项提供了一种传递XE文件的替代方法，它还允许向程序传递命令行参数。

查询选项​

以下选项可以在不提供XE文件的情况下使用。最常用的选项是-l。

--list-devices, -l​

打印出连接到主机的所有JTAG适配器以及它们各自JTAG链上的设备列表。例如，以下输出显示了两个已连接的xtag设备：

xrun -l

可用的XMOS设备
----------------------

  ID    名称                    适配器ID      设备
  --    ----                    ----------      -------
  0     XMOS XTAG-3             V0JhnXmh        O[0]
  1     XMOS XTAG-3             wfF.G58J        P[0]

适配器按照它们的适配器ID进行排序。

--list-board-info, -lb​

展示连接的目标板的详细信息。

--help​

输出支持的命令行选项的详细描述。

--version​

显示xrun工具的版本号和版权信息。

执行选项​

如果只有一个xtag设备连接，它将被隐式指定为目标设备。如果有多个设备连接，则必须使用--id或--adapter-id来明确指定设备。

--id <ID>​

指定目标硬件连接的适配器ID。

--adapter-id <适配器ID>​

指定目标硬件连接的适配器的序列号。

--verbose​

输出目标设备上已加载程序的详细信息。

--jtag-speed <n>​

设置JTAG时钟的分频值为<n>。如果不指定，默认值为0，最大值为70。对于XMOS调试适配器，JTAG时钟速度被设置为25/(n +1)MHz。

--noreset​

加载程序前不重置JTAG扫描链上的XMOS设备。这不是默认行为。

以下选项用于启用调试功能。

--io​

在加载程序后，xrun会保持与JTAG适配器的连接，以便实现与宿主机的系统调用。当程序执行exit时，xrun会终止。默认情况下，xrun在程序加载后会断开与JTAG适配器的连接。注意：在需要系统调用时，建议使用--xscope选项而非--io选项，因为通过JTAG传递的系统调用速度较慢，并且会暂停 Tile 上的所有线程，可能会破坏开发者应用程序中的实时性保证。--io选项通常仅用于简单示例或在XSCOPE XLINK接口未与XTAG调试器连接的平台上。

--attach​

连接到已运行程序的JTAG适配器，允许与宿主机进行系统调用。当程序执行exit时，xrun会终止。使用此选项时，必须指定XE文件。

--dump-state​

打印JTAG扫描链上所有xCORE Tile 的核心、寄存器和栈的状态信息。

以下选项用于启用xSCOPE功能。

--xscope​

在目标设备上启用xSCOPE服务器。

--xscope-realtime​

通过套接字连接，在目标设备上启用实时xSCOPE服务器。

--xscope-file <文件名>​

指定用于xSCOPE数据收集的文件名。

--xscope-port <ip:端口>​

指定用于实时数据捕获的xSCOPE的IP地址和端口。

--xscope-limit <限制>​

设置xSCOPE数据收集的记录限制。

--xscope-io-only​

与--xscope选项相似。

使用示例​

xrun a.xe

在单个已连接的目标设备上异步启动a.xe程序，并在程序启动后立即返回命令提示符，不等待目标设备退出。

xrun -l

列出所有已连接的USB xtag设备。

xrun --adapter-id V0JhnXmh --args a.xe giraffe elephant

在适配器ID为V0JhnXmh的xtag上异步启动a.xe程序，并传递giraffe和elephant作为命令行参数。

编辑此页
本文最后由 Vergil Wong 更新于