配置 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 文件的正确顺序。