Using the Command Line - 2022.2 English

To create the chain using the Vivado Tcl mode or the Tcl Console in the Vivado IDE, perform sequential create_hw_device operations on an open SVF target. For instance, to add an xcku9p part followed by an xcvu095 part perform the following steps:

current_hw_target my_svf_target
open_hw_target
create_hw_device -part xcku9p 
create_hw_device -part xcvu095 
refresh_hw_target
get_hw_devices

In this example, the first two steps can be skipped if the SVF is already created and opened. The create_hw_device commands in the example define the devices of the JTAG chain starting with the first device on the chain and onward.

Note: The create_hw_device command only creates devices on an open SVF hardware target.

To add user defined devices to the chain, add the -idcode, -irlength, and -mask values along with the part type name using the -part options. For instance, if you have a part called "my_part" with a JTAG idcode of 1234567, an ir length of 8, mask of ffffffff, then you would create the device as shown below:

open_hw_target [current_hw_target]
create_hw_device -idcode 01234567 -irlength 8 -mask ffffffff -part my_part
# print IR length for user defined devices
puts [get_property IR_LENGTH [lindex [get_hw_devices -filter {PART == my_part}] 0]]
puts $idcode_hex
close_hw_target

Note: The idcode for the create_hw_device should be a valid device ID code. ID code values and IR lengths are typically provided by silicon vendors through device BSDL files.

To see a report of the target and its devices, run the report_hw_targets command. The report shows details for all active targets in the system. Use this report to obtain properties of the server, target, and device as shown below:

report_hw_targets
INFO: Server Property Information: localhost:3121
    CLASS: hw_server
    HOST: localhost
    NAME: localhost:3121
    PORT: 3121
    SID: TCP:localhost:3121
INFO: Target Property Information: localhost:3121/xilinx_tcf/Xilinx/my_svf_target
    CLASS: hw_target
    DEVICE_COUNT: 3
    HW_JTAG: 0
    IS_OPENED: 1
    MAX_DEVICE_COUNT: 32
    NAME: localhost:3121/xilinx_tcf/Xilinx/my_svf_target
    FREQUENCY: 10000000
    TYPE: xilinx_tcf
    TID: jsn-XNC-my_svf_target
    UID: Xilinx/my_svf_target
    SVF: 1
    Device: xcku9p_0
    Device: xcvu095_1
     Device: my_part_2

Using the Command Line - 2022.2 English - UG908

Vivado Design Suite User Guide: Programming and Debugging (UG908)