Multi-Cable and Multi-Device Support - 2025.1 English

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

Document ID
UG1400
Release Date
2025-05-29
Version
2025.1 English
Note: This feature is currently unsupported. You can view multi-cable or multi-device setups in the target connection view. However, you can use the command line to establish connections with multiple cables or devices and debug using XSDB commands.

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
In this use case, assume you have more than one board connected 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, please refer to Target Connections

Multi-device
In this use case, assume 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, please 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 & 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 to open the device selection dialog box.
  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.