stapl config - 2023.2 简体中文

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

Document ID
UG1400
Release Date
2023-12-13
Version
2023.2 简体中文

配置 stapl 目标。

语法

stapl config <options>

创建 hw_target(jtag 链)并将 scan-chain 列表中提供的所有 hw_devices 都添加到 hw_target 中。它还可配置 stapl 输出文件,此文件用于记录 stapl 数据。

选项

选项 描述
-out <filepath> 输出文件路径。-out 选项与 -handle 选项不得同时使用。如果提供了 -out 选项,则将以 a+ 模式显式打开此文件。
-handle <filehandle> 输出的 open 命令所返回的文件句柄。-out 选项与 -handle 选项不得同时使用。
-scan-chain <list-of-dicts> scan-chain(扫描链)中的器件列表。每个列表元素都必须构成器件属性词典,格式如下:{name <string> idcode <int> irlen <int> idcode2 <int> mask <int>}。例如:[list [dict create name <device1_name> idcode <idcode> irlen <irlen> idcode2 <idcode2> mask <mask>] [dict create name <device2_name> idcode <idcode> irlen <irlen> idcode2 <idcode2> mask <mask>]]。使用 scan-chain 选项指定的器件顺序应与物理硬件上的器件顺序相匹配,此物理硬件用于回放 stapl 文件。-scan-chain 选项与 -part 选项不得同时使用。
-part <device-name list> 要添加到 scan-chain 的 AMD 器件的器件名称列表。该选项仅适用于 AMD 器件。该选项可替代 -scan-chain 选项。
-checksum 计算 stapl-data CRC 并将其追加到 stapl 文件。如不指定,则追加“CRC 0”。

注释

  • 对于 AMD 器件,如果在 scan-chain 信息中指定了 device_name 或 idcode,则其他参数均为可选。所有 JTAG TAP 都会自动添加到 AMD 器件的 scan-chain 中。

返回

无。

示例

stapl config -handle $fp -scan-chain [list [dict create name xcvc1902  idcode 0 irlen 0 idcode2 0 mask 0] [dict create name xcvm1802  idcode 0 irlen 0 idcode2 0 mask 0]]

将 xcvc1902 器件和 xcvm1802 器件添加到 scan-chain 中,使用 Tcl open 命令返回的文件句柄来记录 stapl 命令。

stapl config -out mystapl.stapl -scan-chain [list [dict create  name xcvc1902 idcode 0 irlen 0 idcode2 0 mask 0] [dict create  name xcvm1802 idcode 0 irlen 0 idcode2 0 mask 0]]

与前述示例相同,但改为使用 stapl 文件路径作为输入,

instead of the file handle returned by Tcl open command.
stapl config -out mystapl.stapl -part xcvc1902

使用 -part 选项将 xcvc1902 器件添加到 scan-chain 中。

stapl config -out mystapl.stapl -scan-chain [list [dict create  idcode 0x14CA8093 idcode2 1]]

与前述示例相同,但改为指定 idcode 和 idcode2 替代器件名称。

stapl config -out mystapl.stapl -part [list xcvc1902 xcvm1802]

使用 -part 选项将 xcvc1902 器件和 xcvm1802 器件添加到 scan-chain 中。

connect
stapl config -out mystapl.stapl -scan-chain [list [dict create  name xcvc1902 idcode 0 irlen 0 idcode2 0 mask 0]]
jtag targets -set -filter {name == "xcvc1902"}
stapl start
device program <pdipath>
stapl stop

以上示例演示了为 stapl 目标上的单个器件创建单个 stapl 文件的正确顺序。


connect
stapl config -out mystapl.stapl -scan-chain [list [dict create  name xcvc1902 idcode 0 irlen 0 idcode2 0 mask 0] [dict create  xcvm1802 idcode 0 irlen 0 idcode2 0 mask 0]]
jtag targets -set -filter {name == "xcvc1902"}
targets -set -filter {jtag_device_name == "xcvc1902"}
stapl start
device program <pdipath>
jtag targets -set -filter {name == "xcvm1802"}
targets -set -filter {jtag_device_name == "xcvm1802"}
stapl start
device program <pdipath>
stapl stop

以上示例演示了为 stapl 目标上的多个器件创建单个 stapl 文件的正确顺序。