Introduction

The XilFPGA library provides an interface for the users to configure the programmable logic (PL) from PS. The library is designed to run on top of Xilinx® standalone BSPs. It acts as a bridge
between the user application and the PL device. It provides the required functionality to the user application for configuring the PL device with the required bitstream.

Library Sources

The source code for the driver is included with the Vitis Unified Software Platform installation, as well as being available in the Xilinx Github repository. 

The driver source code is organized into different folders.  The table below shows the axidma driver source organization. 

Note: The .yaml(in data folder) and CMakeLists.txt(in src folder) files would be used in the System Device-tree based flow.

Library Implementation

For a full list of features supported by this  library, please refer to the xilfpga Doc

Features

The following features are supported in Zynq UltraScale+ MPSoC platform:

• Full bitstream loading

•  Partial bitstream loading

• Encrypted bitstream loading

• Authenticated bitstream loading

• Authenticated and encrypted bitstream loading

• Readback of configuration registers

• Readback of configuration data

The following features are supported in Versal platform:

• Full/Partial bitstream loading

• Device Key Encrypted bitstream loading

• Authenticated bitstream loading

• Authenticated and Device-key encrypted bitstream loading

Known Issues and Limitations

• https://www.xilinx.com/support/answers/68246.html

• https://www.xilinx.com/support/answers/69125.html

Example Applications

Refer to the driver examples directory for various example applications that exercise the different features of the driver.

Each application is linked in the table below. The following sections describe the usage and expected output of the various applications.

These example applications can be imported into the Vitis IDE from the Board Support Package settings tab. 

Links to Examples

Examples Path: https://github.com/Xilinx/embeddedsw/tree/master/lib/sw_services/xilfpga/examples

Example Application Usage

Full Bitstream/PDI loading

Transfer the user provided Full Reconfiguration Bitstream into the PL.

Expected Output

Partial Bitstream/PDI loading

Transfer the user provided Partial Reconfiguration Bitstream into the PL Region.

Expected Output

Readback of configuration registers

This example prints out the values of all the configuration registers related to FPGA

Expected Output

Readback of configuration Data

This example prints out the fpga configuration data.

Expected Output

Performance

• N/A

ChangeLog

• 2025.1

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2025.1/doc/ChangeLog#L457

• 2024.2

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2024.2/doc/ChangeLog#L675

• 2024.1

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2024.1/doc/ChangeLog#L976

• 2023.2

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2023.2/doc/ChangeLog#L338

• 2023.1

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2023.1/doc/ChangeLog#L168

• 2022.1

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2022.2/doc/ChangeLog#L1109

• 2022.1

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2022.1/doc/ChangeLog#L136

• 2021.2

  • https://github.com/Xilinx/embeddedsw/blob/xlnx_rel_v2021.2/doc/ChangeLog#L75

• 2021.1

  • https://github.com/Xilinx/embeddedsw/blob/xilinx_v2021.1/doc/ChangeLog#L332 

• 2020.2

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2020.2/doc/ChangeLog#L724

• 2020.1

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2020.1/doc/ChangeLog#L170

• 2019.2

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2019.2/doc/ChangeLog#L434

• 2019.1

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2019.1/doc/ChangeLog#L193

• 2018.3

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2018.3/doc/ChangeLog#L315

• 2018.2

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2018.2/doc/ChangeLog#L104

• 2018.1

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2018.1/doc/ChangeLog#L341

• 2017.4

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2017.4/doc/ChangeLog#L383

• 2017.3

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2017.3/doc/ChangeLog#L325

• 2017.2

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2017.2/doc/ChangeLog#L34

• 2017.1

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2017.1/doc/ChangeLog#L435

• 2016.4

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2016.4/doc/ChangeLog#L13

• 2016.3

  • https://github.com/Xilinx/embeddedsw/blob/xilinx-v2016.3/doc/ChangeLog#L437

Related Links

• http://www.wiki.xilinx.com/Baremetal+Drivers+and+Libraries