Xilinx Software Command-Line Tool

Graphical development environments such as the Vitis™ IDE are useful for getting up to speed on development for a new processor architecture. It helps to abstract away and group most of the common functions into logical wizards that even the novice can use. However, scriptability of a tool is also essential for providing the flexibility to extend what is done with that tool. It is particularly useful when developing regression tests that will be run nightly or running a set of commands that are used often by the developer.

Xilinx® Software Command-line Tool (XSCT) is an interactive and scriptable command-line interface to the Vitis IDE. As with other Xilinx tools, the scripting language for XSCT is based on the tools command language (Tcl). You can run XSCT commands interactively or script the commands for automation. XSCT supports the following actions:
  • Creating domains, platform projects, system projects, and application projects
  • Managing repositories
  • Setting toolchain preferences
  • Configuring and building domains/BSPs and applications
  • Downloading and running applications on hardware targets
  • Creating and flashing boot images by running Bootgen and program_flash tools.

This reference content is intended to provide the information you need to develop scripts for software development and debug targeting Xilinx processors.

As you read the document you will notice usage of some abbreviations for various products produced by Xilinx. For example:
  • Use of ps7 in the source code implies that these files are targeting the Zynq®-7000 SoC family of products, and specifically the dual-core Cortex™ Arm® A9 processors in the SoC.
  • Use of psu in the source code implies that this code is targeting a Zynq® UltraScale+™ MPSoC device, which contains a Cortex Quad-core Arm A53, dual-core Arm R5, Arm Mali 400 GPU, and a MicroBlaze™ processor based platform management unit (PMU).
  • Hardware definition files (XSA) are used to transfer the information about the hardware system that includes a processor to the embedded software development tools such as Vitis IDE and Xilinx Software Command-Line Tools (XSCT). It includes information about which peripherals are instantiated, clocks, memory interfaces, and memory maps.
  • Microprocessor Software Specification (MSS) files are used to store information about the domain/BSP. They contain OS information for the domain/BSP, software drivers associated with each peripheral of the hardware design, STDIO settings, and compiler flags like optimization and debug information level.

System Requirements

If you plan to use capabilities that are offered through the Vitis IDE or the Xilinx Software Command-Line Tool (XSCT), then you also need to meet the hardware and software requirements that are specific to that capability.

Hardware Requirements

The table below lists the hardware requirements.

Table 1. Hardware Requirements
Requirement Description
CPU Speed 2.2 GHz minimum or higher; Hyper-threading (HHT) or multicore recommended.
Processor Intel Pentium 4, Intel Core Duo, or Xeon Processors; SSE2 minimum
Memory/RAM 2 GB or higher
Display Resolution 1024×768 or higher at normal size (96 dpi)
Disk Space Based on the components selected during the installation

Software Requirements

The table below lists the supported operating systems.

Note: 32-bit machine support is now only available through Lab Edition and Hardware Server standalone product installers.
Table 2. Software Requirements
Operating System Supported Version
Windows Windows 10 Professional and Enterprise versions 1809, 1903 and 1909: 64-bit
  • Red Hat Enterprise Linux Red Hat Enterprise Linux 7.4-7.7, and 8.1: 64-bit
  • CentOS Linux 7.4-7.7, and 8.1: 64-bit
  • SUSE Enterprise Linux 12.4: 64-bit
  • Amazon Linux 2 AL2 LTS: 64-bit
  • Ubuntu Linux 16.04.5, 16.04.6, 18.04.1, 18.04.2, 18.04.3 and 18.04.4 LTS: 64-bit
    Note: Additional library installation required.