Elements of the Platform Board Flow - 2021.1 English

Vivado Design Suite User Guide System-Level Design Entry (UG895)

Document ID
UG895
Release Date
2021-06-16
Version
2021.1 English

The list of files used in the Vivado Design Suite platform board flow include the following:

Board file
The Board file is the file described in this appendix, and must be named board.xml. It lists the components used on a system-level board, including the Xilinx device, defines the different operating modes supported by those components, lists the signal interfaces implemented by those components, lists the preferred IP to implement those interfaces in a design project, and maps the logical ports of the interface definition to the physical ports and component pins of the Xilinx device.

Xilinx standard board definitions can be found at the following location in the Vivado Design Suite software installation:

<install_dir>/Vivado/<version>/data/boards/board_files

Where <install_dir> is the directory the Vivado Design Suite was installed into, and <version> is the software version.

You can create user-defined Board files by using the Xilinx standard board definition files as a starting point for customization. User-defined or third-party Board files, and associated files, can be added to a board repository for use by the Vivado Design Suite by setting the following parameter when launching the Vivado tool:

set_param board.repoPaths [list "<path1>" “<path2>” “...”]

Where <path> is the path to a directory containing a single Board file and files referenced by the board.xml file, such as part0_pins.xml and preset.xml. The <path> can also specify a directory with multiple subdirectories, each containing a separate Board file. For example:

set_param board.repoPaths [list "C:/Data/usrBrds" "C:/Data/othrBrds"]
Tip: You should define the board.RepoPaths parameter in your Vivado_init.tcl file, or soon after opening the Vivado Design Suite. For more information about the Vivado_init.tcl file refer to this link in the Vivado Design Suite Tcl Command Reference Guide (UG835).
Pins file
Maps the component pin name on the Xilinx device, as found in the <port_map> of the Board file, to a physical pin location on the device package. This facilitates I/O assignment of signals coming into the Xilinx device to pins on the packaged part. This file is located in the board repository, in the same folder or directory as the Board file.
Preset file
Provides a list of predefined IP configuration options for the different IP used to implement bus interfaces in a design project. The preset file is used by the Vivado Design Suite when the IP is customized from the IP catalog and added into the design. This file is located in the board repository, in the same folder or directory as the Board file.
Interface file
Defines the logical ports and attributes of the signals that make up the interface file. A bus interface is a grouping of signals that share a common function. Interface definitions provide the capability to group functional signals to quickly define connections between IP in a Vivado Design Suite IP integrator block diagram. For more information refer to this link in the Vivado Design Suite User Guide: Designing IP Subsystems Using IP Integrator (UG994).

Xilinx standard interface definitions can be found at the following location in the Vivado Design Suite software installation:

<install_dir>/Vivado/<version>/data/ip/interfaces

You can also define custom interfaces using the Vivado IP packager, as described here in the Vivado Design Suite User Guide: Creating and Packaging Custom IP (UG1118).

IP file
The IP definition is stored in an XML file based on the IP-XACT standard, component.xml, which includes a list of logical ports and bus interfaces found on the IP core, that can be connected to the interfaces implemented by the system-level board.

Xilinx IP definitions can be found in the Vivado Design Suite software installation:

<install_dir>/Vivado/<version>/data/ip/interfaces