Selecting Target Based on Target Properties - 2023.2 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
Release Date
2023.2 English

The following is an example XSCT session that demonstrates selecting a target based on target properties. It shows how to connect to the Cortex® -A9 processor of the second device when multiple devices are connected in a JTAG chain (xc7z020 and xc7z045).

# connect to hw_server
xsdb% conn -ho xhdbfarmrkh1
# check the jtag targets connected, the IDs listed with jtag targets are called node IDs
xsdb% jtag targets 
 1 Platform Cable USB II 0000153f74cd01
 2 arm_dap (idcode 4ba00477 irlen 4)
 3 xc7z020 (idcode 03727093 irlen 6 fpga)
 4 arm_dap (idcode 4ba00477 irlen 4)
 5 xc7z045 (idcode 03731093 irlen 6 fpga)
# check the targets connected, the IDs listed with targets are called target IDs
xsdb% targets 
 1 APU
 2 ARM Cortex-A9 MPCore #0 (Suspended)
 3 ARM Cortex-A9 MPCore #1 (Suspended)
 4 xc7z020
 5 APU
 6 ARM Cortex-A9 MPCore #0 (Running)
 7 ARM Cortex-A9 MPCore #1 (Running)
 8 xc7z045
# check jtag target properties of 2nd device (2nd ARM DAP). Note the target_ctx here.
xsdb% jtag targets -target-properties -filter {node_id == 4}
{target_ctx jsn-DLC10-0000153f74cd01-4ba00477-1 level 1 node_id 4 is_open 1 is_active 1 is_current 1 name arm_dap jtag_cable_name {Platform Cable USB II 0000153f74cd01} state {} jtag_cable_manufacturer Xilinx jtag_cable_product DLC10 jtag_cable_serial 0000153f74cd01 idcode 4ba00477 irlen 4}
# using the target context, select the targets associated with the JTAG target (2nd ARM DAP - node id = 4) 
xsdb% targets -filter {jtag_device_ctx == "jsn-DLC10-0000153f74cd01-4ba00477-1"}
 5 APU
 6 ARM Cortex-A9 MPCore #0 (Running)
 7 ARM Cortex-A9 MPCore #1 (Running)