Multi-Cable and Multi-Device Support - 2025.2 English

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

Document ID
UG1400
Release Date
2025-11-20
Version
2025.2 English

This feature of the AMD Vitis™ environment allows you to run and debug application projects, program the bitstream/PDI, and program the flash using multiple JTAG cables or multiple devices on a single JTAG chain. The main use cases are as follows:

Multi-cable
This use case assumes you have more than one board connecting to the system and you want to work on all of the boards. The following is a multi-cable target connection view. Regarding target connection, refer to Target Connections.

Multi-device
This use case assumes you have multiple devices in a JTAG chain and you want to work on all of the devices. The following is a multi-device target connection view. Regarding target connection, refer to Target Connections.
Figure 1. Multi-device Target Connection View

Debugging an Application with Multi-cable or Multi-device

  • Navigate to the debug launch configuration file (refer to Launch Configurations for details).
  • Click Select beside the Device field.
    Figure 2. launch.json Tab

  • Deselect Auto Detect
    Figure 3. Select PL and PS Device Screen

  • Select the PS and PL device in this dialog according to your requirement.
  • Click Select and Start to start debugging.

Programming a Device Using a Multi-Device/Multi-Cable Setup

  1. Go to VitisProgram Device
  2. To select a device from the multiple cable or multiple device setup, click the Select button to the right of the Device field.
  3. Choose the appropriate device or cable from the drop down menu and click Program to program the FPGA/PDI file.
    Note: If the device status is Auto Detect, the Vitis tool automatically picks up the first device or cable from the list.
    Note: Use the same method to choose the PS and PL device when programming a flash.