Importing a CSV File - 2023.2 English

Vivado Design Suite User Guide: I/O and Clock Planning (UG899)

Document ID
Release Date
2023.2 English

You can import a CSV file to populate the I/O Ports window within the I/O Planning layout view. You can then assign these I/O ports to physical package pins to define the device pin configuration.

To import an I/O ports list from a CSV file:

  1. Select File > Import > Import I/O Ports.
  2. In the Import I/O Ports dialog box, select CSV File, and browse to select the file to import.
Figure 1. Import I/O Ports Dialog Box

The following figure shows the CSV file format. CSV is a standard file format used by FPGA and board designers to exchange information about device pins and pinout. The Vivado IDE requires a specific CSV file format for importing I/O pin-related data, as described in Using I/O Port Lists in CSV File Format.

Figure 2. I/O Port List in CSV File Format

You can define differential pairs in the CSV file in several ways. For example, the Vivado IDE recognizes differential pairs directly defined with DiffPair Signal and DiffPair Type properties. In addition, the Vivado IDE can infer diff pairs when only one port of the pair is defined in the CSV file or two named nets imply a differential pair. For more information, see Differential Pairs in the CSV File. When inferring differential pairs, the Vivado IDE displays a prompt to confirm the assignment of the pairs, as shown in the following figure.

Figure 3. Infer Differential Pairs Dialog Box

CSV files can also contain additional information not recognized by the Vivado IDE. If unrecognized information is found in the imported CSV file, the information is displayed in user columns of the Package Pins window for your review and use. To modify or define values in the user CSV fields, right-click in the Package Pins window, and select Set User Column Values.

Note: For information on exporting a CSV file, see Exporting I/O Pin and Package Data.